Skip to content

贡献方针修改 #4978

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
SlimeSB wants to merge 14 commits into
base: main
Choose a base branch
from
Open

贡献方针修改 #4978

Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
8931ab9
+机翻预审查 +质量要求
SlimeSB Feb 5, 2025
8253f39
格式改动
SlimeSB Feb 5, 2025
188debd
添加超链接
SlimeSB Feb 7, 2025
0f8589c
将两份标准移动到机翻审查参考
SlimeSB Feb 17, 2025
4f1f1de
Merge remote-tracking branch 'upstream/main' into CONTRIBUTING
SlimeSB Jun 8, 2025
c5ebe26
Update CONTRIBUTING.md
SlimeSB Jun 11, 2025
61b0b2f
判断和处置
SlimeSB Jun 22, 2025
8e80f68
Squashed commit of the following:
SlimeSB Jun 22, 2025
6fac519
译后编辑
SlimeSB Jun 23, 2025
a7776fa
Create 仓库Wiki.md
SlimeSB Jun 23, 2025
015f618
迁移至 #5008
SlimeSB Jul 20, 2025
9128dff
packer doc忘改回来了
SlimeSB Jul 20, 2025
d991ce5
- docs - 规范
SlimeSB Jul 28, 2025
8446dec
Update CONTRIBUTING.md
SlimeSB Nov 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
90 changes: 42 additions & 48 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

- [贡献方针](#贡献方针)
- [仓库结构](#仓库结构)
- [翻译用语共识](#翻译用语共识)
- [翻译贡献方针](#翻译贡献方针)
- [总则](#总则)
- [Pull Request 相关规定](#pull-request-相关规定)
Expand All @@ -30,29 +29,29 @@
Minecraft-Mod-Language-Package
├─.github --------------- // GitHub 相关配置文件
├─config ---------------- // 配置文件
│ └─packer -------------- // 打包器配置文件
│ └─packer ------------- // 打包器配置文件
├─projects -------------- // 翻译文件
│ └─(Minecraft 版本) ---- // 不带 fabric 字样的是用于 Forge 和 NeoForge 模组的
│  └─assets
│  ├─(CurseForge 项目名称) ---- // 见下
│  │ └─(命名空间) ------------- // 见下
│  │ └─lang ----------------- // 语言文件文件夹
│  │ ├─en_us.json --------- // English (United States) 语言文件
│  │ └─zh_cn.json --------- // 中文 (简体) 语言文件
│ ├─(Modrinth 项目名称)------- // 见下
│  │ └─(命名空间) ------------- // 见下
│  │ └─lang ----------------- // 语言文件文件夹
│  │ ├─en_us.json --------- // English (United States) 语言文件
│  │ └─zh_cn.json --------- // 中文 (简体) 语言文件
│  ├─minecraft
│  │ └─minecraft -------------- // Minecraft 原版使用的命名空间
│  │ ├─font
│  │ │ └─glyph_sizes.bin ---- // 全角标点修复文件
│  │ └─textures
│  │ └─font --------------- // 全角标点修复文件
│  └─1UNKNOWN ----------------- // 存放不在 CurseForge 和 Modrinth 上发布的模组
│  └─(命名空间)
│  └─lang
│ └─(Minecraft 版本) --- // 不带 fabric 字样的是用于 Forge 和 NeoForge 模组的
│ └─assets
│ ├─(CurseForge 项目名称) ---- // 见下
│ │ └─(命名空间) ------------- // 见下
│ │ └─lang ----------------- // 语言文件文件夹
│ │ ├─en_us.json --------- // English (United States) 语言文件
│ │ └─zh_cn.json --------- // 中文 (简体) 语言文件
│ ├─(Modrinth 项目名称)------- // 见下
│ │ └─(命名空间) ------------- // 见下
│ │ └─lang ----------------- // 语言文件文件夹
│ │ ├─en_us.json --------- // English (United States) 语言文件
│ │ └─zh_cn.json --------- // 中文 (简体) 语言文件
│ ├─minecraft
│ │ └─minecraft -------------- // Minecraft 原版使用的命名空间
│ │ ├─font
│ │ │ └─glyph_sizes.bin ---- // 全角标点修复文件
│ │ └─textures
│ │ └─font --------------- // 全角标点修复文件
│ └─1UNKNOWN ----------------- // 存放不在 CurseForge 和 Modrinth 上发布的模组
│ └─(命名空间)
│ └─lang
└─src --------------- // 各种自动化工具的源码
├─Formatter ------- // 格式化工具，曾用于统一翻译文件格式
├─Language.Core
Expand All @@ -63,7 +62,7 @@ Minecraft-Mod-Language-Package

**CurseForge 项目名称**：以匠魂为例，它的 CurseForge 页面地址是 `https://www.curseforge.com/minecraft/mc-mods/tinkers-construct`，则 `CurseForge 项目名称` 为 `tinkers-construct`。因为它是唯一的，被用来追溯模组来源。

**命名空间（Namespace）**：以匠魂为例，用压缩软件打开模组文件（JAR 格式），它的 en_us.json 的路径为 `assets/tconstruct/lang/en_us.json`，则 `{命名空间}` 为 `assets/` 和 `/lang` 之间的内容，即 `tconstruct`。一个模组可能有多个命名空间。命名空间介绍见 [Minecraft Wiki](https://zh.minecraft.wiki/w/%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4ID?variant=zh-cn#%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4)。
**命名空间（Namespace）**：以匠魂为例，用压缩软件打开模组文件（JAR 格式），它的 en_us.json 的路径为 `assets/tconstruct/lang/en_us.json`，则 `{命名空间}` 为 `assets/` 和 `/lang` 之间的内容，即 `tconstruct`。一个模组可能有多个命名空间。命名空间介绍见 [Minecraft Wiki：命名空间](https://zh.minecraft.wiki/w/%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4ID?variant=zh-cn#%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4)。

**Modrinth 项目名称**：以 Modrinth 独占模组 Clean F3 为例，它的 Modrinth 页面地址是 `https://modrinth.com/mod/clean-f3`，则在 `mod/` 后的内容 `clean-f3` 为 `{Modrinth 项目名称}` 的**主体**部分，而为了与 Curseforge 上发布的模组作以区分，所有仅在 Modrinth 上发布的模组，在其之前需要添加 `modrinth-` 作为区分。综上，它的 `{Modrinth 项目名称}` 为 `modrinth-clean-f3`。

Expand All @@ -74,28 +73,22 @@ projects 文件夹下只标出模组所属的大版本号，其中的模组翻
1. 模组活跃更新的 Minecraft 版本优先。
2. 若所有小版本都活跃更新，则 Minecraft 版本高者优先。


* 例：Minecraft 版本 1.19.2 与 1.19.4 均属同一大版本号 1.19 下的子版本。
若某一模组在两个版本上的开发均活跃，由于 1.19.4 的版本号更高，因此优先考虑该模组在 1.19.4 下的译名标准化情况与适配情况。
这一优先级不会影响到模组在其他大版本下（如 1.18、1.12 等）的分支。

## 翻译用语共识

1. “材料 + 质/制 + 中心词”的翻译，如“铁质涡轮”或“铁制涡轮”，二者皆合理。只需单模组内统一。
2. 关于“木制品名称”的翻译，可参考 [#4525](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/issues/4525) 的解决方法。

- 例：Minecraft 版本 1.19.2 与 1.19.4 均属同一大版本号 1.19 下的子版本。
若某一模组在两个版本上的开发均活跃，由于 1.19.4 的版本号更高，因此优先考虑该模组在 1.19.4 下的译名标准化情况与适配情况。
这一优先级不会影响到模组在其他大版本下（如 1.18、1.12 等）的分支。

## 翻译贡献方针

以下内容只针对 [projects](./projects) 文件夹下的贡献。

### 总则

- 翻译**必须**符合 [Minecraft 模组简体中文翻译规范与指南](https://cfpa.site/TransRules/)的规定。
- **拒绝**接收机器翻译（含生成式 AI）、生硬翻译。
- 翻译**必须**遵守 [Minecraft 模组简体中文翻译指南](https://cfpa.site/TransRules/)。
- **拒绝**接收机器翻译（含生成式 AI）、生硬翻译（不符合中文表达习惯的）。
- 若直接提交此类翻译，该 PR 将被打上“生硬翻译”标签。
- 若作者不及时进行有效修改，PR 可能会依照本仓库的[搁置规则](#搁置规则)处理。
- 翻译**必须**在审校后才能进入仓库。
- 若提交者未及时进行有效修改，依照本仓库的[搁置规则](#搁置规则)处理。
- 已经过译后编辑，且**满足指南要求**的翻译可以接收。
- 提交的翻译**必须**在审查后才能进入仓库。

### Pull Request 相关规定

Expand Down Expand Up @@ -136,37 +129,38 @@ projects 文件夹下只标出模组所属的大版本号，其中的模组翻

#### 审查规则

- 审查的基本依据**是**[翻译贡献方针](#翻译贡献方针)。
- 审查流程**必须**满足本文档[翻译审查](#翻译审查)内容所述。
- 审查过程中各方**应**遵守[礼仪](https://zh.wikipedia.org/wiki/Wikipedia:%E7%A4%BC%E4%BB%AA)（[备用](https://share.weiyun.com/LRvx1omf)）。
- 翻译审查的基本依据**是**[翻译贡献方针](#翻译贡献方针)。
- 翻译审查的流程**必须**满足本文档[翻译审查](#翻译审查)内容所述。
- 翻译审查过程中各方**应**遵守[礼仪](https://zh.wikipedia.org/wiki/Wikipedia:%E7%A4%BC%E4%BB%AA)（[备用](https://share.weiyun.com/LRvx1omf)）。

#### 审查人

- 任何人都能利用 GitHub 提供的[相关功能](https://docs.github.com/zh/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)来审查 PR 中翻译。所有参与审查的用户即为审查人。
- [CFPA团队](https://github.com/CFPAOrg) 的成员（Member）和[仓库](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package)的协作者（Collaborator）是具有团队官方性质的审查人。
- 至少一位具有官方身份的审查人对 PR 给出批准（Approval）审查后，PR 才能合并。
- 审查人在给出批准审查后**应**给 PR 加上“即将合并”标签，此后需至少等待 24 小时，若等待期间没有新动态则可以合并 PR。
- “动态”包括但不限于 PR 作者发送提交（Commit）、审查人提出意见。
- [CFPA团队](https://github.com/CFPAOrg) 的成员（Member）和[本仓库](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package)的协作者（Collaborator）是具有团队官方性质的审查人，统称为管理员。
- 至少一位管理员对 PR 给出批准（Approval）意见后，PR 才能合并。
- 管理员在给出批准意见后**应**给 PR 加上“即将合并”标签，此后需至少等待 24 小时，若等待期间没有新动态则可以合并 PR。
- “动态”包括但不限于 PR 作者提交（Commit）、审查人评论。
- 管理员有根据常识判断和处置包含不适宜内容 PR 的权力。处置措施包括但不限于：要求使用中立表述、删减、关闭 PR、限制用户提交。

#### PR 作者

- PR 作者**应**对审查作出合理回应，或接受建议，或提出异议。
- 在接受审查人的建议后，PR 作者**应**解决（Revolve）相应的对话（Conversation）。
- 若拒绝审查人的建议，或和审查人的观点相左，PR 作者**不应**急于解决（Revolve）对话（Conversation）
- PR 作者**应**及时做出回应，否则 PR 可能会按[搁置规则](#搁置规则)关闭。
- PR 作者如遇到 Git/GitHub 操作上的困难，**应**先询问后操作，避免造成混乱。
- PR 作者如遇到 Git/GitHub 操作上的困难，请先询问后操作，避免造成混乱。

### 搁置规则

搁置规则用于解决由于 PR 作者迟迟不出面响应审查要求而导致的 PR 积压问题。

1. 若 PR 中存在未作者未响应的审查超过 7 天，审查人有权提及（@）PR 作者，提醒其相应审查意见，然后加上“即将被搁置”标签。
2. 若“即将被搁置”标签存在超过 7 天，PR 作者将被视为无法回应。此时
2. 若“即将被搁置”标签存在超过 7 天，PR 作者将被视为无法回应。此时：
- 2.1 若存在要求 PR 作者参与的审查意见，PR 将被加上“即将拒收”标签。1 天后 PR 将被关闭。
- 2.2 若审查意见都无需 PR 作者参与，PR 将被加上“即将拒收”标签。1 天缓冲期内官方审查人**可以**直接采纳审查意见，并终止计时，转入合并流程。
3. 在 1、2 所述过程中，若 PR 作者做出了回应，标签将被清除，计时重新从 1 开始。

因搁置而关闭的 PR，PR 作者若想继续更新，可重新打开（Reopen）PR。
因搁置而关闭的 PR，PR 作者若想继续更新，可联系管理员重新打开（Reopen）PR。

### 公示规则

Expand Down