You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@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?
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.
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.
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.
Activity
[-]Build RTD preview in a second language?[/-][+]Build RTD PR preview in a second language?[/+]humitos commentedon Sep 8, 2025
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
StanFromIreland commentedon Jun 4, 2026
@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 commentedon Jun 10, 2026
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 commentedon Jun 10, 2026
Hi @humitos!
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 commentedon Jun 10, 2026
I don't follow what you are trying to achieve here. I will need more details to be able to help you.
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 commentedon Jun 10, 2026
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.