Skip to content

chinese: Update for stable #374

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

Closed
wants to merge 26 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
44413bc
Update Chinese Docs & Fix Typo
littlegolden Nov 5, 2020
247a021
Merge branch 'master' of https://github.com/flarum/docs
littlegolden Nov 6, 2020
cd79767
docs(Chinese): Updated instructions to fix permissions errors (#74b0b37)
littlegolden Nov 6, 2020
126c55d
Sync from flarum/master
littlegolden Jan 23, 2021
031a4cd
Update Chinese Docs
littlegolden Jan 23, 2021
baed37b
Merge remote-tracking branch 'upstream/master'
littlegolden Mar 12, 2021
10f86e3
i18n for Outdated Tip
littlegolden Mar 15, 2021
7190985
Merge remote-tracking branch 'upstream/master'
littlegolden Mar 16, 2021
b684f65
Sync English doc
littlegolden Mar 16, 2021
f151e63
Revert changes of directory structure
littlegolden Apr 3, 2021
ddb3b5c
优化翻译:admin.md
littlegolden Jul 12, 2021
870cd00
Delete appearance.md
littlegolden Jul 12, 2021
a08ed05
Update bugs.md
littlegolden Jul 12, 2021
9c9f14f
Update code-of-conduct.md
littlegolden Jul 12, 2021
4f5f3c3
Update config.md
littlegolden Jul 12, 2021
26fc71c
Update console.md
littlegolden Jul 12, 2021
07aca92
Update contributing.md
littlegolden Jul 12, 2021
0b7ec13
Update extensions.md
littlegolden Jul 12, 2021
085d4a6
Update faq.md
littlegolden Jul 12, 2021
f6bed91
Update install.md
littlegolden Jul 12, 2021
1496ebb
Update languages.md
littlegolden Jul 12, 2021
c246679
Update mail.md
littlegolden Jul 12, 2021
b87feda
Update README.md
littlegolden Jul 12, 2021
ece0587
Update releases.md
littlegolden Jul 12, 2021
815e6dd
Merge branch 'master' of https://github.com/flarum/docs
littlegolden Jul 12, 2021
a999a71
Merge branch 'flarum:master' into master
littlegolden Sep 23, 2021
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 changes: 4 additions & 4 deletions docs/zh/README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
# 关于 Flarum

Flarum 是一款非常简洁的开源论坛软件。它响应快速、简便易用,拥有打造一片成功的社区所需的所有功能
Flarum 是一款非常简洁的开源论坛软件。它响应快速、简便易用,拥有成功打造一个社区所需的全部功能

本用户指南将帮助您使用 Flarum 搭建自己的论坛,并教授您管理社区的基础知识。

## 定位

Flarum 的前身是 [esoTalk](https://github.com/esotalk/esoTalk) 和 [FluxBB](https://fluxbb.org),她生来就被设计如此:

* **快速、简单。** 不杂乱不臃肿,没有复杂的依赖关系。Flarum 使用 PHP 构建,因此很容易被部署。同时界面采用高性能 JavaScript 框架 [Mithril](https://mithril.js.org),因此占用空间很小
* **快速、简单。** 不杂乱不臃肿,没有复杂的依赖关系。Flarum 使用 PHP 构建,因此很容易被部署。同时,界面采用高性能 JavaScript 框架 [Mithril](https://mithril.js.org),系统占用空间小

* **漂亮、响应式。** 专为人设计的论坛程序。Flarum 经过精心设计,完美支持跨平台、开箱即用。
* **漂亮、响应式。** Flarum 是为你我精心设计的论坛程序。她完美支持跨平台,开箱即用。

* **强大、可扩展。** 您可以客制化、扩展或集成 Flarum 以满足您的社区需求。Flarum 拥有非常全面、强大的 [扩展 API](https://docs.flarum.org/extend/),她的架构及其灵活。
* **强大、可扩展。** 您可以自定义、扩展或将 Flarum 与其他程序集成以满足您的社区需求。Flarum 拥有非常全面、强大的 [扩展 API](https://docs.flarum.org/extend/),她的架构及其灵活。

* **免费、开源。** Flarum 基于 [MIT 协议](https://github.com/flarum/flarum/blob/master/LICENSE) 发布。
4 changes: 1 addition & 3 deletions docs/zh/admin.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
# 后台管理面板

Flarum 管理面板是一个用户友好的论坛管理界面。
它只对「管理」[组](permissions.md) 的用户开放。
要进入管理界面,只需点击屏幕右上方您的 **用户名**, 选择 **后台管理** 即可。
Flarum 后台管理面板是方便您管理论坛的地方。只有「管理」[组](permissions.md) 用户才可以访问这里。要进入管理面板,只需点击论坛右上方您的 **用户名**,选择 **后台管理** 即可。
3 changes: 0 additions & 3 deletions docs/zh/appearance.md

This file was deleted.

16 changes: 8 additions & 8 deletions docs/zh/bugs.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,23 @@

:::

我们很欢迎、也非常感谢您帮助我们测试 Flarum!编写一份良好的错误报告需要一些时间和精力,因此我们希望您能做到 *耐心解决问题*、*清晰描述问题*,如果可以的话,就继续往下看吧!
感谢您帮助我们测试 Flarum!编写一份清晰易懂的错误报告需要时间和精力,因此我们希望您 *定下心追踪问题*,并 *耐心描述问题*,如果可以的话,就继续往下看吧!

## 撞车

已经发现了一个 Bug?很好!这确实是个好消息——但您应该先查看一下相关情况,以免您在已知问题上浪费时间:
已经发现了一个 Bug?很好,这是个好消息!不过您应该先查看一下相关情况,以免您在已知问题上浪费时间:

- 搜索 [支持社区](https://discuss.flarum.org/t/support),看看这个 bug 是否已经被报告。
- 搜索我们的 [问题追踪器](https://github.com/flarum/core/issues),或许这个 bug 正在修复中。
- 搜索 [支持社区](https://discuss.flarum.org/t/support),看看这个 Bug 是否已经被报告。
- 搜索我们的 [问题追踪器](https://github.com/flarum/core/issues),或许这个 Bug 正在修复中。

在 *搜索一番* 后,如果无人报告该问题,欢迎您提交报告。如果是一个简单的小问题(例如单词拼写错了或图像故障)请直接跳到下一节,查看如何提交报告。如果您发现了比较严重的错误,或者明显的漏洞等,请您转到[《故障排查指南》](troubleshoot.md),按照那里的说明,收集尽可能多的信息。
在 *搜索一番* 后,如果无人报告该问题,欢迎提交报告。如果要报告的是一个简单的小问题(例如单词拼写错了或图裂了)请直接跳到本页下一章节,查看如何提交报告。如果您发现了比较严重的错误,或漏洞等,请您转到[《故障排查指南》](troubleshoot.md),按照那里的说明,收集尽可能多的信息。

## 报告

所有的 Issue 我们都是在 GitHub 上跟踪、处理的。请您在 [正确的仓库](https://github.com/flarum) 创建问题(Issue),新建 Issue 时,会自动生成问题报告的模板,请填写其中的所有内容。
我们使用 GitHub 跟踪、处理所有的问题。请您在 [正确的存储库](https://github.com/flarum) 创建问题,新建问题时,会自动生成问题报告的模板,请填写其中的所有内容。

如果可以,请检查最新版本的 Flarum 是否可以重现该问题。如果您使用的是预发行版本或开发版本,请指出您使用的特定版本。

请注意:问题报告使我们能够轻松地复现并修复错误,您可能需要阅读 [这篇文章](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html),了解如何撰写有效的错误报告。请您 **务必** 清晰描述重现问题的必要步骤。没有明确重现步骤的 Issue 将不会被标记/分类。如果一个标记为「需要验证(needs verification)」的 Issue 从被标记开始 5 天后,Issue 创建者仍没有反馈进一步的信息,该问题将被关闭。
请注意:问题报告使我们能够轻松地复现并修复错误,您可能需要阅读 [这篇文章](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html),了解如何撰写一份有效的错误报告。请您 **务必** 清晰描述重现问题的必要步骤。没有明确重现步骤的问题将不会被标记标签。如果一个标记为「需进一步验证(needs verification)」的问题从被标记开始 5 天后,问题创建者仍没有反馈进一步的信息,该问题将被关闭。

一旦您提交了报告,请您 *持续关注* 并耐心等待。我们可能会要求您提供细节或进一步说明。考虑到我们工作比较繁忙,可能需要一段时间才能回应您的报告
一旦您提交了报告,请您 *持续关注* 并耐心等待。我们可能会要求您提供细节或进一步说明。不过由于我们工作繁忙,可能需要一段时间才能回复,还请耐心等待
38 changes: 19 additions & 19 deletions docs/zh/code-of-conduct.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,50 +2,50 @@

### _欢迎光临 Flarum 社区!_

感谢加入! 我们对 Flarum 充满信心与激情,也很高兴认识同样的人。我们希望每位用户都能充分利用 Flarum 和 Flarum 社区,因此,请您阅读并遵守以下准则。无论您是使用我们的论坛,还是在 Discord、GitHub 上交流,亦或是在其他平台进行任何形式的交流,这些准则均适用。
感谢加入 Flarum 大家庭!我们对 Flarum 充满信心与激情,也很高兴认识同样的你们。我们希望每位用户都能充分利用 Flarum 和 Flarum 社区,因此,请您阅读并遵守以下准则。无论是使用我们的论坛,还是在 Discord、GitHub 亦或是其他平台上进行任何形式的交流,这些准则均适用。

### 重中之重,为人友善!

我们在这里探讨与 Flarum 有关的事情,并努力使她成长为一个更完美的程序。批判思维(当然,得通过合理的论证)是其中重要的一环。不过千万不要冲动,不要让事态演变成人身攻击,不要让消极情绪搞人心态。因此,请杜绝以下行为:
我们在这里探讨与 Flarum 有关的事情,并努力使之成长得更完美。批判思维(当然,得通过合理的论证)是其中重要的一环。不过,我们千万不要冲动,别让事态演变成人身攻击,也别让消极情绪祸乱人心。因此,请杜绝以下行为:

- 发表攻击性或辱骂性的、以及任何形式的仇恨词汇或言论;
- 发表旨在骚扰、冒充或诽谤他人的帖子;
- 毫无必要地删除已发布的帖子;
- 未经自然人同意,滥用或企图滥用、公开或企图公开他人的个人信息;
- 发表淫秽或色情内容(包括但不限于文字、链接或图片等);
- 发表淫秽或色情内容(包括但不限于文字、链接或图片);
- 发表垃圾信息、钓鱼贴,以及任何旨在破坏本网站的行为;
- 讨论盗版软件或类似事情。

*以上是所有管理员、版主采取行动的依据。* 如果您对其他成员有意见,请不要相互对峙。如果违规行为发生于论坛,请「举报」相关帖字,然后等待工作人员处理。无法举报的,请将违规情况报告到 [admin@flarum.org](mailto:admin@flarum.org)。
*以上是所有管理员、审阅人采取行动的依据。* 如果您对其他成员有意见,请不要与其对峙。如果违规行为发生于论坛,请「举报」相关帖子,然后等待工作人员处理。无法举报的,请将违规情况报告到邮箱 [admin@flarum.org](mailto:admin@flarum.org)。

我们的管理员和版主可以编辑或删除任何具有冒犯性或破坏性的内容。严重或屡次违规的用户,可能会被封禁账户。所以,你懂的,*待人友善一些*。😎
我们的管理员和审阅人可以编辑或删除任何具有冒犯性或破坏性的内容。屡次或严重违规的用户,可能会被封禁账户。所以,你懂的,*友善一些*。😎

### 提高自己的曝光度
### 提高帖子的曝光度

想发起一个新讨论?请务必先阅读我们的 [常见问题](faq.md),通过其中的相关链接充分了解这个项目。然后花一些时间浏览论坛,熟悉一下 [标签系统](https://discuss.flarum.org/tags),并搜索一些关键词,*可能您想讨论的早已被大家讨论过。*
想发起一个新讨论?请务必先阅读 [常见问题](faq.md),通过其中的相关链接充分了解整个项目。然后花些时间浏览论坛,熟悉 [标签系统](https://discuss.flarum.org/tags),并搜索一些关键词,*您想讨论的可能早已被大家讨论过。*

当您确定要发起一个讨论时,请牢记:

- 起个好标题!如果您的标题能简洁明了地阐明您要讨论的内容,您会得到更加理想的结果。
- 起个好标题!如果您的标题能简洁明了地阐明要讨论的内容,您会得到更加理想的结果。
- 标签要选对!这将增加帖子被及时阅读、回复的可能性。
- *不要* 刷帖!急于求成,往往适得其反。
- 如果没有预留多语言标签,*请仅使用英文发帖*,如果我们看不懂您在说什么,就没法帮您!
- 不要在帖子中签名或者添加小尾巴!个人资料的辨识度足够了
- 不要在帖子中签名或者添加小尾巴!个人资料的辨识度足矣

身为社区的一份子,每个人都该遵规守矩。可别让我们把用来了解您、帮助您解决问题、谈论 Flarum 的大好时光浪费在杂七杂八的琐碎事儿上,您说对吗?
身为社区的一份子,每个人都应该遵规守矩。可别让我们把用来了解您、帮助您解决问题、谈论 Flarum 的大好时光浪费在杂七杂八的琐碎事上,您说对吗?

### 提升您回帖的价值
### 提升回帖的价值

大家参与讨论,都是希望自己的观点或建议能被他人采纳、为他人提供帮助。既然如此,为什么不从一开始就让您的回帖值得一读呢
每个人参与讨论,都希望自己的观点或建议能被他人采纳、为他人提供帮助。既然如此,为什么不从一开始就让您的回帖值得一看呢

- 不要回复标题。花点时间 *看一下* 看看一楼在说什么,至少先 *速览一下* 后面的对话
- 不要只看标题。花点时间 *看一看* 一楼在说什么,至少 *速览一下* 他人的回复
- 问问自己,您的回复是否对讨论有帮助。如果没有,请斟酌斟酌。
- 避免仅仅为了同意某人就去顶帖,您可以使用「喜欢」按钮表达您的态度
- 不要刷帖。这里是论坛,不是聊天室。
- 如果您的回复偏题了,或者会导致整个讨论的方向发生转变,请考虑发起一个全新的讨论。
- 如果您只是想发表一些废话,作为测试,请到[「测试」](https://discuss.flarum.org/t/sandbox)标签中发表。
- 请确保您的回复能提供建设性的反馈和支持,以便建设一个惠及所有人的社区
- 不要仅仅 为了支持某人而顶帖,您可以使用「点赞」按钮表达对此人的喜欢
- 不要刷帖、盖楼或灌水。这里是论坛,不是聊天室。
- 如果您的回复跑题了,或者会导致整个讨论的方向发生转变,请考虑发起一个全新的讨论。
- 如果您只是想测试 Flarum,发一些废话,请到[「测试」](https://discuss.flarum.org/t/sandbox)标签中发表。
- 请确保您的回复能提供建设性的反馈和支持,以便参与建设一个普惠的社区

人都喜欢轻松的气氛,偶尔讲讲笑话或抖抖机灵,活跃气氛放松身心也是不错的,不过还是尽量别偏离讨论的中心主题吧
人人都喜欢轻松的氛围,偶尔讲讲笑话或抖抖机灵,活跃气氛、放松身心也是不错的。不过,为了效率,咱们还是多正经一点吧

> 感谢 Dominion 帮助我们制定了这些准则。
18 changes: 9 additions & 9 deletions docs/zh/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,34 +2,34 @@

除数据库外,只有一处配置是无法通过后台管理面板修改的,那就是位于 Flarum 安装根目录下的 `config.php` 文件。

虽然这个文件很小,但包含了 Flarum 安装时至关重要的信息
虽然这个文件很小,但包含了 Flarum 至关重要的信息

如果存在这个文件,Flarum 就知道它自己已经被安装了。
另外这个文件还为 Flarum 提供数据库信息等内容。
如果根目录有这个文件,Flarum 就知道它自己已经被安装了。另外这个文件还为 Flarum 提供数据库信息等内容。

下面是一个示例文件,我们来了解一下所有内容的含义
下面是一个示例文件,一起来了解一下这里的内容都有什么意思

```php
<?php return array (
'debug' => false, // 启用或禁用调试模式,用于排查问题
'offline' => false, // 启用或禁用网站维护模式。届时所有用户均无法访问网站,包括管理员。
'database' =>
array (
'driver' => 'mysql', // 数据库驱动,例如 MySQL, MariaDB ……
'host' => 'localhost', // 连接的主机,除非使用外部服务,否则多数情况下是 localhost
'database' => 'flarum', // 数据库实例名
'database' => 'flarum', // 数据库名
'username' => 'root', // 数据库用户名
'password' => '', // 数据库密码
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '', // 数据表的前缀,如果您和其他服务共享一个数据库,那么添加前缀会很有用
'port' => '3306', // 连接数据库的端口,MySQL 默认为 3306
'port' => '3306', // 数据库连接端口,MySQL 默认为 3306
'strict' => false,
),
'url' => 'https://flarum.localhost', // URL 配置,如果您改变了域名,您需要变更这个
'url' => 'https://flarum.localhost', // URL 配置,如果您改变了域名,您需要同时改变这个
'paths' =>
array (
'api' => 'api', // /api 跳转到 API
'admin' => 'admin', // /admin 跳转到 admin
'api' => 'api', // API 网址 /api
'admin' => 'admin', // 后台管理面板网址 /admin
),
);
```
35 changes: 30 additions & 5 deletions docs/zh/console.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 控制台

除了论坛后台的管理面板,Flarum 还提供了几个控制台命令,以帮助您通过终端管理论坛。
除了论坛后台管理面板,Flarum 还提供了几个控制台命令,以帮助您通过终端管理论坛。

使用步骤:

Expand Down Expand Up @@ -36,16 +36,41 @@

`php flarum cache:clear`

清楚后端 Flarum 缓存,包括已生成的 js/css,文本格式器缓存、翻译缓存。在您安装或卸载插件后,应当运行此命令。另外,在遇到问题的第一时间,请运行此命令看看能否解决问题。
清除后端 Flarum 缓存,包括已生成的 js/css,文本格式器缓存、翻译缓存。在您安装或卸载插件后,应当运行此命令。另外,在遇到问题的第一时间,请运行此命令看看能否解决问题。

### assets:publish
`php flarum assets:publish`

发布核心和扩展的资源文件(如编译的 JS/CSS、bootstrap 图标、logo 等)。当资源损坏,或者更换了 flarum-assets 磁盘的 [文件系统驱动(尚未翻译)](https://docs.flarum.org/extend/filesystem.html) 时,此命令会很有用。

### migrate

`php flarum migrate`

执行所有未完成的迁移。当安装或更新一个要修改数据库的插件时,会用到此命令。
执行所有未完成的迁移。当安装或更新了需要修改数据库的扩展程序时,会用到此命令。

### migrate:reset

`php flarum migrate:reset --extension [插件ID]`
`php flarum migrate:reset --extension [扩展程序_ID]`

重置一个扩展的所有迁移操作。此命令主要是由扩展程序开发者使用,但有时,如果您想要卸载一个扩展程序,并且需要清除其在数据库中的所有数据时,请在卸载扩展程序前使用此命令。请注意,该命令的被执行扩展程序必须处于已安装状态(启用或禁用皆可)。

### schedule:run

`php flarum schedule:run`

许多扩展程序会使用计划任务定期执行操作。如数据库清理、发布定时草稿、生成站点地图等。如果您启用的扩展程序有使用计划任务,请添加一个 [Cron 定时任务](https://ostechnix.com/a-beginners-guide-to-cron-jobs/) 来定期运行此命令。

```
* * * * * cd /Flarum-根目录路径 && php flarum schedule:run >> /dev/null 2>&1
```

此命令一般不应该手动运行。

注意,如果有些主机不允许您直接编辑 cron 配置,请咨询您的主机服务商如何设置 Cron 定时任务。

### schedule:list

`php flarum schedule:list`

重置指定插件的所有迁移。这个命令大多被插件开发人员使用,如果您要卸载插件,并且想要从数据库中清除该插件的所有数据,也会需要用它。请注意,该命令的被执行插件必须处于已安装状态(插件启用不启用都行)
此命令用于列出所有计划任务(详见 `schedule:run`),有助于您确认扩展程序是否成功注册所需的计划任务。但输出结果不能说明计划任务是否有成功执行或正在执行
Loading