Add the multi language support, and add the german version in the docs
Description
This pull request adds VitePress multi-language support and includes a complete German (de) translation of the documentation under de.
Changes
- [ ] Improved
- [ ] Bug Fixes
- [x] Feature
- [x] Documentation
- [ ] Other
Context
This change enables multi-language documentation for the site and provides a full German translation, allowing German-speaking users to read the docs in their native language. It adds locale-aware configuration in config.ts (helpers for nav and sidebar) and places all translated content under docs/de. No functional changes to the application or runtime are included — only documentation and site config updates.
How Has This Been Tested?
- [x] Manually inspected translated pages to ensure frontmatter, code blocks and links were preserved.
- [x] Built and previewed the site locally
- [x] Tested on Arch Linux/Based Distro.
- [ ] Tested on Fedora Linux/Based Distro.
- [ ] Tested on openSuse.
Checklist
Please ensure your pull request meets the following requirements:
- [x] My code follows the style guidelines of this project. (Docs/config follow existing conventions.)
- [x] I have performed a self-review of my changes.
- [x] I have commented on my code, particularly in hard-to-understand areas (locale helpers in
config.tsare commented). - [x] My changes do not introduce new warnings.
- [-] I have added tests that prove my fix is effective or that my feature works. (N/A for docs-only change.)
- [x] I have made corresponding changes to the documentation.
- [-] New and existing unit tests pass locally with my changes. (N/A / no code changes)
Screenshots
Related Issues
N/A
Additional Notes
- This PR contains only documentation and site configuration changes (i18n support + translations). and fix 2 small changes in the english version (sh -> ini and spappy --> swappy)
Hi @mylinuxforwork I wanted to add the french version too, but i was afraid to create a PR with 80 new files ^^.
So tell me, if you want to merge the PR, do you want me to add a commit for the french version or i wait to create a new PR when this one will be merged ? :)
@Esscraye Thank you so much for your work. But I would currently pause your request. It would be hard for me to maintain two language versions in the docs. But maybe you can support me in the general english version?
@Esscraye thanks for your work, LGTM. can you provide me the site URL deployed with the GitHub actions workflow? I want to check if everything works.
edit: also can you like update the docs in de in upcoming times, like if the normal eng version changes, can you also update the de version yourself. i can agree with ml4w that maintaining two languages is a bit difficult when there are too many things in the docs, so if you can help ml4w while maintaining the docs in de, it will be good to have them in de lang.
if you can lend your helping hand in future updates of the docs, we can look further to have de lang in the docs. if you won't have time to do this, then it will be hard for ml4w to maintain both languages. i hope you understand. once again, thanks for your time and work.
hey, I don't think i've the time to maintain the german version, i'm sorry about that ^^
@harilvfs it should be that : https://esscraye.github.io/ml4w-dotfiles/ but it seems the github-page is not really working well ?