Skip to content

Conversation

Esscraye
Copy link

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
  • Feature
  • 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?

  • Manually inspected translated pages to ensure frontmatter, code blocks and links were preserved.
  • Built and previewed the site locally
  • 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:

  • My code follows the style guidelines of this project. (Docs/config follow existing conventions.)
  • I have performed a self-review of my changes.
  • I have commented on my code, particularly in hard-to-understand areas (locale helpers in config.ts are commented).
  • 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.)
  • I have made corresponding changes to the documentation.
  • [-] New and existing unit tests pass locally with my changes. (N/A / no code changes)

Screenshots

image image

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)

@Esscraye
Copy link
Author

Esscraye commented Oct 3, 2025

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 ? :)

@mylinuxforwork
Copy link
Owner

@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?

@harilvfs
Copy link
Contributor

harilvfs commented Oct 11, 2025

@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.

@Esscraye
Copy link
Author

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 ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants