Japanese translation project

[Hayao0819]

Hi, Thank you for the great project.

We (a few university students) are planning to translate this wonderful project into Japanese and make it known to a wider audience.

We are currently working on the translation, may we send this translation as a pull request here? Or should we do our own hosting?

We would like to follow the original owners wishes. We would appreciate your input. Thank you very much.

https://github.com/GunmaRamens/nixos-and-flakes-book-ja

[ryan4yin]

Great to see someone keen on translating this book into Japanese!

I think setting up a dedicated Japanese site on your fork and then submitting a PR to add a link to your site in the README and language section of this main repository would be a good approach.

Since I don't understand Japanese, I won't be able to help review Japanese PRs. In fact, it may even slow down the progress of your Japanese content updates. Also, the book is currently in maintenance mode. I won't be putting a lot of effort into it until the official solution for the flakes experimental feature is clear.

I believe that by using a complete URI such as https://<domain>/ja for the locales.ja.link in both the main repository and your fork, we can ensure that selecting Japanese will redirect users to your dedicated Japanese website, while choosing English/Chinese will guide them back to https://nixos-and-flakes.thiscute.world.

[Hayao0819]

We are very happy that you are pleased with our translation.

Now let us host our own independent site and link to each other in our respective languages.

We have one question about working as an independent project. Should we do the translations under the docs/en/ directory and keep the original files? Or can I edit directly under docs? Currently we are adopting the former, in this case our domain will also host the English and Chinese versions, but the merging process will be easier.

[ryan4yin]

We have one question about working as an independent project. Should we do the translations under the docs/en/ directory and keep the original files? Or can I edit directly under docs?

I don’t have a personal preference on this matter. I think you can either keep the original files as they are now or delete them.

Currently we are adopting the former, in this case our domain will also host the English and Chinese versions, but the merging process will be easier.

I have just refactored config.ts and folder structure. Now you can add some configuration in docs/.vitepress/config/index.ts to make vitepress ignore all en/zh content during the build process, an example is here:

https://github.com/ryan4yin/nixos-and-flakes-book/blob/9021679b5389efffaf5a6f80c1f6c97508592816/docs/.vitepress/config/index.ts#L25-L48

[Hayao0819]

Thank you for making the changes for the translation project.

We are merging these changes as we work through the translation process.

The Japanese translation project will be hosted at the following URL.

https://nixos-and-flakes-ja.hayao0819.com/

When the majority of the translations are complete, may I create a pull request to add a link to Japanese in this repository?

[ryan4yin]

When the majority of the translations are complete, may I create a pull request to add a link to Japanese in this repository?

Absolutely! waiting for your PR.