add chinese translations for docs#2111
Conversation
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Adds a Simplified Chinese documentation set for the Athens Hugo docs, expanding translated coverage across core guides (walkthrough/try-out), configuration, installation, and contributing sections.
Changes:
- Added many new
*.zh.mdpages across docs sections (intro/install/configuration/contributing/design/faq). - Refined/updated several existing Chinese pages for wording/formatting consistency.
- Improved
docs/content/configuration/storage.mdby converting indented config samples into fenced TOML blocks (and fixing some TOML string quoting).
Reviewed changes
Copilot reviewed 48 out of 48 changed files in this pull request and generated 10 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/content/walkthrough.zh.md | New Chinese walkthrough page for using Athens proxy. |
| docs/content/try-out.zh.md | New Chinese “try-out” quickstart page. |
| docs/content/intro/why.zh.md | Edits to Chinese “why” page wording/formatting. |
| docs/content/intro/protocol.zh.md | Minor Chinese protocol doc wording/formatting fixes. |
| docs/content/intro/first-content.zh.md | Updates Chinese intro content phrasing. |
| docs/content/intro/components.zh.md | Updates Chinese components intro phrasing. |
| docs/content/install/shared-team-instance.zh.md | Updates Chinese shared-team install doc phrasing/formatting. |
| docs/content/install/managing-private-repos.zh.md | Updates Chinese private repo management doc formatting/wording. |
| docs/content/install/install-on-kubernetes.zh.md | Updates Chinese Kubernetes install guide (Helm, storage, secrets, etc.). |
| docs/content/install/install-on-google-cloud-run.zh.md | New Chinese Cloud Run install guide. |
| docs/content/install/install-on-gae.zh.md | New Chinese GAE install guide. |
| docs/content/install/install-on-bosh.zh.md | New Chinese BOSH install guide. |
| docs/content/install/install-on-aws-ecs-fargate.zh.md | New Chinese AWS ECS/Fargate install guide. |
| docs/content/install/install-on-aci.zh.md | Updates Chinese ACI install doc wording/formatting. |
| docs/content/install/build-from-source.zh.md | Updates Chinese build-from-source doc wording. |
| docs/content/install/_index.zh.md | Updates Chinese install index page wording/formatting. |
| docs/content/faq.zh.md | New Chinese FAQ page. |
| docs/content/design/proxy.zh.md | Minor Chinese design/proxy wording change. |
| docs/content/design/communication.zh.md | Minor Chinese design/communication wording change. |
| docs/content/design/_index.zh.md | Minor Chinese design index wording change. |
| docs/content/contributing/new/github.zh.md | New Chinese “Using GitHub” contributor onboarding doc. |
| docs/content/contributing/new/git.zh.md | New Chinese “Using Git” contributor onboarding doc. |
| docs/content/contributing/new/docs.zh.md | New Chinese docs contribution onboarding page. |
| docs/content/contributing/new/development.zh.md | New Chinese development guide for contributors. |
| docs/content/contributing/new/_index.zh.md | New Chinese “new contributors” chapter index. |
| docs/content/contributing/maintainers/_index.zh.md | New Chinese maintainers page. |
| docs/content/contributing/first-issues.zh.md | New Chinese “good first issues” guidance page. |
| docs/content/contributing/community/triaging.zh.md | New Chinese PR triage guidance page. |
| docs/content/contributing/community/philosophy.zh.md | New Chinese community philosophy page. |
| docs/content/contributing/community/participating.zh.md | New Chinese community participation guide. |
| docs/content/contributing/community/office-hours.zh.md | New Chinese office-hours/community meeting page. |
| docs/content/contributing/community/_index.zh.md | New Chinese contributing/community chapter index. |
| docs/content/contributing/_index.zh.md | New Chinese contributing section index. |
| docs/content/configuration/upstream.zh.md | New Chinese upstream proxy configuration doc. |
| docs/content/configuration/sumdb.zh.md | New Chinese sumdb proxy configuration doc. |
| docs/content/configuration/storage.zh.md | New Chinese storage configuration doc. |
| docs/content/configuration/storage.md | Formatting/validity improvements to English storage configuration doc code blocks. |
| docs/content/configuration/prefill-disk-cache.zh.md | New Chinese prefill disk cache doc. |
| docs/content/configuration/logging.zh.md | New Chinese logging configuration doc. |
| docs/content/configuration/home-template.zh.md | New Chinese home template configuration doc. |
| docs/content/configuration/filter.zh.md | New Chinese (deprecated) filter file doc. |
| docs/content/configuration/download.zh.md | New Chinese download-mode file doc. |
| docs/content/configuration/authentication.zh.md | New Chinese authentication configuration doc. |
| docs/content/configuration/_index.zh.md | New Chinese configuration section index. |
| docs/content/_index.zh.md | Updates Chinese site landing page wording/formatting. |
| .claude/skills/doc-polisher/SKILL.md | Adds a Claude skill doc for polishing Chinese docs. |
| .claude/skills/bilingual-proofreader/SKILL.md | Adds a Claude skill doc for EN/ZH proofreading workflows. |
| .claude/skills/athens-translator/SKILL.md | Adds a Claude skill doc for translating Athens docs to Chinese. |
Comments suppressed due to low confidence (1)
docs/content/install/install-on-kubernetes.zh.md:190
- The command
helm install gomods/athens-proxy -n athens --namespace athens ...is not valid Helm syntax (and-nconflicts with--namespacein Helm 3). Please update these examples to a correct, consistent Helm version/syntax (e.g., Helm 3helm install <release> <chart> --namespace <ns>), and ensure the rest of the doc matches the same Helm major version.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| Athens通过将代码从VCS复制到_不可变_存储中来解决这些问题。 | ||
|
|
||
| 在这种方式下,您就不需要手动将任何内容上传到Athens后端存储。Go第一次向Athens请求依赖包时,Athens会从VCS(Github、Bitbucket等)获取。但一旦检索到该模块,它将永远保存在Athens的后端存储中,并且代理将不再返回到VCS中获取同一版本的依赖包。这就是雅典如何实现模块不变性。需要注意的是,后端存储掌握在您的手中。 | ||
| 在这种方式下,您就不需要手动将任何内容上传到Athens后端存储。Go第一次向Athens请求依赖包时,Athens会从VCS(Github、Bitbucket等)获取。但一旦检索到该模块,它将永远保存在Athens的后端存储中,并且代理将不再返回到VCS中获取同一版本的依赖包。这就是Athens如何实现模块不可变性的。需要注意的是,后端存储掌握在您的手中。 |
There was a problem hiding this comment.
This sentence ends with “模块不可变性的”,which is grammatically incorrect and reads like an accidental possessive. It should refer to “模块不可变性” (no trailing 的) to match the intended meaning.
| - secretName: athens.mydomain.com | ||
| hosts: | ||
| - "athens.mydomain.com | ||
| ``` |
There was a problem hiding this comment.
This YAML example has an unterminated string ("athens.mydomain.com is missing the closing quote), which makes the snippet invalid as written.
| ```json | ||
| "environment": [ | ||
| {"name": "AWS_REGION", "value": "us-east-1"}, | ||
| {"name": "AWS_USE_DEFAULT_CONFIGURATION", "value": "true"}, | ||
| {"name": "ATHENS_STORAGE_TYPE", "value": "s3"}, | ||
| {"name": "ATHENS_S3_BUCKET_NAME", "value": "athens-proxy-us-east-1-123456789012"}, | ||
| ] | ||
| ``` |
There was a problem hiding this comment.
This code block is tagged as json but the snippet is not valid JSON (trailing comma after the last array element, and the array isn't wrapped in an object). Please either make it valid JSON, or switch the fence to something like jsonc / text if you want to keep it as a fragment.
| 有关更多信息,请参阅 Kubernetes 文档中的[管理容器的计算资源](https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/)。 | ||
|
|
||
| ### 通过Github令牌(Token)授予athens访问私有存储库的权限(可选) | ||
| ### 通过 Github Token 授予 Athens 访问私有仓库的权限(可选) |
There was a problem hiding this comment.
In the heading, "Github" should be capitalized as "GitHub" (the config field name GithubToken should stay as-is if that's the actual setting name).
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
What is the problem I am trying to address?
chineses translations for docs
How is the fix applied?
Translated by minimax v2.7 and manually proofread.