Build RTD PR preview in a second language?

[StanFromIreland]

It would be useful for testing any translation related features.

[humitos]

You should create another project on RTD and add it as a translation of the English one. We already have the Spanish version building at

• docs: https://cpython-previews.readthedocs.io/es/latest/
• project: https://app.readthedocs.org/projects/cpython-previews-es/

[StanFromIreland]

@humitos will that also work on PR previews (that's the most important place for us)? We'd like to have both English and a translation for each PR since we have had some issues before. I couldn't find any project that has two configurations like this?

[humitos]

Do you want to trigger a build on the English version and the translation when there is a change in the English version but not in the translation?

Read the Docs treat each translation as a separate project, so that won't happen automatically unless the original and translation text live in the same repository. If they live in different repositories, you will need to use the APIv3 to trigger a build in the translation when a change in the English version is done.

https://docs.readthedocs.com/platform/stable/api/v3.html#build-triggering

[StanFromIreland]

Hi @humitos!

Do you want to trigger a build on the English version and the translation when there is a change in the English version but not in the translation?

I'm only talking about this repository, which just hosts the theme for the documentation, not the docs themselves. The theme also supports translations, but we have had issues before when the theme broke support for those translations. So we'd like it to trigger for every PR.

[humitos]

I don't follow what you are trying to achieve here. I will need more details to be able to help you.

The theme also supports translations, but we have had issues before when the theme broke support for those translations

How do you check that those translations work? You can ran the same commands on Read the Docs and fail the build if they fail.

[StanFromIreland]

The problem is that the build itself succeeds, but translations are not picked up/rendered. We'd have to check manually, which isn't ideal but so far we've been doing it locally (which is quite hard for reviews), so it'd still be a great improvement.