Skip to content

docs: FR/ZH/DE/PT-BR 翻訳を追加し6言語対応にする (#765) - #766

Merged
hideyukiMORI merged 9 commits into
mainfrom
docs/translations-all-languages
May 29, 2026
Merged

docs: FR/ZH/DE/PT-BR 翻訳を追加し6言語対応にする (#765)#766
hideyukiMORI merged 9 commits into
mainfrom
docs/translations-all-languages

Conversation

@hideyukiMORI

Copy link
Copy Markdown
Owner

概要

4エージェント並列実行で、EN/JA に加えて FR・ZH・DE・PT-BR の4言語を追加。docs サイトが6言語対応になる。

翻訳内容

各言語 37ファイル(tutorials 2・explanation 4・how-to 27+mcp 1・reference 3):

言語 ディレクトリ 特記事項
🇫🇷 Français docs/fr/ vous 形、自然なフランス語技術文書スタイル
🇨🇳 简体中文 docs/zh/ 大陸中国語(簡体字)、中国語開発者向け慣用表現
🇩🇪 Deutsch docs/de/ Sie 形、複合名詞正確(Fehlerbehandlung 等)
🇧🇷 Português (Brasil) docs/pt-br/ você 形、ブラジル開発者慣用語(deployar 等)

翻訳方針: コードブロックはそのまま保持。散文・見出し・コードコメント・テーブルを翻訳。技術用語(UseCase/FastAPI/Pydantic/SQLAlchemy/middleware 等)は英語のまま、文脈に自然な形で統合。

config.mts 変更

  • 4言語の nav{Fr,Zh,De,PtBr}() / sidebar{Fr,Zh,De,PtBr}() 関数を追加(EN/JA と同等の4グループ構造)
  • ignoreDeadLinks に翻訳ロケールから EN 専用ディレクトリ(adr/field-trials/templates/todo/)への相対リンクを除外パターンとして追加(翻訳不要リソースへの参照を適切に処理)

検証

  • python3 scripts/check_docs_nav.pyOK(全 Diátaxis ページがナビにある)
  • npm run docs:build(dead-link 検出 ON)→ exit 0

Closes #765

🤖 Generated with Claude Code

hideyukiMORI and others added 9 commits May 30, 2026 01:57
37 fichiers traduits en français idiomatique pour un public de développeurs :
- 2 tutoriels (getting-started, first-domain)
- 4 fichiers explanation (architecture, design-philosophy, field-trial-methodology, one-usecase-two-surfaces)
- 25 guides how-to (add-new-domain, api-versioning, async-use-case, background-tasks, concurrency-patterns, configure-auth, cors, custom-auth-middleware, decimal-unicode-input, dependency-injection, domain-events, email-address-parsing, file-upload, lifespan-and-app-state, middleware-stack, new-project, problem-details, release-and-publish, response-patterns, run-integration-tests, run-tests, soft-delete, sqlalchemy-repository, streaming, structured-logging, validation, webhook)
- 1 guide howto/mcp-setup
- 3 références (api, configuration, framework-modules)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
tutorials, explanation, how-to, howto, reference の全ドキュメントを
Simplified Chinese(简体中文)に翻訳。

- docs/zh/tutorials/ (2 files)
- docs/zh/explanation/ (4 files)
- docs/zh/how-to/ (24 files)
- docs/zh/howto/ (1 file)
- docs/zh/reference/ (3 files)
- docs/zh/tutorials/getting-started.md (updated from partial)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Traduz todos os 37 arquivos de documentação (2 tutoriais, 4 explicações,
30 how-tos e howto, 3 referências) para o português do Brasil. A tradução
existente em tutorials/getting-started.md foi substituída por uma versão
completa baseada na fonte EN.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Alle 37 englischen Quelldateien wurden ins Deutsche übersetzt und unter
docs/de/ abgelegt. Die bestehende getting-started.md wurde durch eine
vollständige, quelltreue Übersetzung ersetzt.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
4エージェントを並列実行して EN/JA に加えて4言語を追加。

各言語 37ファイル(tutorials 2・explanation 4・how-to 27+mcp 1・reference 3):
- docs/fr/ — Français(vous 形、自然なフランス語)
- docs/zh/ — 简体中文(大陸中国語)
- docs/de/ — Deutsch(Sie 形、複合名詞対応)
- docs/pt-br/ — Português (Brasil)(você 形)

.vitepress/config.mts:
- FR/ZH/DE/PT-BR の nav/sidebar 関数を追加(EN/JA と同等の4グループ構造)
- ignoreDeadLinks に翻訳ロケールから EN 専用ディレクトリへの相対リンクを追加

docs build(dead-link 検出 ON)・sidebar coverage check ともに pass。

Closes #765

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@hideyukiMORI
hideyukiMORI merged commit c461d6e into main May 29, 2026
6 checks passed
@hideyukiMORI
hideyukiMORI deleted the docs/translations-all-languages branch May 29, 2026 17:07
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.

ドキュメントを6言語化(FR/ZH/DE/PT-BR 翻訳追加)

1 participant