About what HW42 mentioned in the announcement issue:
There’s ongoing work to integrate localization into the official docs. This was also one of the motivations for the big migration to Read the Docs.
In fact, if the official team intends to adopt the translations maintained by the qubesos-docs-l10n project, as I demonstrated in “How to Reuse Translations?” section, it just need to make sure that the git clone command is executed in .readthedocs.yml to download the contents of the po/$version branch before building the documentation:
build:
jobs:
post_checkout:
- git clone --depth=1 --branch=po/main https://github.com/localizethedocs/qubesos-docs-l10n.git _translated
Then, by setting the Language field in the Read the Docs project Settings page to a language currently maintained (e.g., Traditional Chinese), the translated documentation can be successfully deployed. Below are the qubes-doc-zh-tw project I created on RTD and the forked repository I used for demonstration on GitHub:
- Preview: https://qubes-doc-zh-tw.readthedocs.io/
- Source: https://github.com/hwhsu1231-demo/qubes-doc
The preview documentation is shown below:
