Skip to content

Commit 58e4e2c

Browse files
committed
Merge branch 'CONTRIBUTING' into docs
2 parents 66b98b0 + a7776fa commit 58e4e2c

File tree

1,771 files changed

+154481
-8620
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,771 files changed

+154481
-8620
lines changed

.github/workflows/packer.yml

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ jobs:
2626
# actions/cache的逻辑会在job末尾缓存打包程序;如果不命中,就自行构造程序。
2727
- name: Cache Packer
2828
id: cache-packer
29-
uses: actions/cache@v3
29+
uses: actions/cache@v4
3030
with:
3131
key: ${{ runner.os }}-Packer-${{ hashFiles('src/Packer/**') }}
3232
path: |
@@ -53,7 +53,7 @@ jobs:
5353
# # actions/cache的逻辑会在job末尾缓存打包程序;如果不命中,就自行构造程序。
5454
# - name: Cache Uploader
5555
# id: cache-uploader
56-
# uses: actions/cache@v3
56+
# uses: actions/cache@v4
5757
# with:
5858
# key: ${{ runner.os }}-Uploader-${{ hashFiles('src/Uploader/**') }}
5959
# path: Uploader.exe
@@ -109,8 +109,7 @@ jobs:
109109
# 由于Github的限制,这里需要重新拉取打包程序。
110110
- name: Restore Packer
111111
id: cache-restore
112-
# https://github.com/actions/cache/issues/1265#issuecomment-1819612829 `fail-on-cache-miss` for restore action not failing the workflow
113-
uses: actions/cache/restore@v3.3.1
112+
uses: actions/cache/restore@v4
114113
with:
115114
key: ${{ runner.os }}-Packer-${{ hashFiles('source/Packer/**') }}
116115
path: |
@@ -177,7 +176,12 @@ jobs:
177176
- name: Restore Artifacts
178177
uses: actions/download-artifact@v4
179178
with:
180-
path: artifacts/
179+
path: artifacts/
180+
181+
# feat: UTC 20:00~21:00 取消上传(避开远程服务器的4:00-4:10)
182+
- name: Fail at inappropriate time
183+
run: if [ `date -u +%H` -eq 20 ]; then exit -1; fi
184+
shell: bash
181185

182186
- name: Run Uploader
183187
run: .\Uploader --host="${{ secrets.SSH_IP }}" --name="${{ secrets.SSH_USER }}" --password="${{ secrets.SSH_PWD }}"

.github/workflows/pr-packer.yml

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ jobs:
2828
# actions/cache的逻辑会在job末尾缓存打包程序;如果不命中,就自行构造程序。
2929
- name: Cache Packer
3030
id: cache-packer
31-
uses: actions/cache@v3
31+
uses: actions/cache@v4
3232
with:
3333
key: ${{ runner.os }}-Packer-${{ hashFiles('src/Packer/**') }}
3434
path: |
@@ -62,8 +62,7 @@ jobs:
6262
# 由于Github的限制,这里需要重新拉取打包程序。
6363
- name: Restore Packer
6464
id: cache-restore
65-
# https://github.com/actions/cache/issues/1265#issuecomment-1819612829 `fail-on-cache-miss` for restore action not failing the workflow
66-
uses: actions/cache/restore@v3.3.1
65+
uses: actions/cache/restore@v4
6766
with:
6867
key: ${{ runner.os }}-Packer-${{ hashFiles('src/Packer/**') }}
6968
path: |

CONTRIBUTING.md

Lines changed: 43 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@
66

77
- [贡献方针](#贡献方针)
88
- [仓库结构](#仓库结构)
9-
- [翻译用语共识](#翻译用语共识)
109
- [翻译贡献方针](#翻译贡献方针)
1110
- [总则](#总则)
1211
- [Pull Request 相关规定](#pull-request-相关规定)
@@ -30,29 +29,30 @@
3029
Minecraft-Mod-Language-Package
3130
├─.github --------------- // GitHub 相关配置文件
3231
├─config ---------------- // 配置文件
33-
│ └─packer -------------- // 打包器配置文件
32+
│ └─packer ------------- // 打包器配置文件
33+
├─docs ------------------ // 各类文档
3434
├─projects -------------- // 翻译文件
35-
└─(Minecraft 版本) ---- // 不带 fabric 字样的是用于 Forge 和 NeoForge 模组的
36-
└─assets
37-
├─(CurseForge 项目名称) ---- // 见下
38-
│ └─(命名空间) ------------- // 见下
39-
│ └─lang ----------------- // 语言文件文件夹
40-
│ ├─en_us.json --------- // English (United States) 语言文件
41-
│ └─zh_cn.json --------- // 中文 (简体) 语言文件
42-
│ ├─(Modrinth 项目名称)------- // 见下
43-
│ └─(命名空间) ------------- // 见下
44-
│ └─lang ----------------- // 语言文件文件夹
45-
│ ├─en_us.json --------- // English (United States) 语言文件
46-
│ └─zh_cn.json --------- // 中文 (简体) 语言文件
47-
├─minecraft
48-
│ └─minecraft -------------- // Minecraft 原版使用的命名空间
49-
│ ├─font
50-
│ │ └─glyph_sizes.bin ---- // 全角标点修复文件
51-
│ └─textures
52-
│ └─font --------------- // 全角标点修复文件
53-
└─1UNKNOWN ----------------- // 存放不在 CurseForge 和 Modrinth 上发布的模组
54-
└─(命名空间)
55-
└─lang
35+
└─(Minecraft 版本) --- // 不带 fabric 字样的是用于 Forge 和 NeoForge 模组的
36+
└─assets
37+
├─(CurseForge 项目名称) ---- // 见下
38+
│ └─(命名空间) ------------- // 见下
39+
│ └─lang ----------------- // 语言文件文件夹
40+
│ ├─en_us.json --------- // English (United States) 语言文件
41+
│ └─zh_cn.json --------- // 中文 (简体) 语言文件
42+
├─(Modrinth 项目名称)------- // 见下
43+
│ └─(命名空间) ------------- // 见下
44+
│ └─lang ----------------- // 语言文件文件夹
45+
│ ├─en_us.json --------- // English (United States) 语言文件
46+
│ └─zh_cn.json --------- // 中文 (简体) 语言文件
47+
├─minecraft
48+
│ └─minecraft -------------- // Minecraft 原版使用的命名空间
49+
│ ├─font
50+
│ │ └─glyph_sizes.bin ---- // 全角标点修复文件
51+
│ └─textures
52+
│ └─font --------------- // 全角标点修复文件
53+
└─1UNKNOWN ----------------- // 存放不在 CurseForge 和 Modrinth 上发布的模组
54+
│ └─(命名空间)
55+
│ └─lang
5656
└─src --------------- // 各种自动化工具的源码
5757
├─Formatter ------- // 格式化工具,曾用于统一翻译文件格式
5858
├─Language.Core
@@ -63,7 +63,7 @@ Minecraft-Mod-Language-Package
6363

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

66-
**命名空间(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)
66+
**命名空间(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)
6767

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

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

77-
78-
* 例:Minecraft 版本 1.19.2 与 1.19.4 均属同一大版本号 1.19 下的子版本。
79-
若某一模组在两个版本上的开发均活跃,由于 1.19.4 的版本号更高,因此优先考虑该模组在 1.19.4 下的译名标准化情况与适配情况。
80-
这一优先级不会影响到模组在其他大版本下(如 1.18、1.12 等)的分支。
81-
82-
## 翻译用语共识
83-
84-
1. “材料 + 质/制 + 中心词”的翻译,如“铁质涡轮”或“铁制涡轮”,二者皆合理。只需单模组内统一。
85-
2. 关于“木制品名称”的翻译,可参考 [#4525](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/issues/4525) 的解决方法。
86-
77+
- 例:Minecraft 版本 1.19.2 与 1.19.4 均属同一大版本号 1.19 下的子版本。
78+
若某一模组在两个版本上的开发均活跃,由于 1.19.4 的版本号更高,因此优先考虑该模组在 1.19.4 下的译名标准化情况与适配情况。
79+
这一优先级不会影响到模组在其他大版本下(如 1.18、1.12 等)的分支。
8780

8881
## 翻译贡献方针
8982

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

9285
### 总则
9386

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

10094
### Pull Request 相关规定
10195

@@ -136,37 +130,38 @@ projects 文件夹下只标出模组所属的大版本号,其中的模组翻
136130

137131
#### 审查规则
138132

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

143137
#### 审查人
144138

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

151146
#### PR 作者
152147

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

159154
### 搁置规则
160155

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

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

169-
因搁置而关闭的 PR,PR 作者若想继续更新,可重新打开(Reopen)PR。
164+
因搁置而关闭的 PR,PR 作者若想继续更新,可联系管理员重新打开(Reopen)PR。
170165

171166
### 公示规则
172167

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,8 @@
6565

6666
- [Minecraft Wiki:译名标准化](https://zh.minecraft.wiki/w/Minecraft_Wiki:%E8%AF%91%E5%90%8D%E6%A0%87%E5%87%86%E5%8C%96)[译名历史](https://zh.minecraft.wiki/w/Minecraft_Wiki:%E8%AF%91%E5%90%8D%E6%A0%87%E5%87%86%E5%8C%96/%E5%8E%86%E5%8F%B2) - 原版词汇中英对照及变更记录。
6767
- [Minecraft 中文标准译名查询](https://mcst.teahouse.team/) - 搜索原版词条在 简中/港繁/台繁/文言 中的翻译。
68-
- [Minecraft 模组翻译参考词典](https://dict.mcmod.cn/) - 以英文检索本仓库中的翻译条目。
68+
- [Minecraft 模组翻译参考词典](https://dict.vmct-cn.top/) - 以英文或中文检索本仓库中的翻译条目。
69+
- [MC百科 Minecraft 模组翻译参考词典](https://dict.mcmod.cn/) - 以英文检索本仓库中的翻译条目,数据更新较慢。
6970
- [MC百科社群的翻译讨论](https://bbs.mcmod.cn/forum.php?mod=forumdisplay&fid=31&filter=typeid&typeid=116) - 模组翻译讨论,零散汉化发布。
7071

7172
### 其他

config/packer/1.12.2.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@
55
"zh_cn"
66
],
77
"exclusionMods": [
8-
"gregtechce"
8+
"gregtechce",
9+
"matteroverdrive-legacy"
910
],
1011
"exclusionNamespaces": [
1112
"srparasites"

config/packer/1.21.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,8 @@
1010
"floating": {
1111
"inclusionDomains": [
1212
"font",
13-
"textures"
13+
"textures",
14+
"gui"
1415
],
1516
"exclusionDomains": [
1617
],
File renamed without changes.

0 commit comments

Comments
 (0)