Skip to content

doc: add i18n translations for Japanese - #5082

Merged
OliverBryant merged 8 commits into
xorbitsai:mainfrom
kejhz653-stack:feat/docs-i18n-translations
Jul 3, 2026
Merged

OliverBryant merged 8 commits into
xorbitsai:mainfrom
kejhz653-stack:feat/docs-i18n-translations

Conversation

@kejhz653-stack

@kejhz653-stack kejhz653-stack commented Jun 25, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Add machine-translated PO files for Japanese (ja) documentation locale.
  • Translations are based on the zh_CN template using DeepSeek API.
  • Add init_locales.py scaffold script for generating locale PO file structure.
  • Update doc/Makefile with html_ja build target.
  • Update switcher.json with the Japanese language entry and RTD URL.

Preview

Language URL
Japanese https://inference-i18n-preview.readthedocs.io/ja/latest/

Test plan

  • Verify RTD build succeeds for Japanese locale after merge.
  • Configure RTD translation sub-project on the main inference project for Japanese locale.

@XprobeBot XprobeBot added this to the v2.x milestone Jun 25, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds multi-language localization support to the project, introducing translated README files and documentation scaffolding for German, Spanish, French, Italian, Korean, Portuguese, and Traditional Chinese, alongside updates to the documentation build system. The reviewer feedback identifies that several reference-style links in the new README files are missing their definitions and should be converted to inline links. Additionally, the zh_TW locale should be included in the translate-po target within doc/Makefile to ensure its translations are correctly updated.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread READMES/README_de.md
Comment thread READMES/README_de.md
Comment thread doc/Makefile Outdated
@kejhz653-stack

Copy link
Copy Markdown
Contributor Author

/gemini review

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request significantly expands the project's localization by adding translated README files and documentation translation templates (.po files) for several languages, including German, Spanish, French, Italian, Korean, Portuguese, and Traditional Chinese. It also updates the documentation build system and language switcher, and introduces a script to scaffold new locales. The review comments are accurate and should be addressed: one identifies a reStructuredText formatting issue in the German translation where literal block markers (::) were incorrectly modified, and the other suggests using catalog.obsolete.clear() for a cleaner implementation in the locale initialization script.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread doc/source/init_locales.py Outdated
Comment thread doc/source/locale/de/LC_MESSAGES/development/contributing_codebase.po Outdated
@kejhz653-stack

Copy link
Copy Markdown
Contributor Author

/gemini review

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces multi-language documentation support for several new locales (German, Spanish, French, Italian, Korean, Portuguese, and Traditional Chinese). It adds translated README files, updates the documentation Makefile and static switcher to support these locales, and adds a Python script (init_locales.py) to scaffold .po files from the zh_CN template. A bug was identified in doc/source/init_locales.py where overwriting message.string with a single empty string for plural messages causes invalid PO syntax. A code suggestion was provided to preserve the list/tuple structure for plural messages.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread doc/source/init_locales.py Outdated
@qinxuye qinxuye changed the title docs: add i18n translations for de/es/fr/it/ja/ko/pt_BR/zh_TW doc: add i18n translations for de/es/fr/it/ja/ko/pt_BR/zh_TW Jun 29, 2026
@XprobeBot XprobeBot added the documentation Improvements or additions to documentation label Jun 29, 2026
@kejhz653-stack
kejhz653-stack force-pushed the feat/docs-i18n-translations branch 2 times, most recently from e2b2cd4 to b42fd23 Compare June 30, 2026 07:20
@kejhz653-stack
kejhz653-stack deleted the feat/docs-i18n-translations branch July 1, 2026 06:39
@kejhz653-stack
kejhz653-stack restored the feat/docs-i18n-translations branch July 1, 2026 06:42
@kejhz653-stack
kejhz653-stack deleted the feat/docs-i18n-translations branch July 1, 2026 06:43
@kejhz653-stack kejhz653-stack changed the title doc: add i18n translations for de/es/fr/it/ja/ko/pt_BR/zh_TW doc: add i18n translations for Japanese Jul 1, 2026
@kejhz653-stack
kejhz653-stack restored the feat/docs-i18n-translations branch July 1, 2026 06:47
@kejhz653-stack kejhz653-stack reopened this Jul 1, 2026
@kejhz653-stack

Copy link
Copy Markdown
Contributor Author

/gemini review

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

Gemini encountered an error creating the review. You can try again by commenting /gemini review.

@kejhz653-stack

Copy link
Copy Markdown
Contributor Author

Please review this pr @qinxuye .Thanks!

jiangjiawei and others added 7 commits July 3, 2026 11:06
Use bundled switcher.json per locale build, localize external links, and tighten header CSS so translated nav labels stay on one row.
Bring in unified switcher.json, locale-aware navbar labels, and Read the Docs mo compilation helpers from feat/docs-i18n-de.

Co-authored-by: Cursor <cursoragent@cursor.com>
Initialize switcher options defensively in config-inited, move mo compilation and zh_cn tagging into setup(app), and remove header-level fuzzy markers from ja/zh_CN catalogs after quality checks passed.

Co-authored-by: Cursor <cursoragent@cursor.com>
@kejhz653-stack
kejhz653-stack force-pushed the feat/docs-i18n-translations branch from cdfe3ca to bb6c64d Compare July 3, 2026 03:13
Restore all Simplified Chinese .po files to upstream main so this PR only carries non-zh_CN i18n work.

@OliverBryant OliverBryant left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@OliverBryant
OliverBryant merged commit e50e95b into xorbitsai:main Jul 3, 2026
10 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants