Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/en/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ The English-language version of this document should show the "Translations are

/// admonition | Translations are available

If you're not comfortable with English, translations of the Docs Tools are available in [Français](https://beeware-docs-tools.readthedocs.io/fr/latest/) and [Deutsch](https://beeware-docs-tools.readthedocs.io/de/latest/).
If you're not comfortable with English, translations of the Docs Tools are available in [Français](https://beeware-docs-tools.readthedocs.io/latest/fr/) and [Deutsch](https://beeware-docs-tools.readthedocs.io/latest/de/).

///

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<!-- Override default stay-on-page handling -->
Original file line number Diff line number Diff line change
Expand Up @@ -138,4 +138,4 @@ We use [Weblate](https://hosted.weblate.org/projects/beeware/) for our content t

Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours.

If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg-fr/](https://app.readthedocs.org/projects/beewareorg-fr/){% else %}[https://app.readthedocs.org/projects/{{ project_name }}-fr/](https://app.readthedocs.org/projects/{{ project_name }}-fr/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem.
If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/](https://app.readthedocs.org/projects/beewareorg/){% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem.
6 changes: 3 additions & 3 deletions tox.ini
Original file line number Diff line number Diff line change
Expand Up @@ -47,10 +47,10 @@ commands:
translate : update_machine_translations --soft-fail -d {[docs]shared_content_dir} ar cs da de es fa fr it ko pl pt tr zh_CN zh_TW
lint : pyspelling
lint : markdown-checker --dir {[docs]docs_dir} --func check_broken_urls
lint : markdown-checker --dir {[docs]shared_content_dir} --func check_broken_urls "--skip-urls-containing=https://app.readthedocs.org/projects/{{ project_name }}-fr/,https://example.com/"
lint : markdown-checker --dir {[docs]shared_content_dir} --func check_broken_urls "--skip-urls-containing=https://app.readthedocs.org/projects/{{ project_name }}/,https://example.com/"
en : build_md_translations {posargs} --source-code=src en
de : build_md_translations {posargs} --source-code=src de
fr : build_md_translations {posargs} --source-code=src fr
all : build_md_translations {posargs} --source-code=src en de fr
serve : python -m http.server -d _build/html 8043
live : live_serve_en {posargs} src --port=8043 --source-code=src
serve : python -m http.server -d _build/html 8037
live : live_serve_en {posargs} src --port=8037 --source-code=src