-
Notifications
You must be signed in to change notification settings - Fork 52
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Translated pages don't reload correctly while using doc-live-lang
#323
Comments
doc-live-lang
doc-live-lang
Thanks for opening the issue, I will investigate! |
I was able to reproduce the issue on my machine (Pop OS Linux) at first, but the same issue happened with calling doc-lives without the wrapping sessions. After I refreshed the browser while the local server was up, it started working. My intuition is that it is not related to nox but with Sphinx autobuild. It seems to detect that a file has changed but then decides that there is no need to rebuild the .mo files (the compiled version of the .po files) for the Spanish translation. I will keep looking. |
During my work on translating the packaging guide, I followed the instructions in
TRANSLATING.md
to build a live version of the website using the following command:When I would save changes in my editor, the session running the live website would appear to catch the changes (the terminal would update), but the actual content appeared to not change! Poking around the
noxfile.py
(credit to @RobPasMue for this idea), we found that thatdocs-live-lang
is just a wrapper around thedocs-live
command, which has the form:When using this command to run a live webpage, I found that content changed correctly when source files were changed.
To Reproduce
docs-live-lang
command..po
files (I was usingdocumentation.po
) and check to see if the content updates correctly.If other people are able to reproduce this issue, it might be worth switching the instructions to have contributors use the
docs-live
command.System info:
OS: Debian 12
Python 3.10.14
nox 2024.4.15
Text editor: VIM 9.0
The text was updated successfully, but these errors were encountered: