[docs] add zh docs (#3507)

* [docs] add zh docs * [docs] add lang dropdown * [docs] update mkdocs zh config * [docs] migrate assets * [docs] update overrides dir in mkdocs zh config * [docs] exclude locales director in main mkdocs config * [docs] rename assets to public to avoid conflicting with template * [docs] extra_css change followup * [docs] add theme.palette.toggle.icon back into mkdocs zh config * [docs] fix zh readme reference + migrate language-specific repo markdown to docs * [docs] translate remaining repo docs + update reference * [docs] update zh index.md reference * [docs/zh] wording alignment
2025-12-15 06:23:01 -06:00 · 2024-11-05 13:36:43 +00:00 · 2024-11-05 13:36:43 +00:00 · 38a08cd25a
commit 38a08cd25a
parent e953d80dff
139 changed files with 20407 additions and 24 deletions
--- a/docs/locales/zh/user_guide/custom_css.md
+++ b/docs/locales/zh/user_guide/custom_css.md
@ -0,0 +1,73 @@
+# 自定义 CSS（进阶）
+
+CSS（级联样式表）是一种与 HTML 一起使用的编码语言，它决定了网页在浏览器中的外观：
+
+> HTML 用于定义内容的结构和语义，CSS 用于对其进行样式化和布局。例如，你可以使用 CSS 来更改内容的字体、颜色、大小和间距，分成多列，或添加动画和其他装饰功能。
+>
+> -- [学习 CSS (Mozilla)](https://developer.mozilla.org/zh-CN/docs/Learn/CSS)
+
+根据你的 GoToSocial 实例管理员配置的设置，你可以通过用户设置面板上传自定义 CSS 到你的账户。
+
+这允许你为使用网络浏览器访问你的 GoToSocial 账户页的用户自定义页面外观。
+
+## 示例 - 更改背景颜色
+
+这是一个标准的 GoToSocial 账户页面：
+
+![一个 GoToSocial 测试账户页面。标准配色方案是灰色、蓝色和橙色。](./../public/cssstandard.png)
+
+假设我们想将背景颜色改为黑色而不是灰色。
+
+在用户设置面板中，我们在自定义 CSS 字段中输入以下 CSS 代码：
+
+```css
+.page {
+  background: black;
+}
+```
+
+然后我们点击保存账户信息。
+
+如果我们返回到账户页面并刷新页面，现在它看起来是这样的：
+
+![同一个 GoToSocial 测试账户页面。背景现在是黑色。](./../public/cssblack.png)
+
+如果我们想要更炫一点，可以使用下面的 CSS 代码为背景添加渐变效果：
+
+```css
+.page {
+  background: linear-gradient(crimson, purple);
+}
+```
+
+保存 CSS 并刷新账户页面后，页面现在看起来是这样的：
+
+![同一个 GoToSocial 测试账户页面。背景现在从深红色开始，向下渐变为紫色。](./../public/cssgradient.png)
+
+## 可访问性
+
+可访问的 HTML 和 CSS 的重要性不容忽视。以下节选自 W3：
+
+> 网络的基本设计理念是为所有人服务，无论他们的硬件、软件、语言、位置或能力如何。当网络达到这一目标时，它对具有不同的听力、行动、视力和认知能力的人来说都是可访问的。
+>
+> 因此，残疾带来的影响在网络上有根本性的不同，因为网络消除了许多人在物理世界中面临的交流和互动障碍。然而，当网站、应用程序、技术或工具设计不佳时，它们可能会带来把人排除在网络之外的新障碍。
+>
+> 对于希望创建高质量网站和网络工具，而不希望把使用其产品和服务的部分人群排除在外的开发者和组织来说，可访问性是必不可少的。
+>
+> -- [网络可访问性介绍](https://www.w3.org/WAI/fundamentals/accessibility-intro/)
+
+标准的 GoToSocial 主题在设计中考虑了网络可访问性，特别是在布局、颜色对比、字体大小等方面。
+
+如果你为账户编写自定义 CSS，非常重要的一点是确保它保持可读，并按预期运行。按钮应看起来像按钮，链接应看起来像链接，文本应以可读的字体呈现，元素不应在页面上跳动等。网页可以做到漂亮且令人兴奋，而不必牺牲可读性或让事情过于复杂。
+
+如果你更改你的配色方案，最好验证新颜色，以确保它们具有足够的对比度以便视觉障碍（如色盲）的人可以阅读。一旦更新了 CSS，试着将你的账户 URL 输入对比度检查工具中，如[颜色对比度可访问性验证器](https://color.a11y.com/Contrast)。你还可以使用网络浏览器的“可访问性”选项卡检查是否存在任何问题。
+
+以可访问性为中心进行样式设置可以让网络对所有人更友好！查看下面的链接以获取更多信息。
+
+## 有用链接
+
+- [学习 CSS (Mozilla)](https://developer.mozilla.org/zh-CN/docs/Learn/CSS)
+- [CSS 教程 (W3 Schools)](https://www.w3schools.com/Css/default.asp)
+- [CSS 和 JavaScript 可访问性最佳实践 (Mozilla)](https://developer.mozilla.org/en-US/docs/Learn/Accessibility/CSS_and_JavaScript#css)
+- [WAVE 网页可访问性评估工具](https://wave.webaim.org/)
+- [颜色对比度可访问性验证器](https://color.a11y.com/Contrast)
--- a/docs/locales/zh/user_guide/migration.md
+++ b/docs/locales/zh/user_guide/migration.md
@ -0,0 +1,78 @@
+# 迁移
+
+GoToSocial 支持使用 `Move` 活动进行账号迁移。
+
+这允许你将账号迁移到你的 GoToSocial 账号，或者将你的 GoToSocial 账号迁移到其他账号。
+
+迁移是软件无关的，因此你可以将账号迁移到其它软件或从任何支持 `Move` 活动的软件发起迁移，无论具体的软件是什么。例如，你可以将 GoToSocial 账号迁移到 Mastodon 账号，将 Mastodon 账号迁移到 GoToSocial 账号，将 GoToSocial 账号迁移到或从 Akkoma、Misskey、GoToSocial 等。
+
+!!! tip
+    根据目标账号所在软件的不同，目标账号的 URI（用于别名和迁移）应该类似于 `https://mastodon.example.org/users/account_you_are_moving_to`。如果你不确定使用哪种格式，请咨询你要迁移或设置别名的实例管理员。
+
+!!! warning
+    GoToSocial 要求 7 天的账号迁移冷却期，以防止过度切换实例（以及潜在的屏蔽规避风险）。
+    
+    如果任何一个发起新迁移尝试的账号在最近七天内已迁移，GoToSocial 将拒绝进行迁移，直到上一次迁移过去七天位置。
+
+## 将你的 GoToSocial 账号迁移到其他账号（从 GoToSocial 迁移）
+
+使用迁移账号设置，你可以将你的 GoToSocial 账号迁移到给定的目标账号 URI。
+
+为使迁移成功：
+
+1. 目标账号（你要迁移到的账号）必须反向别名到你当前的账号（你要从中迁移的账号）。
+2. 目标账号必须可从你当前账号访问，即不被你屏蔽，不屏蔽你，未被封禁，不在你当前实例的屏蔽列表中。
+
+迁移你的账号将从你当前账号向粉丝发送一条消息，指示他们关注目标账号。根据你的粉丝使用的服务器软件，他们可能会自动向目标账号发送关注请求，并取消关注你当前账号。
+
+目前，**只有你的粉丝会转移到新账号**。其他如关注列表、贴文、媒体、书签、点赞、屏蔽等不会转移。
+
+一旦你的账号迁移完成，你当前的（旧的）账号的网页视图将显示已迁移的信息，以及迁移的目标账号。
+
+除非手动删除，否则旧账号的贴文和媒体仍可在这个已迁移的账号的网页视图中看到。如果你愿意，可以请求你迁出的实例管理员在迁移完成后封禁/删除你的账号。
+
+如有必要，你可以使用相同的目标账号 URI 重试账号迁移。这将再次发送迁移消息。这在你的粉丝由于网络问题或其他临时故障未收到迁移消息的情况下很有用。
+
+!!! danger "账号迁移是不可逆的永久操作！"
+    
+    从 GoToSocial 触发账号迁移的那一刻起，你将仅对已迁移的账号拥有基本读取和删除权限。
+    
+    你仍然可以登录旧账号，查看自己的贴文、点赞、收藏、屏蔽和列表。
+    
+    你也可以编辑个人资料，删除和/或取消置顶自己的贴文，以及取消转发、取消点赞和取消收藏。
+    
+    但是，你将无法执行任何涉及创建内容的操作，如创建贴文、转发、添加收藏或点赞、关注他人、上传媒体、创建列表等。
+    
+    此外，你将无法查看任何时间线（主页标签、公共列表），或使用搜索功能。
+
+## 将账号迁移到你的 GoToSocial 账号（迁移到 GoToSocial）
+
+要成功从其他账号向你的 GoToSocial 账号触发迁移，你必须首先创建一个**别名**，将你的 GoToSocial 账号链接回你要发起迁移的账号，以表明你也拥有要迁移到的 GoToSocial 账号。
+
+为此，你必须首先使用你的 GoToSocial 账号登录 GoToSocial 设置面板。例如，如果你的 GoToSocial 实例位于 `https://example.org`，你应登录设置面板 `https://example.org/settings`。
+
+然后，进入“迁移”部分，查看“别名账号”子部分：
+
+![展示已填写账号别名的别名账号子部分。](../public/migration-aliasing.png)
+
+在第一个还未填写账号别名框中，输入你希望**发起迁移**的账号的 URL。这表示你要发起迁移的账号属于你，即你“也被称为”该账号。
+
+例如，如果你要从实例 `ondergrond.org` 上的账号 `@dumpsterqueer` 迁移，应输入 `https://ondergrond.org/@dumpsterqueer` 或 `https://ondergrond.org/users/dumpsterqueer` 作为账号别名，如上图所示。
+
+输入别名后，点击“保存账号别名”按钮。如果一切顺利，按钮上会显示一个勾。如果不行，会显示一个错误帮助你判断出错的原因。
+
+一旦你从 GoToSocial 账号创建了指向要发起迁移的账号的别名，你可以在另一账号所在实例的设置面板发起到你的 GoToSocial 账号的迁移。
+
+在 Mastodon 上，“账号迁移”设置部分看起来如下：
+
+![Mastodon “账号迁移”设置页面。](../public/migration-mastodon.png)
+
+如果你正在从 Mastodon 账号迁移到 GoToSocial 账号，你会在“新账号代号”字段中填写 GoToSocial 账号的 `@[username]@[domain]` 值。例如，如果你的 GoToSocial 账号用户名是 `@someone`，并且在实例 `example.org` 上，那么在此处输入 `@someone@example.org`。
+
+一旦触发从其他账号到 GoToSocial 账号的迁移，你唯一需要做的就是在新（GoToSocial）账号上接受来自旧账号粉丝的关注请求。
+
+!!! tip
+    为了省去麻烦，可以考虑在触发迁移前将 GoToSocial 账号设置为不需要批准新的关注请求。迁移完成后再开启关注请求审核。否则，你将需要手动批准每个从旧账号迁移的粉丝。
+
+!!! tip
+    迁移账号后，可能需要将之前账号的关注列表导入 GoToSocial 账号。[在此查看](./settings.md#import)如何通过设置面板完成此操作的详细信息。
--- a/docs/locales/zh/user_guide/password_management.md
+++ b/docs/locales/zh/user_guide/password_management.md
@ -0,0 +1,19 @@
+# 密码管理
+
+## 更改你的密码
+
+你可以使用[用户设置面板](./settings.md)来更改密码。只需登录用户设置面板，滑动到页面底部，输入你的旧密码和想要的新密码即可。
+
+如果你提供的新密码不够长或不够复杂，设置面板会报错并提示你尝试其他密码。
+
+如果你的实例使用 OIDC（即通过 Google 或其他外部提供商登录），你需要通过 OIDC 提供商，而不是通过用户设置面板更改密码。
+
+## 密码存储
+
+GoToSocial 使用安全的 [bcrypt](https://en.wikipedia.org/wiki/Bcrypt) 函数，通过 [Go 标准库](https://pkg.go.dev/golang.org/x/crypto/bcrypt)在数据库中存储用户密码的哈希值。
+
+这意味着，即使你的 GoToSocial 实例数据库遭到破坏，你的密码明文也是安全的。这也意味着你的实例管理员无法访问你的密码。
+
+为了在接受前检查密码是否足够安全，GoToSocial 使用[这个库](https://github.com/wagslane/go-password-validator)，其熵值设置为 60。这意味着像 `password` 这样的密码会被拒绝，但像 `verylongandsecurepasswordhahaha` 这样的密码会被接受，即使没有特殊字符/大写和小写字母等。
+
+我们建议遵循 EFF 关于[创建强密码](https://ssd.eff.org/en/module/creating-strong-passwords)的指南。
--- a/docs/locales/zh/user_guide/posts.md
+++ b/docs/locales/zh/user_guide/posts.md
@ -0,0 +1,300 @@
+# 贴文
+
+## 隐私设置
+
+GoToSocial 为贴文提供 Mastodon 风格的隐私设置。从最私密到最不私密的顺序是：
+
+* 私信
+* 互关可见
+* 私密/仅粉丝可见
+* 不列出
+* 公开
+
+无论为贴文选择哪种隐私设置，GoToSocial 都会尽力确保你的贴文不会出现在你已屏蔽的实例或你直接屏蔽的用户面前。
+
+与一些其他联邦宇宙服务端实现不同，GoToSocial 对新账户使用 `不列出` 作为默认的贴文设置，而不是使用 `公开`。我们的理念是，将某条贴文公开始终应该是一个明确作出的决定，而不是默认选择。
+
+请注意，尽管 GoToSocial 非常严格地遵循这些隐私设置，但其他服务端实现不一定可靠：联合网络中存在不良行为者。与任何社交媒体一样，你应该仔细考虑你发布的内容及其受众。
+
+### 私信
+
+`私信` 可见性的贴文只会显示给贴文作者和贴文中提到的用户。以下是一个示例：
+
+```text
+嘿 @whoever@example.org，这是一条私信！只有咱们能看到！
+```
+
+如果这条消息是由 `@someone@server.com` 写的，那么只有 `@whoever@example.org` 和 `@someone@server.com` 能看到。
+
+顾名思义，`私信` 贴文用于你希望与一个或多个特定人交流的情况。
+
+然而，`私信` 贴文并不是替代端到端加密消息（如 [Signal](https://signal.org/) 和 [Matrix](https://matrix.org/)）的合适选择。如果你要直接交流，但不是传递敏感信息，那么 `私信` 贴文是可以胜任的。如果你需要进行敏感且安全的交流，请使用其他工具！
+
+私信贴文可以被点赞，但不能被转发。
+
+私信贴文在你的 GoToSocial 实例上无法通过网页 URL 访问。
+
+### 互关可见
+
+`互关可见` 的贴文只会显示给贴文作者和与作者*互相关注*的人。换句话说，只有在满足两个条件时，其他人才能看到：
+
+1. 其他账户关注贴文作者。
+2. 贴文作者也关注其他账户。
+
+这在你希望只有朋友能看到某些内容时很有用。
+
+互关可见贴文可以被点赞，但不能被转发。
+
+互关可见贴文在你的 GoToSocial 实例上无法通过网页 URL 访问。
+
+### 私密/仅粉丝可见
+
+`仅粉丝` 贴文只对贴文作者和关注贴文作者的人可见。与 `互关可见` 类似，但只需满足第一个条件；贴文作者不需要回关其他账户。
+
+这在你想向粉丝发布公告，或分享一些比 `互关可见` 稍微不那么私密的内容时很有用。
+
+私密/仅粉丝可见贴文可以被点赞，但不能被转发。
+
+私密/仅粉丝可见贴文在你的 GoToSocial 实例上无法通过网页 URL 访问。
+
+### 不列出
+
+`不列出`（有时称为 `未锁定/悄悄公开`）的贴文是半公开的。它们会被发送给关注你的人，并可以转发到未关注你的人的时间线中，但不会出现在跨站或本站时间线上，也不会出现在你的公开资料页中。
+
+不列出贴文适用于你希望某个贴文传播，但不想被所有人立即看到的情况。也可以用于发布相对公开的贴文，同时不让跨站/本站时间线被占用。
+
+不列出贴文可以被点赞，也可以被转发。
+
+与 Mastodon 不同，不列出贴文在你的 GoToSocial 实例上无法通过网页 URL 访问！
+
+### 公开
+
+`公开` 可见性的贴文是*完全*公开的。它们可以通过网络看到，出现在本地和联合时间线上，并且完全可以被转发。`公开` 是将贴文广泛传播和易于分发的终极设置，适用于你希望某些内容可被广泛访问的情况。
+
+公开贴文可以被点赞，也可以被转发。
+
+**公开贴文可以在你的 GoToSocial 实例上通过网页 URL 访问！**
+
+## 输入类型
+
+GoToSocial 当前接受两种不同类型的贴文（以及用户简介）输入。你可以在[用户设置页面](./settings.md)在这两种类型之间进行选择。它们分别是：
+
+* `plain`
+* `Markdown`
+
+纯文本(`plain`)是默认的发帖方式：GtS 接受一些简单的文本，通过解析链接和提及等将其转化为优雅的 HTML。如果你习惯于使用 Mastodon 或 Twitter 或大多数其他社交媒体平台，这种发帖方式会让你一见如故。
+
+Markdown 是一种更复杂的组织文本的方式，在如何解析和格式化文本方面给你更多的控制权。
+
+GoToSocial 支持[基本 Markdown 语法](https://www.markdownguide.org/basic-syntax)，以及部分[扩展 Markdown 语法](https://www.markdownguide.org/extended-syntax/)，包括独立代码块、脚注、删除线、下标、上标和自动 URL 链接。
+
+你还可以在你的 markdown 中包含基本 HTML 片段！
+
+关于 Markdown 的更多信息，请参阅[Markdown 指南](https://www.markdownguide.org/)。
+
+关于 Markdown 语法的速查表，请参阅[Markdown 速查表](https://www.markdownguide.org/cheat-sheet)。
+
+## 媒体附件
+
+GoToSocial 允许你在贴文中附加媒体文件，大多数客户端会在贴文底部以画廊视图呈现这些文件。默认情况下，你可以向贴文附加 6 个媒体文件，但这可能会根据你使用的客户端和实例配置而有所不同。
+
+目前支持以下文件类型：
+
+- image/jpeg
+- image/gif
+- image/png
+- image/webp
+- video/mp4（大多数类型）
+
+默认情况下，上传媒体的大小限制为 40MB，但这可能会因实例配置而有所不同。
+
+### 图片描述（alt 文本）
+
+当你在贴文中附加图片或视频等媒体时，大多数客户端会提供选项，让你为图片或视频的内容撰写描述。这个描述将作为所有用户查看媒体时的 alt 文本出现。这对所有人，尤其是对盲人或视力部分受损的人来说有用。如果没有图片描述，对方可能难以理解媒体中包含的内容以及为何你将其附加到特定贴文中。
+
+撰写好的图片描述可能很难，但这样做非常值得！
+
+> 图片描述是一种表示关心的行为，也是无障碍的基本组成部分。没有它们，内容对盲人/视力低下的人来说将完全不可用。通过撰写图片描述，我们展现了对跨残疾团结及运动团结的支持。
+
+-- Alex Chen，[如何撰写图片描述](https://uxdesign.cc/how-to-write-an-image-description-2f30d3bf5546)。
+
+### Exif 数据
+
+当照片或视频拍摄时，大多数传统相机和手机相机会将 [Exif 数据标签](https://en.wikipedia.org/wiki/Exif) 编码为结果媒体的元数据。此 Exif 数据包含如下内容：
+
+- 相机的品牌和型号。
+- 图片或视频的颜色和像素信息。
+- 图片或视频的尺寸和方向。
+- 日期和时间信息。
+- 位置信息（如果启用）。
+
+一般来说，这些 Exif 数据点用于摄影师帮助整理他们自己的图片。然而，遗憾的是，它们也带来了[隐私和安全影响](https://en.wikipedia.org/wiki/Exif#Privacy_and_security)，特别是在涉及位置信息时。如果你曾在网上平台（如 Facebook）发布图片，你可能会想知道 Facebook 是如何知道图片的拍摄地点和时间的；这很大程度上归因于 Exif 数据中嵌入的位置信息和时间戳，Facebook 从中读取图片信息，以组装一条“你曾去过的地方”的时间线。
+
+为了避免泄漏你的位置信息，GoToSocial 努力在上传媒体时通过清零 Exif 数据点移除 Exif 信息。
+
+!!! danger
+    为了方便和保护隐私，GoToSocial 在上传图片文件时会自动移除 Exif 标签。然而，**无法自动移除 mp4 视频的 Exif 数据**（参见 [#2577](https://github.com/superseriousbusiness/gotosocial/issues/2577)）。
+    
+    在你将视频上传至 GoToSocial 之前，建议确保该视频的 Exif 数据标签已经被移除。你可以在线找到多种工具和服务来做到这一点。
+    
+    为防止 Exif 位置信息在一开始被写入图片或视频中，你还可以关闭设备摄像头应用中的位置标记（通常称为地理标记）。
+
+!!! tip
+    即使你在上传图片或视频之前已完全移除所有 Exif 元数据，恶意用户仍然可以通过媒体本身的内容推断出你的位置信息。
+    
+    如果你属于在生产中有保密需要的组织，或正在被跟踪或监视，你可能需要考虑不要发布任何可能含有你位置线索的媒体。
+
+## 格式化
+
+当贴文以 `plain`(纯文本) 格式提交时，GoToSocial 会自动进行一些整理和格式化，将其转换为 HTML，如下所述。
+
+### 空格
+
+任何开头或结尾的空格和换行都会从贴文中去除。因此，例如：
+
+```text
+
+
+这个贴文以换行开头
+```
+
+将变为：
+
+```text
+这个贴文以换行开头
+```
+
+### 包裹
+
+整个贴文将被 `<p></p>` 包裹。
+
+因此以下文本：
+
+```text
+你好，这是一条很短的贴文！
+```
+
+将变为：
+
+```html
+<p>你好，这是一条很短的贴文！</p>
+```
+
+### 换行
+
+任何换行符都将被替换为 `<br />`
+
+继续上述示例：
+
+```text
+你好，这是一条很短的贴文！
+
+这是另一行。
+```
+
+将变为：
+
+```html
+<p>你好，这是一条很短的贴文！<br /><br />这是另一行。</p>
+```
+
+### 链接
+
+任何可识别的链接将在文本中被缩短并转换为适当的超链接，还会添加一些其他属性。
+
+例如：
+
+```text
+这里是某个链接：https://example.org/some/link/address
+```
+
+将变为：
+
+```html
+这里是某个链接：<a href="https://example.org/some/link/address" rel="nofollow" rel="noreferrer" rel="noopener">example.org/some/link/address</a>
+```
+
+呈现为：
+
+> 这里是某个链接：[example.org/some/link/address](https://example.org/some/link/address)
+
+注意这仅对 `http` 和 `https` 链接有效；其他协议不支持。
+
+### 提及
+
+你可以通过以下方式提及其他账户：
+
+> @some_account@example.org
+
+在这个例子中，`some_account` 是你要提及的账户的用户名，`example.org` 是托管他们账户的域名。
+
+被提及的账户将收到你提到他们的通知，并能够看到提及他们的贴文。
+
+提及的格式类似于链接，所以：
+
+```text
+嗨 @some_account@example.org 最近怎么样？
+```
+
+将变为：
+
+```html
+嗨 <span class="h-card"><a href="https://example.org/@some_account" class="u-url mention">@<span>some_account</span></a></span> 最近怎么样？
+```
+
+呈现为：
+
+> 嗨 <span class="h-card"><a href="https://example.org/@some_account" class="u-url mention">@<span>some_account</span></a></span> 最近怎么样？
+
+当提及本站账户（即你的实例上的账户）时，提及第二部分是不必要的。如果在你的实例上有一个名为 `local_account_person` 的账户，你可以通过写：
+
+```text
+嘿 @local_account_person 你是我的网上邻居
+```
+
+变为：
+
+```html
+嘿 <span class="h-card"><a href="https://my.instance.org/@local_account_person" class="u-url mention">@<span>local_account_person</span></a></span> 你是我的网上邻居
+```
+
+呈现为：
+
+> 嘿 <span class="h-card"><a href="https://my.instance.org/@local_account_person" class="u-url mention">@<span>local_account_person</span></a></span> 你是我的网上邻居
+
+### 话题标签
+
+你可以在贴文中使用一个或多个话题标签来指示贴文主题，并允许贴文与其他使用相同话题标签的贴文被归入同一分组，以帮助你的贴文被他人发现。
+
+大多数 ActivityPub 服务端实现，如 Mastodon 等，只会通过它们使用的话题标签对**公开**贴文进行分组，但这并不是绝对的。一般来说，最好只对那些你希望能比其他情况下更广泛传播的公开可见贴文使用话题标签。这方面的一个好例子是 `#introduction` 话题标签，通常用于新账户想要向联邦宇宙介绍自己时使用！
+
+在贴文中包含话题标签的方式类似于大多数其他社交媒体软件：只需在你想用作话题标签的词前加上 `#` 符号。
+
+一些示例：
+
+* `#introduction`
+* `#Mosstodon`
+* `#LichenSubscribe`
+
+在 GoToSocial 中，话题标签不区分大小写，因此无论你在书写话题标签时使用大写、小写或两者混合，都会被视为相同的话题标签。例如，`#Introduction` 和 `#introduction` 会被视为完全相同。
+
+出于可访问性原因，在书写话题标签时，考虑使用大驼峰式（即每个单词的首字母大写）是更好的。换句话说：要把 `#thisisahashtag` 替换为 `#ThisIsAHashtag`。这样不仅视觉上更易读，屏幕阅读器也更容易朗读。
+
+你可以在 GoToSocial 贴文中包含任意数量的话题标签，而且每个话题标签的长度限制为 100 个字符。
+
+## 输入净化
+
+为了不传播脚本、漏洞以及不稳定的 HTML，GoToSocial 执行以下类型的输入净化：
+
+`plain` 输入类型：
+
+* 在解析前，会完全移除贴文正文和内容警告字段中的已有 HTML。
+* 在解析后，所有生成的 HTML 都会通过清理器处理以移除有害元素。
+
+`Markdown` 输入类型：
+
+* 在解析前，会完全移除内容警告字段中的已有 HTML。
+* 在解析前，贴文正文中的现有 HTML 会通过清理器处理以移除有害元素。
+* 在解析后，所有生成的 HTML 都会通过清理器处理以移除有害元素。
+
+GoToSocial 使用 [bluemonday](https://github.com/microcosm-cc/bluemonday) 进行 HTML 清理。
--- a/docs/locales/zh/user_guide/rss.md
+++ b/docs/locales/zh/user_guide/rss.md
@ -0,0 +1,15 @@
+# RSS
+
+RSS 是[简易信息聚合](https://en.wikipedia.org/wiki/RSS)的缩写。这是一种在网络上共享内容的非常成熟的标准。你可能在你喜欢的新闻网站和博客上看到过这个活泼的橙色 RSS 标志：
+
+![橙色 RSS 图标](../public/rss.svg)
+
+如果你愿意，可以配置你的 GoToSocial 账户，以将你的贴文以 RSS 订阅源的形式发布到网上。这让没有 Fediverse 账户的人也能定期获取你的贴文更新。这非常适合使用 GoToSocial 发布长篇博客形式的贴文，并希望任何人都能轻松阅读它们的情况。
+
+GoToSocial 账户的 RSS 源默认是关闭的。你可以通过[用户设置](./settings.md)在 `https://[你的实例域名]/settings` 启用它。
+
+启用后，你的账户的 RSS 订阅将可在 `https://[你的实例域名]/@[你的用户名]/feed.rss` 获取。如果你使用 RSS 阅读器，可以用其打开这个地址以检查 RSS 是否正常工作。
+
+## 哪些贴文会通过 RSS 分享？
+
+只有你最近的 20 篇公开贴文会通过 RSS 分享。回复和转发不包括在内。不列出的贴文也不包括在内。换句话说，通过 RSS 可见的贴文将仅是通过浏览器打开你的账户页时可见的贴文。
--- a/docs/locales/zh/user_guide/search.md
+++ b/docs/locales/zh/user_guide/search.md
@ -0,0 +1,20 @@
+# 搜索
+
+## 查询格式
+
+GoToSocial 接受多种搜索查询格式：
+
+- `@用户名`：在所有已知实例中搜索给定用户名的账户。可能返回多个结果。
+- `@用户名@域`：搜索具有特定用户名和域名的外站账户。最多只会返回1个结果。
+- `https://example.org/some/arbitrary/url`：搜索具有给定 URL 的账户或贴文。如果账户或贴文尚未联合到 GoToSocial，将尝试获取它。最多只会返回1个结果。
+- `#标签名`：搜索具有给定标签名或以其开头的话题标签。大小写不敏感。可能返回多个结果。
+- `任意文本`：搜索包含该文本的贴文、包含该文本的话题标签，以及用户名、显示名或简介中含有该文本的账户。将搜索由你撰写的贴文以及回复你的贴文。仅在你关注的账户中搜索账户简介。可能返回多个结果。
+
+## 搜索运算符
+
+搜索关键词可以包含以下搜索运算符：
+
+- `from:用户名`：将结果限制为由指定**本站**账户创建的贴文。
+- `from:用户名@域`：将结果限制为由指定外站账户创建的贴文。
+
+例如，你可以搜索 `sloth from:你的用户名` 来查找你关于树懒的贴文。
--- a/docs/locales/zh/user_guide/settings.md
+++ b/docs/locales/zh/user_guide/settings.md
@ -0,0 +1,268 @@
+# 设置
+
+GoToSocial 提供了一个设置界面，你可以在这里更新你的贴文和账户设置，添加头像和横幅背景图，为你的账户撰写简介等。
+
+你可以通过访问自己 GoToSocial 实例的 `https://my-instance.example.com/settings` 来访问设置。设置面板同样使用 OAuth 机制进行身份验证。
+
+在提供实例 URL 后，你会看到提示，要求你使用电子邮件地址和密码登录。
+
+## 账户
+
+![用户设置界面的账户部分截图，显示头像、横幅背景图和昵称的预览，并提供更改它们的表单字段](../public/user-settings-profile-info.png)
+
+在账户部分，你可以更改昵称、头像和横幅背景图。你还可以选择启用手动批准关注请求，并选择提供公开的贴文 RSS 源。
+
+### 设置头像/横幅背景图
+
+要设置头像或横幅背景图，请在相应部分点击 `浏览` 按钮，并使用文件浏览器选择图像。
+
+当前支持的图像格式有 `gif`、`png`、`webp` 和 `jpeg`/`jpg`。
+
+页面底部会显示图像在你的账户中的预览。如果你对选择满意，点击页面底部的 `保存账户信息` 按钮。
+
+如果你转到自己的账户页并刷新页面，页面将会显示新的头像/横幅背景图。这个更新可能需要一些时间才能传播到其他外站实例。
+
+### 选择主题
+
+GoToSocial 提供主题供你选择，以更改账户的外观和氛围。
+
+要选择主题，只需在账户设置页面中选择，然后点击页面底部的 `保存账户信息`。用浏览器查看账户页（可能需要刷新页面），你会看到新主题已被应用，访问你账户的其他人也会看到。
+
+!!! tip "添加更多主题"
+    实例管理员可以通过将 CSS 文件放入 `web/assets/themes` 文件夹中来添加更多主题。有关详细信息，请参阅管理员文档中的[主题](../admin/themes.md)部分。
+
+### 基本信息
+
+#### 昵称
+
+昵称是与你的用户名一起显示在账户上的简短标识。
+
+尽管创建后无法更改用户名，但昵称可以更改。
+
+昵称可以包含空格、大写字母、表情符号等。
+
+这是放网名或全名的好地方。例如，如果你的用户名是 `@miranda`，昵称可以是 `Miranda Priestly`。
+
+#### 简介
+
+你的简介是介绍你的账户和自己的较长文本。适合用于：
+
+- 提示你贴文的内容。
+- 提及大致年龄/位置。
+- 链接到你的其他账户或账户。
+- 说明与他人互动时的边界和偏好。
+- 链接你经常使用的标签。
+
+简介支持 `纯文本` 或 `markdown` 格式。默认贴文格式设置如[贴文设置](#贴文设置)中所述。
+
+#### 资料字段
+
+资料字段是一系列名称/值对，将显示在账户上，并传播到其他外站实例。
+
+此处适合放置的信息包括：
+
+- 你的网站链接
+- 众筹/捐助页面的链接
+- 你的年龄
+- 人称代词
+
+一些示例：
+
+- 别名：汉德尔·沃尔特
+- 我的网站：https://example.org
+- 年龄：99
+- 代词：she/her/她
+- 我的其他账户：@someone@somewhere.com
+
+### 可见性和隐私
+
+#### 个人资料上显示的贴文可见性级别
+
+使用此下拉菜单，你可以选择在你的网页版账户页、贴文以及 RSS 源（如果你已启用 RSS）上显示的贴文可见性级别。
+
+**默认情况下，GoToSocial 仅在网页版账户页上显示公开可见的贴文，而不显示不列出的贴文。** 你可以调整此设置，以显示不列出的贴文，这类似于其他 ActivityPub 软件如 Mastodon 的默认设置。
+
+你还可以选择在 GoToSocial 的网页视图上完全不显示任何贴文。这样，你可以安心发表贴文，而无需担心有人通过网页浏览你的个人资料并查看你的贴文。
+
+此设置仅适用于你自己的贴文的可见性。其他用户的“不列出”贴文永远不会显示。
+
+此设置不会影响你的贴文在 ActivityPub 协议和客户端中的可见性，因此即便你选择不在网页版账户页显示任何贴文，只要他人是你的粉丝、你的贴文被转发到他们的时间线，或使用链接搜索你的某个贴文，他们仍然可以看到的贴文。
+
+!!! warning
+    请注意，此设置的更改也会应用于之前的贴文。
+    
+    也就是说，如果你之前发布了一条“不列出”可见性的贴文，而当时你的网页版账户页被设置为仅显示公开贴文，此时如果你更改此设置为一并显示公开和不列出，那你之前发布的“不列出”贴文将会与公开贴文一起显示在你的网页版账户页上。
+    
+    同样地，如果你选择不显示任何贴文，那么所有贴文将从你的网页版账户页中隐藏，无论它们是在何时创建，也无论当时此选项被设置为什么。这种情况将持续直到你再次更改此设置。
+
+!!! tip
+    结合（域名）屏蔽，如果有人通过公开贴文骚扰你，这是一种很好的“紧急”设置。虽然它不会阻止在 ActivityPub 客户端中可以看到你的贴文的人，但至少会防止他们无需身份验证就通过浏览器点击查看你的贴文，并通过 URL 轻松与他人分享。
+
+#### 手动批准关注请求（即锁定帐户）
+
+此复选框允许你决定是否希望手动审核账户的关注请求。
+
+当此选项**未勾选**时，新关注请求会被自动批准，无需你的干预。对于更面向公众的账户或不怎么发布敏感信息的情况而言，这很有用。
+
+当其**已勾选**时，你必须手动批准新关注请求，并可以拒绝你不想被关注的账号的关注请求。这对仅向粉丝发布私人内容的私人账户很有用。
+
+在联邦宇宙中，一般将此选项称为“锁定”账户。
+
+勾选或取消勾选复选框后，务必点击底部的 `保存账户信息` 按钮以保存新设置。
+
+#### 将账户标记为可被搜索引擎和目录发现
+
+此设置用于更新账户上的“可发现”标记。
+
+选中账户的可发现性框可执行以下操作：
+
+- 更新账户的 robots 元信息标记，允许其被搜索引擎索引并出现在搜索引擎结果中。
+- 向外站指示账户可包含在公共目录和索引中。
+
+将可发现性标记打开可能需要一周或更长时间才会生效，账户不会立即出现在搜索引擎结果中。
+
+!!! tip
+    为了避免暴露给爬虫，新帐户的可发现性默认为 false。但对于希望被抓取的面向公众的帐户，将其设置为 true 是有用的。
+
+!!! info
+    可发现性设置是关于**账户的可发现性**，而不是贴文的可被搜索性。这与 Mastodon 实例或其他使用全文搜索的实例的贴文索引无关！
+
+#### 启用公开贴文的 RSS 源
+
+用户的 RSS 源默认情况下是禁用的，但可以通过此复选框选择。有关更多信息，请参阅 [RSS](./rss.md)。
+
+此源仅包括设置为“公开”的贴文（参见 [隐私设置](./posts.md#隐私设置)）。
+
+!!! warning
+    公开您的 RSS 源允许*任何人*匿名订阅您公开贴文的更新，绕过关注和关注请求。
+
+#### 隐藏你关注/被关注的人
+
+默认情况下，GoToSocial 会在你的公开网络资料上显示你的关注/粉丝数量，并允许其他人查看你关注的和关注你的人。这对于账户发现可能很有用。然而，出于隐私和安全原因，你可能希望隐藏这些信息，并隐藏其他账户的关注/粉丝清单。你可以通过勾选此框来做到这一点。
+
+勾选此框后，你的关注/粉丝数量将从你的公开网络资料中隐藏，其他人将无法浏览你的关注/粉丝清单。
+
+### 进阶
+
+#### 自定义 CSS
+
+如果实例管理员允许，自定义 CSS 可以让你进一步自定义账户在浏览器中的外观。
+
+如果此设置未被实例管理员启用，文本输入框将为只读状态，自定义 CSS 将不会应用。
+
+请参阅 [自定义 CSS](./custom_css.md) 页面，了解有关为账户编写自定义 CSS 的一些提示。
+
+!!! tip
+    你在此框中添加的任何自定义 CSS 都将在*选择主题之后*应用，因此你可以选择一个喜欢的预设主题，然后进行自己的调整！
+
+## 贴文
+
+### 贴文设置
+
+默认贴文语言设置允许你向其他用户声明你的贴文通常使用哪种语言。这对说其它语言（例如韩语）并希望过滤掉其他语言的贴文的用户很有帮助。
+
+默认贴文可见性设置允许你设置新贴文的默认可见性。当你通常发布公开或只对粉丝可见的贴文，但不想每次发贴时都设置隐私时会很有用。请记住，这只是默认设置：无论你在此处设置什么，仍然可以根据需要单独设置新贴文的隐私。有关贴文隐私设置的更多信息，请参阅[贴文页面](./posts.md)。
+
+默认贴文格式设置允许你选择在解析贴文时使用哪个文本解释器。
+
+plain（默认）设置提供标准贴文格式，类似于许多其他联邦宇宙服务端使用的格式。这非常适合一般目的的发布：你可以写简短的推特风格的贴文，或多段文章，插入链接，并使用用户名提及其他账户。
+
+markdown 设置表示你的贴文应被按 Markdown 格式解析，这是一种标记语言，提供更多选项来自定义贴文的布局和外观。有关 plain 和 markdown 贴文格式之间差异的更多信息，请参阅 [贴文页面](posts.md)。
+
+更新贴文设置后，请记得点击该部分底部的 `保存设置` 按钮以保存更改。
+
+### 默认互动规则
+
+通过此部分，你可以为新贴文设置每个可见级别的默认互动规则。这允许你精确控制他人如何与你的贴文互动。
+
+这使你能够做以下事情：
+
+- 创建只有你自己可以互动的贴文。
+- 创建仅粉丝/你关注的人可以互动的贴文。
+- 创建任何人都可以点赞或转发，但只有特定人可以回复的贴文。
+- 等等。
+
+例如，下图显示了一个公开可见性贴文的默认互动规则，允许任何人点赞或转发，但仅允许粉丝和你关注的人回复。
+
+![互动规则，图中显示“谁可以点赞” = “任何人”，“谁可以回复” = “粉丝”和“关注的人”，“谁可以转发” = “任何人”。](../public/user-settings-interaction-policy-1.png)
+
+请记住，互动规则不具备前向可追溯性。应用默认互动规则之后创建的贴文将默认使用新设置的规则，但在此之前创建的任何贴文将使用创建时的默认规则。
+
+无论在贴文上设置了什么规则，首先被考虑的仍是可见性设置和账户屏蔽情况。例如，如果你将某种类型的互动范围设置为“任何人”，这仍然会排除你屏蔽的账户，或你实例屏蔽的域名域下的账户。“任何人”在这种情况下基本上意味着“任何通常能看到贴文的人”。
+
+最后，请注意，无论为贴文设置了什么规则，贴文中提到的任何账户将**始终**能够回复该贴文。
+
+更新互动规则设置后，请记得点击该部分底部的 `保存规则` 按钮以保存更改。
+
+如果你想将所有规则重置为初始默认值，可以点击 `重置为默认值` 按钮。
+
+!!! danger
+    虽然 GoToSocial 尊重互动规则，但不能保证其他服务端软件也会这样做，即使你的实例禁止某些互动，其他服务器上的账户可能仍会向其粉丝发送（被禁止的）贴文回复和转发。
+    
+    随着更多 ActivityPub 服务端推出互动规则支持，这个问题有望减少，但在此期间，GoToSocial 只能在“尽力而为”范围内进行尝试，以根据你设定的规则限制与贴文的互动。
+
+## 电子邮箱和密码
+
+### 更改电子邮箱
+
+你可以使用面板的更改电子邮箱部分更改账户的电子邮箱地址。出于安全原因，你必须提供当前密码以验证更改。
+
+输入新电子邮箱地址，并点击“更改电子邮箱地址”后，必须打开新电子邮件地址的收件箱，并通过提供的链接确认地址。完成后，你的电子邮箱地址更改将被确认。
+
+!!! info
+    如果你的实例使用 OIDC 作为授权/身份提供商，你可以通过设置面板更改电子邮箱地址，但只会影响 GoToSocial 用于联系你的电子邮箱地址，而不会更改用于登录账户的电子邮箱地址。要更改此项，应联系你的 OIDC 提供商。
+
+### 更改密码
+
+你可以使用面板的更改密码部分为账户设置新密码。出于安全原因，你必须提供当前密码以验证更改。
+
+!!! info
+    如果你的实例使用 OIDC 作为授权/身份提供商，你将无法通过 GoToSocial 设置面板更改密码，此时应联系你的 OIDC 提供商。
+
+有关 GoToSocial 如何管理密码的更多信息，请参阅[密码管理文档](./password_management.md)。
+
+## 迁移
+
+在迁移部分，你可以管理与与账户别名、迁移到其他账户或从其他账户迁移相关的设置。
+
+有关移动账户的更多信息，请参阅[迁移文档](./migration.md)。
+
+## 导出和导入
+
+在导出和导入部分，你可以从 GoToSocial 账户导出数据或将数据导入账户。
+
+![导出/导入页面。](../public/user-settings-export-import.png)
+
+### 导出
+
+要导出你的关注、粉丝、账户列表、账户屏蔽列表或账户静音列表，你可以使用此页面上的按钮。
+
+所有导出都将以 Mastodon 导出格式兼容的 CSV 格式提供，因此如果有需要，可以将其导入 Mastodon 或另一个 GoToSocial 实例。
+
+### 导入
+
+你可以使用导入部分，将其他账户的数据导入到 GoToSocial 账户中，使用从其他账户导出的 CSV 文件。
+
+这在你已将账户[迁移](./migration.md)到 GoToSocial 账户，并希望保留在以前的账户上的关注列表和屏蔽列表时很有用。
+
+要将数据导入账户，首先点击“浏览”并选择从 Mastodon 或其他兼容实例导出的与 Mastodon 导出格式兼容的 CSV 文件。
+
+然后，使用下拉菜单选择通过 CSV 文件上传的数据类型。
+
+!!! warning
+    在选择“类型”时要小心，否则可能会意外封禁你计划关注的一堆账户，反之亦然！
+
+然后，选择是要**合并**新数据到 GoToSocial 账户中该类型的现有数据，还是要用 CSV 文件中包含的数据**覆盖**现有数据。
+
+如果选择**合并**，则 CSV 文件中包含的任何数据都将添加到现有数据中，而不会删除任何现有数据。
+
+例如，如果你的 GoToSocial 账户关注 `account1` 和 `account2`，并且正在上传一个包含 `account3` 和 `account4` 的关注 CSV 文件，并使用模式 **合并**，那么在导入结束时，你将关注 `account1`、`account2`、`account3` 和 `account4`。
+
+如果选择**覆盖**，则 CSV 文件中包含的任何数据将*替换*现有数据，删除 CSV 文件中未包含的条目。
+
+例如，如果你的 GoToSocial 账户关注 `account1` 和 `account2`，并上传一个包含 `account3` 和 `account4` 的关注 CSV 文件，并使用模式 **覆盖**，那么导入结束时，你将关注 `account3` 和 `account4`。你对 `account1` 和 `account2` 的关注将被移除。
+
+合并和覆盖操作都是幂等的，这通常意味着现有数据和 CSV 文件中的重复条目不会产生问题，如果需要重试导入，可以多次导入相同的数据。
+
+!!! info
+    由于各种原因，通过导入不可能一定会重新创建上传的 CSV 文件中的每个条目。例如，假设你试图导入包含 `example_account` 的关注 CSV，但 `example_account` 的实例已下线，或者它们的实例封禁了你的实例，或你的实例封禁了它们的实例等。在这种情况下，将无法创建对 `example_account` 的关注。