Skip to content

docs: add i18n translations for de/es/fr/it/ja/ko/pt_BR/zh_TW#5082

Open
kejhz653-stack wants to merge 7 commits into
xorbitsai:mainfrom
kejhz653-stack:feat/docs-i18n-translations
Open

docs: add i18n translations for de/es/fr/it/ja/ko/pt_BR/zh_TW#5082
kejhz653-stack wants to merge 7 commits into
xorbitsai:mainfrom
kejhz653-stack:feat/docs-i18n-translations

Conversation

@kejhz653-stack

Copy link
Copy Markdown
Collaborator

Summary

  • Add machine-translated PO files for 8 new documentation locales: de, es, fr, it, ja, ko, pt_BR, zh_TW
  • 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 per-language HTML build targets and html_i18n to build all at once
  • Update switcher.json with all 9 language entries and RTD URLs

Preview

Language URL
Japanese https://inference-i18n-ja.readthedocs.io/
Korean https://inference-i18n-ko.readthedocs.io/
German https://inference-i18n-de.readthedocs.io/
French https://inference-i18n-fr.readthedocs.io/
Spanish https://inference-i18n-es.readthedocs.io/
Italian https://inference-i18n-it.readthedocs.io/
Portuguese (Brazil) https://inference-i18n-pt-br.readthedocs.io/
Traditional Chinese https://inference-i18n-zh-tw.readthedocs.io/

Test plan

  • Verify RTD builds succeed for each language after merge
  • Configure RTD translation sub-projects on the main inference project for each new 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 Outdated
Comment on lines +56 to +57
- Eingebaute [DeepSeek V4]: [#4938](https://github.com/xorbitsai/inference/pull/4938)
- Eingebaute [MiniMax-M2.7]: [#4843](https://github.com/xorbitsai/inference/pull/4843)

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.

medium

The reference-style links [DeepSeek V4] and [MiniMax-M2.7] are missing their link definitions at the bottom of the file, causing them to render as plain text instead of clickable links. Please convert them to inline links as suggested. Note that this issue also systematically affects all other newly added translated README files (README_es.md, README_fr.md, README_it.md, README_ko.md, README_pt_BR.md, README_zh_TW.md).

Suggested change
- Eingebaute [DeepSeek V4]: [#4938](https://github.com/xorbitsai/inference/pull/4938)
- Eingebaute [MiniMax-M2.7]: [#4843](https://github.com/xorbitsai/inference/pull/4843)
- Eingebaute [DeepSeek V4](https://api-docs.deepseek.com/news/news260424): [#4938](https://github.com/xorbitsai/inference/pull/4938)
- Eingebaute [MiniMax-M2.7](https://www.minimax.io/models/text/m27): [#4843](https://github.com/xorbitsai/inference/pull/4843)

Comment thread READMES/README_de.md Outdated

🌐 **Verteiltes Deployment**: Einfache Verteilung von Inferenz über mehrere Geräte und Maschinen.

🔌 **Third-Party-Integrationen**: Nahtlose Integration mit [LangChain](https://python.langchain.com/docs/integrations/providers/xinference), [LlamaIndex], [Dify], [Chatbox] u. a.

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.

medium

The reference-style links [LlamaIndex], [Dify], and [Chatbox] are missing their link definitions at the bottom of the file. Please convert them to inline links as suggested. This issue also systematically affects all other newly added translated README files.

Suggested change
🔌 **Third-Party-Integrationen**: Nahtlose Integration mit [LangChain](https://python.langchain.com/docs/integrations/providers/xinference), [LlamaIndex], [Dify], [Chatbox] u. a.
🔌 **Third-Party-Integrationen**: Nahtlose Integration mit [LangChain](https://python.langchain.com/docs/integrations/providers/xinference), [LlamaIndex](https://gpt-index.readthedocs.io/en/stable/examples/llm/XinferenceLocalDeployment.html#i-run-pip-install-xinference-all-in-a-terminal-window), [Dify](https://docs.dify.ai/advanced/model-configuration/xinference), [Chatbox](https://chatboxai.app/) u. a.

Comment thread doc/Makefile Outdated
python $(SOURCEDIR)/sync_readme_to_po.py

translate-po:
python $(SOURCEDIR)/translate_po.py --locales ja ko de fr es it pt_BR

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.

medium

The zh_TW locale is missing from the --locales list in the translate-po target. Since Traditional Chinese is one of the newly added locales, please include zh_TW in this list to ensure it gets translated/updated when running make translate-po.

	python $(SOURCEDIR)/translate_po.py --locales ja ko de fr es it pt_BR zh_TW

Convert missing reference-style links in translated READMEs to inline links so they render correctly, and include zh_TW in the translate-po locales to keep Traditional Chinese translations updated.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants