diff --git a/public-docs/plugins/publishing.md b/public-docs/plugins/publishing.md index 101b7c1caf..092a5eaed4 100644 --- a/public-docs/plugins/publishing.md +++ b/public-docs/plugins/publishing.md @@ -72,8 +72,10 @@ each value sets only `name` or `description`, as non-empty strings. Paseo itself To translate the overview, publish a complete copy named for the language next to `OVERVIEW.md`, such as `OVERVIEW.zh-CN.md`. The scaffold's `files` list already includes `OVERVIEW.*.md`. The -registry reads every `OVERVIEW..md` as a translation and fails publication on a tag that is not -a canonical language tag, so do not name other files that way. Readers in that language see the +registry reads `OVERVIEW..md` as a translation when the tag is a canonical language tag with a +two- or three-letter language code, other than `en`. It ignores other names, such as +`OVERVIEW.backup.md` or `OVERVIEW.zh-cn.md`. A three-letter name such as `OVERVIEW.old.md` counts as +a language, so do not use one for a non-translation. Readers in that language see the translation; others see the English overview with a notice. The overview rules above apply to translations, so update them when `OVERVIEW.md` changes. Reviewers can add or correct translations in the registry. diff --git a/public-docs/plugins/publishing.zh-CN.md b/public-docs/plugins/publishing.zh-CN.md index c4406f6ace..fe9c231e12 100644 --- a/public-docs/plugins/publishing.zh-CN.md +++ b/public-docs/plugins/publishing.zh-CN.md @@ -50,7 +50,7 @@ nav: 发布 每个字段都是可选的,缺少的字段会显示英文。注册表在发布插件时检查 `translations`:键必须是除 `en` 之外的标准语言标签,每个值只能设置 `name` 或 `description`,且必须是非空字符串。Paseo 本身不读取 `translations`,因此这里的错误会导致发布失败,而不会影响安装。 -要翻译概览,请在 `OVERVIEW.md` 旁边发布一份以语言命名的完整副本,例如 `OVERVIEW.zh-CN.md`。脚手架的 `files` 列表已经包含 `OVERVIEW.*.md`。注册表会把每个 `OVERVIEW.<标签>.md` 都当作翻译,标签不是标准语言标签时发布会失败,因此不要用这种方式命名其他文件。使用该语言的读者会看到翻译;其他读者会看到英文概览和一条提示。上面的概览规则同样适用于翻译,因此 `OVERVIEW.md` 变更时请同步更新翻译。审查者可以在注册表中补充或修正翻译。 +要翻译概览,请在 `OVERVIEW.md` 旁边发布一份以语言命名的完整副本,例如 `OVERVIEW.zh-CN.md`。脚手架的 `files` 列表已经包含 `OVERVIEW.*.md`。当标签是语言代码为两个或三个字母、且不是 `en` 的标准语言标签时,注册表会把 `OVERVIEW.<标签>.md` 当作翻译,并忽略 `OVERVIEW.backup.md`、`OVERVIEW.zh-cn.md` 这类其他名称。`OVERVIEW.old.md` 这样的三字母名称会被当作一种语言,因此不要用它命名非翻译文件。使用该语言的读者会看到翻译;其他读者会看到英文概览和一条提示。上面的概览规则同样适用于翻译,因此 `OVERVIEW.md` 变更时请同步更新翻译。审查者可以在注册表中补充或修正翻译。 ## 图标和截图 {#icons-and-screenshots}