Skip to content
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.

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

Translate the website to Simplified Chinese #144

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
8,276 changes: 8,276 additions & 0 deletions package-lock.json

Large diffs are not rendered by default.

28 changes: 23 additions & 5 deletions src/locales/zh/common.flt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
lang-name = 简体中文

title = The Quilt Project
title = Quilt 项目
short-title = QuiltMC
description = 真正关心你的模组加载器。

Expand All @@ -11,7 +11,9 @@ serial-comma = {$prev}、{$next}
-developer-wiki = 开发者 Wiki
-forum = 论坛
-import-utility = Quilt 导入工具
-help-wanted = 需要帮助
-patch-notes = 更新日志
-sponsors = 赞助商
-staff-resources = 内部资源
-template-mod = 模组模板

Expand All @@ -22,7 +24,15 @@ serial-comma = {$prev}、{$next}
-twitter = Twitter
-twitch = Twitch

page-authors = 作者:{$names}
page-authors =
{ $count ->
[one] Author
*[other] Authors
}: {$names}
page-edited = 编辑于:{DATETIME($date, month: "long", year: "numeric", day: "numeric")}
post-date = {DATETIME($date, month: "long", year: "numeric", day: "numeric")}
edit-on-github = 在 GitHub 上编辑这个页面


nav-about = 关于
nav-blog = 博客
Expand All @@ -36,24 +46,30 @@ divider-external-links = 外部链接

nav-page-developer-wiki = {-developer-wiki}
nav-page-import-utility = {-import-utility}
nav-page-maven-repo = Maven
nav-page-maven-repo = Maven 仓库
nav-page-help-wanted = {-help-wanted}
nav-page-patch-notes = {-patch-notes}
nav-page-sponsors = {-sponsors}
nav-page-staff-resources = {-staff-resources}
nav-page-template-mod = {-template-mod}
nav-page-legal = 准则
nav-page-donate = 捐赠

button-close = 关闭
button-discord = {-discord}
button-discord-toolchain = 开发服务器
button-discord-toolchain = 工具链
button-developer-wiki = {-developer-wiki}
button-donate = 捐赠
button-forum = {-forum}
button-github = {-github}
button-install = 安装
button-join-npo = Join The Non-Profit
button-mastodon = {-mastodon}
button-maven-repo = Maven 库
button-more = 更多
button-more-posts = 更多文章
button-help-wanted = {-help-wanted}
button-official-site = 官方网站
button-patch-notes = Minecraft {-patch-notes}
button-rss = RSS
button-template-mod = {-template-mod}
Expand All @@ -64,6 +80,7 @@ button-usage-docs = 使用文档
sidebar-pages = 页面
sidebar-resources = 资源
sidebar-teams = 团队
sidebar-versions = 版本

paginator-button-first = 第一页
paginator-button-previous = 上页
Expand All @@ -77,5 +94,6 @@ prompt-error-noscript = 你已禁用 JavaScript。请启用 JavaScript 以使用
prompt-search-language = 在这里查找你的语言……

page-404 = 404
page-404-title = 页面失踪了 :(
page-404-title = 页面未找到 :(
page-404-subtitle = 找不到你要访问的页面 orz
page-404-image-title = Sad Pineapple :(
3 changes: 3 additions & 0 deletions src/locales/zh/footer.flt
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,6 @@ disclaimer-icons =
# NOTE: <0></0> is the pineapple emote.
made-with =
制作中使用了 <0></0> 、<1>Bulma</1>、以及 <2>CreativeBulma 插件</2>

sponsored-by =
Powered by <0>Cloudflare</0>.
76 changes: 76 additions & 0 deletions src/pages/zh/about/faq-devs.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: FAQ (Developers)
description: Frequently asked questions, but for developers.
layout: /src/layouts/Page.astro
---

import Message from "@atoms/Message.astro";

<Message>

## 开发者文档在哪里?

Quilt 的开发者文档目前还处于极为初步的阶段,远未达到可用的状态。然而,我们正在努力完善,并且您可以在[modder.wiki.quiltmc.org](https://modder.wiki.quiltmc.org)上预览到目前为止的内容。

</Message> <Message>

## 为什么我应该选择 Quilt 而不是 Fabric 进行我的模组开发?

对于开发者来说,Quilt 相比于 Fabric 提供了以下优势:

- 更全面的 API,可以更快、更轻松地开发兼容性更好的模组
- 模块化的 API 方法也适用于您的模组,无需将 API 模块以 jar-in-jar 方式打包,也不需要让用户单独下载它们
- 改进的反编译器(相较于[Fabric 的 Fernflower 分支](https://github.com/FabricMC/intellij-fernflower)),提供了更可读、更准确、更易理解的输出,让您更好地了解 Minecraft 的代码
- 对映射的替代方法,基于 Yarn 但移除了清空规则,可以提供更准确的命名,而不影响质量,同时在使用不同映射集时更容易在官方渠道寻求支持
- 更注重社区的方法,确保每个人在提出问题和发表意见时都能被听到,无论他们是开发者的数量还是知名度如何
- **未来目标:**一种新的碰撞处理 ASM 后端(Chasm),它作为我们 mixin 和访问拓展实现的支撑,使这些和其他字节码操作工具能够在 Quilt 的构建工具或加载器中无需特殊处理而正常工作,并帮助模组保持互相兼容

</Message>

<Message>

## 什么是所谓的无干扰(clean-room)方法,为什么它很重要?

当谈到**无干扰(clean-room)**时,我们指的是[Fabric 的 Yarn 映射项目](https://github.com/FabricMC/yarn)采取的一种特定贡献方法。Yarn 采用一种方法来确保项目的安全性,拒绝明显受到其他映射项目(如 MCP 和 Mojang 官方映射)名称启发的名称。它还阻止贡献者查看其他映射项目的名称,并要求在 Fabric 的官方社区空间中的讨论不涉及非 Yarn 名称。

然而,Quilt Mappings(以下简称 QM)采取了不同的方法。由于该项目使用[知识共享零许可证](https://creativecommons.org/share-your-work/public-domain/cc0)(与 Yarn 类似),QM 明确表示不主张对这些名称拥有所有权,而是对可能派生自其他映射项目的任何贡献的名称保留了相应的所有权。此外,QM 还包含明确显示某些名称的所有权可能属于其他映射项目(并提供适当的致谢)的许可通知等,这使得 QM 的贡献者可以参考其他映射项目来确定某个名称的最佳选择。这也意味着我们不必在官方社区空间中禁止涉及其他项目名称的讨论。

然而值得注意的是,**某个名称出现在其他映射项目中并不意味着我们会接受它**。所有贡献的名称都必须能够独立自立,无论 Mojang 或其他组织提供什么名称。

</Message>

<Message>

## 移植我的 Fabric 模组有多难?

我们计划尽可能减少这个过渡带来的不便。我们将匹配 Fabric 的 API 表面,允许您继续使用 Yarn 的映射,并为正在移植其模组的开发人员提供支持。值得注意的是,在撰写本文时,Quilt 的向后兼容性工作支持包含 mixin 插件(例如用于条件混入)的 Fabric 模组,但一旦[Chasm](#what-the-heck-is-chasm-exactly)添加到工具链中,这种支持将不再存在。Quilt 将提供一种具有适当工具链支持的替代方法,并且我们将帮助您找到如何切换到该方法的方式,如果您需要支持的话。

</Message>

<Message>

## 加载 Fabric mod 的向后兼容性能持续多久?

只要保持与 Fabric 的兼容性不会对项目产生负面影响,我们将继续这样做。但是,如果维护兼容性变得不可行,我们将帮助将其转移到一个由社区运行的项目,并为其开发人员提供所需的支持,以便他们可以继续工作。

简而言之,向后兼容性将一直持续到无法继续维护为止。

</Message>

<Message>

## 如何开始编写 Quilt 模组?

虽然我们目前仍在努力完善开发者文档,但我们有一个[模板模组](https://github.com/QuiltMC/quilt-template-mod),您可以将其用作模板,或者仅用作入门参考。我们将在测试期间和之后继续完善文档,敬请关注!

</Message> <Message>

## 到底什么是 Chasm?

Chasm 是**碰撞处理 ASM(Collision Handling ASM)**的缩写。Chasm 是一个字节码转换库,作为一个后端用于通过单独的前端使用,而不是供模组直接使用。它旨在提供一种更安全的运行时修改字节码的方式,自动处理碰撞并努力帮助模组保持兼容性。

使用 Chasm 的前端包括 Access Widener 和 Mixin。然而,Quilt 或社区也可以编写其他额外的前端。

目前 Chasm 尚未实现,但我们正在努力开发中!

</Message>
132 changes: 132 additions & 0 deletions src/pages/zh/about/faq.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
---
title: FAQ
description: Frequently asked questions, for the burning topics that need addressing regularly.
layout: /src/layouts/Page.astro
---

import Message from "@atoms/Message.astro";

# 常见问题

<Message>

## 什么是 Quilt?

Quilt 是一个主要用于 Minecraft 的模组工具链,它是从 Fabric 项目中分叉出来的,主要是由于对治理、项目管理和管理规范的关注。您可以在[关于我们页面](/zh/about)上了解更多关于 Quilt 项目以及它的来源。

</Message>

<Message>

## Quilt 分叉了 Fabric 的哪些部分?

全部都分叉了。Quilt 是 Fabric 的一个硬分叉,并且我们的目标是分叉和维护所有必要的项目,以便独立存在。

</Message>

<Message>

## 为什么我应该使用 Quilt?

对于用户来说,Quilt 提供以下优势:

- 模组之间应该更加兼容,尽管它们使用了强大的模组工具
- 兼容 Fabric 和 Quilt 模组,这意味着您无需停止使用您喜爱的模组
- 开放、透明和友好的官方社区,关心社会问题,拥有经验丰富的团队,并与用户一起不断改进
- **未来目标:** 自动下载 Quilt 的库(可以禁用),这样您始终会有确切且仅需所需的库来使您的模组正常工作

</Message>
<Message>

## 如何支持 Quilt?

如果您想帮助我们,以下是一些我们想到的方式:

- 加入[我们的社区空间](/zh/community),参与讨论并提供您的意见
- 对我们在 GitHub 上的项目进行贡献,可以直接参与代码编写,也可以提供审核和意见
- 支持其他使用 Quilt 或 Quilt 工具和库的项目
- 在社交媒体上谈论 Quilt(负责任地)

最重要的是,即使只是使用 Quilt 或在我们的社区空间中参与讨论,这对我们也是有帮助的。我们欢迎各种活动、意见和贡献!

</Message>

# 使用问题

<Message>

## Quilt 能加载 Forge 模组吗?

不,Quilt 无法加载 Forge 模组,也不计划支持此功能。有一些第三方项目(如 Patchwork)计划添加此功能,但它们不由 Quilt 维护,并且它们不属于 Quilt 项目的一部分。

</Message>

<Message>

## Quilt 能加载 Fabric 模组吗?

在大多数情况下,是的。由于 Quilt 是基于 Fabric 进行的分支,大多数 Fabric 模组应与 Quilt 兼容。只要维护 Fabric 兼容性不会对项目产生负面影响,我们将继续支持。但如果到了无法维护的地步,我们将帮助将其移至一个由社区运营的项目,并为开发人员提供他们继续工作所需的支持。

需要注意的是,截至目前,Quilt 支持包含 mixin 插件的 Fabric 模组,但这在将来将会改变。这并不是一个主要问题,因为绝大多数模组都不使用 mixin 插件,但我们将乐意与需要在 Quilt 上使用其他方法的模组开发者合作。

</Message>

<Message>

## 如果我使用 Fabric 模组,是否需要安装 Fabric API?

**不需要** - 实际上,出于兼容性的考虑,我们建议不要安装 Fabric API。

许多 Quilt 模组使用 Quilt Standard Libraries(QSL),而这些库与 Fabric API 直接不兼容。为了解决这个问题,QSL 包含了一个特殊版本的 Fabric API,它不会产生冲突 - 它是标准的 QSL 发行版的一部分,您可以从 [Modrinth](https://modrinth.com/mod/qsl) 下载。

只要 Fabric 模组正确地使用了来自 Fabric API 的预期公共 API,它们应该与 QSL 正常工作。

</Message>

<Message>

## Fabric 能加载 Quilt 模组吗?

不行。Quilt 模组与 Fabric 模组是不同的,并且不以相同的方式定义。

</Message>

<Message>

## Quilt 何时发布?

Quilt 的第一个 beta 版本于 2022 年 4 月 20 日发布,自那时以来我们一直在全力以赴!

如果您想尝试 Quilt,请查看[安装页面](/zh/install)。 [<i class="fas fa-cannabis has-text-dark is-pulled-right"></i>](https://www.youtube.com/watch?v=DJfg39WkMvE)

</Message>

# 管理问题

<Message>

## Quilt 的组织结构是什么样的?

Quilt 的人员分为三个不同的团队:

- 管理委员会(Admin Board),负责监督项目的发展方向,管理 GitHub 的权限,并决定投票的结果
- 社区团队(Community Team),负责社区管理和监管任务,以及社交媒体账户和公共关系
- 开发团队,负责独立监督分配给他们的特定项目

在这三个团队之间,结构基本上是平等的 - 没有一个团队有绝对决策权。此外,社区团队没有对任何官方社区空间的直接所有权,它在一个无关的、选举产生的关键持有人的监督下进行工作。

您可以在[关于我们页面](/zh/about/#governance)的治理部分了解更多信息。

</Message>

<Message>

## 什么是 RFC?它们是如何工作的?

**RFC** 是 **R**equest **F**or **C**omments 的缩写。RFC 过程指的是在实施之前,社区创建、讨论和批准重要的流程和政策变更、技术标准和定义的系统。这是通过创建详细说明提案内容和理由的长篇文档来实现的。

RFC 通过向 [GitHub 上的 RFC 仓库](https://github.com/QuiltMC/rfcs) 提交拉取请求来提出。RFC 的编号与拉取请求的编号相对应(除非是修订)。任何人都可以提交提案,但我们建议有意提交提案的人在 Discord 上与我们进行讨论,或在 GitHub 上提出问题。

Quilt 的 RFC 过程在 [RFC 0001: The RFC Process](https://github.com/QuiltMC/rfcs/blob/master/structure/0001-rfc-process.md) 中有详细记录。

</Message>
29 changes: 29 additions & 0 deletions src/pages/zh/about/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
title: About Us
description: Learn about where Quilt came from, how its governance works, and how to get involved in structural changes.
layout: /src/layouts/Page.astro
---

Quilt 是一个面向 Minecraft 的模组加载器项目。它由 Fabric 项目的用户和贡献者创建,作为解决该项目引发的争议和问题的最后手段。由于 Fabric 具有坚实的技术基础,并且在很多方面做得很好,Quilt 的创始人决定最好的选择是采取标准的开源方法来解决管理上的分歧 - 他们将 Fabric 项目分叉为一个新的模组加载器项目,并考虑了以下几个想法:

- 在适当的时候允许贡献者快速迭代和尝试新功能
- 在官方社区空间和政策中建立透明度
- 创建一个了解 Quilt 价值观重要性的社区团队,通过理解型的实际管理方法促进包容性、多样性和安全性,该团队由强有力的[行为准则](/zh/community/code-of-conduct)支持
- 提供一种不给任何人过多权力的治理结构,避免给工作人员创造没有监督的机会
- 提供让社区参与重要项目决策的方式

自成立以来,Quilt 发展迅速,并得到了更广泛社区的广泛支持。尽管社区的一些角落试图反对其现代进步的价值观,Quilt 仍在不断发展,吸引了来自各个阶层的开发者和用户。

# 治理

Quilt 在项目治理方面采取了一种不同寻常的方式,试图避免任何一个人对整个项目拥有过多权力。这并不是一项特别容易的任务,特别是在管理社区空间(以及像 Discord 这样没有团队所有权概念的平台)时。Quilt 试图通过以下几种方式解决这个问题:

- 从项目成员中选举一个管理委员会,负责监督项目的发展方向,管理 GitHub 上的权限,以及打破投票平局
- 选举一个关键持有人作为 Quilt 官方社区空间的实际所有者,该人是 Minecraft 模组界中有声望、受人尊敬和知名的人物,但与 Quilt 没有其他任何关联
- 选举一个社区团队来管理 Quilt 的官方社区空间和社交媒体账号,该团队在一定程度上独立于组织的其他部分,由专注于社区管理而不是 Quilt 项目开发的工作人员组成
- 将每个开发项目的责任分配给独立团队,每个团队都有自己的领导和层级结构 - 包括子团队和处理问题的团队,视需要而定
- 提供一套流程文件,需要按照这些文件进行操作,例如组建新团队、选举团队成员、选举新的管理委员会成员和其他项目管理任务

通过这种方式,Quilt 旨在避免在少数人对整个项目拥有绝对权力时经常发生的问题。此外,允许团队独立运作意味着它们能够更高效、更有效地工作。

透明度是 Quilt 价值观的核心部分,因此它还利用了一种“请求评论”(RFC)系统,通过向 GitHub 存储库提交 Pull Request 的形式进行。该系统允许任何人查看、审查并提出对项目重要流程的更改建议,甚至可以通过创建问题或 Pull Request 提出新的流程建议。这个过程本身在 RFC 0001: The RFC Process 中有详细说明,任何希望参与的人都可以参与其中。
Loading