Skip to content

Commit 694f70b

Browse files
lunnylunny
authored
Fix documentation ref (#24934)
Fix documentation ref
1 parent aa2b317 commit 694f70b

File tree

7 files changed

+48
-47
lines changed

7 files changed

+48
-47
lines changed

‎.github/workflows/pull-compliance-docs.yml

+1
Original file line numberDiff line numberDiff line change
@@ -22,3 +22,4 @@ jobs:
2222
node-version: 20
2323
- run: make deps-frontend
2424
- run: make lint-md
25+
- run: make docs # test if build could succeed

‎docs/content/doc/development/hacking-on-gitea.zh-cn.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -249,8 +249,8 @@ make swagger-check
249249
### 创建新的配置选项
250250

251251
创建新的配置选项时，将它们添加到 `modules/setting` 的对应文件。您应该将信息添加到 `custom/conf/app.ini`
252-
并到 <a href = '{{ < relref "doc/administration/config-cheat-sheet.en-us.md" > }}'>配置备忘单</a>
253-
在 `docs/content/doc/advanced/config-cheat-sheet.en-us.md` 中找到
252+
并到 <a href = '{{ < relref "doc/administration/config-cheat-sheet.zh-cn.md" > }}'>配置备忘单</a>
253+
在 `docs/content/doc/advanced/config-cheat-sheet.zh-cn.md` 中找到
254254

255255
### 更改Logo
256256

‎docs/content/doc/help/faq.zh-cn.md

+19-19
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ menu:
1919

2020
本页面包含一些常见问题和答案。
2121

22-
有关更多帮助资源，请查看所有[支持选项]({{< relref "doc/help/support.en-us.md" >}})。
22+
有关更多帮助资源，请查看所有[支持选项]({{< relref "doc/help/support.zh-cn.md" >}})。
2323

2424
**目录**
2525

@@ -45,7 +45,7 @@ menu:
4545

4646
要从Gogs迁移到Gitea：
4747

48-
- [Gogs版本0.9.146或更低]({{< relref "doc/installation/upgrade-from-gogs.en-us.md" >}})
48+
- [Gogs版本0.9.146或更低]({{< relref "doc/installation/upgrade-from-gogs.zh-cn.md" >}})
4949
- [Gogs版本0.11.46.0418](https://github.com/go-gitea/gitea/issues/4286)
5050

5151
要从GitHub迁移到Gitea，您可以使用Gitea内置的迁移表单。
@@ -92,7 +92,7 @@ https://github.com/loganinak/MigrateGitlabToGogs
9292

9393
有几个地方可能会导致显示不正确。
9494

95-
1. 如果使用反向代理，请确保按照[反向代理指南]({{< relref "doc/administration/reverse-proxies.en-us.md" >}})中的正确说明进行设置。
95+
1. 如果使用反向代理，请确保按照[反向代理指南]({{< relref "doc/administration/reverse-proxies.zh-cn.md" >}})中的正确说明进行设置。
9696
2. 确保在`app.ini`的`server`部分中正确设置了`ROOT_URL`。
9797

9898
如果某些克隆选项未显示（HTTP/S或SSH），可以在`app.ini中`
@@ -105,7 +105,7 @@ https://github.com/loganinak/MigrateGitlabToGogs
105105

106106
当反向代理限制文件上传大小时，会出现此错误。
107107

108-
有关使用nginx解决此问题，请参阅[反向代理指南]({{< relref "doc/administration/reverse-proxies.en-us.md" >}})。
108+
有关使用nginx解决此问题，请参阅[反向代理指南]({{< relref "doc/administration/reverse-proxies.zh-cn.md" >}})。
109109

110110
## 自定义模板无法加载或运行错误
111111

@@ -117,8 +117,8 @@ Gitea的自定义模板必须将其添加到正确的位置，否则Gitea将无
117117

118118
如果找不到，请尝试`echo $GITEA_CUSTOM`。
119119

120-
2. 如果仍然找不到，默认值可以被[计算]({{< relref "doc/help/faq.en-us.md#where-does-gitea-store-what-file" >}})
121-
3. 如果仍然找不到路径，则可以参考[自定义Gitea]({{< relref "doc/administration/customizing-gitea.en-us.md" >}})页面，将模板添加到正确的位置。
120+
2. 如果仍然找不到，默认值可以被[计算]({{< relref "doc/help/faq.zh-cn.md#where-does-gitea-store-what-file" >}})
121+
3. 如果仍然找不到路径，则可以参考[自定义Gitea]({{< relref "doc/administration/customizing-gitea.zh-cn.md" >}})页面，将模板添加到正确的位置。
122122

123123
## Gitea是否有"GitHub/GitLab Pages"功能？
124124

@@ -136,15 +136,15 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
136136

137137
## 设置日志记录
138138

139-
- [官方文档]({{< relref "doc/administration/logging-config.en-us.md" >}})
139+
- [官方文档]({{< relref "doc/administration/logging-config.zh-cn.md" >}})
140140

141141
## 什么是Swagger？
142142

143143
[Swagger](https://swagger.io/) 是Gitea用于其API文档的工具。
144144

145145
所有Gitea实例都有内置的API，无法完全禁用它。
146146
但是，您可以在app.ini的api部分将ENABLE_SWAGGER设置为false，以禁用其文档显示。
147-
有关更多信息，请参阅Gitea的[API文档]({{< relref "doc/development/api-usage.en-us.md" >}})。
147+
有关更多信息，请参阅Gitea的[API文档]({{< relref "doc/development/api-usage.zh-cn.md" >}})。
148148

149149
您可以在上查看最新的API（例如）<https://try.gitea.io/api/swagger>。
150150

@@ -159,7 +159,7 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
159159
1. 通过设置电子邮件域名的白名单或黑名单。
160160
2. 通过设置一些域名或者OpenID白名单（见下文）。
161161
3. 在您的`app.ini`中将`ENABLE_CAPTCHA`设置为`true`，并正确配置`RECAPTCHA_SECRET`和 `RECAPTCHA_SITEKEY`。
162-
4. 将`DISABLE_REGISTRATION`设置为`true`，并通过 [CLI]({{< relref "doc/administration/command-line.en-us.md" >}})、[API]({{< relref "doc/development/api-usage.en-us.md" >}}) 或 Gitea 的管理界面创建新用户。
162+
4. 将`DISABLE_REGISTRATION`设置为`true`，并通过 [CLI]({{< relref "doc/administration/command-line.zh-cn.md" >}})、[API]({{< relref "doc/development/api-usage.zh-cn.md" >}}) 或 Gitea 的管理界面创建新用户。
163163

164164
### 仅允许/阻止特定的电子邮件域名
165165

@@ -185,7 +185,7 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
185185

186186
### 启用 Fail2ban
187187

188-
使用 [Fail2Ban]({{< relref "doc/administration/fail2ban-setup.en-us.md" >}}) 监视并阻止基于日志模式的自动登录尝试或其他恶意行为。
188+
使用 [Fail2Ban]({{< relref "doc/administration/fail2ban-setup.zh-cn.md" >}}) 监视并阻止基于日志模式的自动登录尝试或其他恶意行为。
189189

190190
## 如何添加/使用自定义主题
191191

@@ -216,7 +216,7 @@ Gitea还提供了自己的SSH服务器，用于在SSHD不可用时使用。
216216

217217
请确保Gitea具有足够的权限来写入其主目录和数据目录。
218218

219-
参见[AppDataPath 和 RepoRootPath]({{< relref "doc/help/faq.en-us.md#where-does-gitea-store-what-file" >}})
219+
参见[AppDataPath 和 RepoRootPath]({{< relref "doc/help/faq.zh-cn.md#where-does-gitea-store-what-file" >}})
220220

221221
**适用于Arch用户的注意事项：**在撰写本文时，Arch软件包的systemd文件包含了以下行：
222222

@@ -338,24 +338,24 @@ error: failed to push some refs to '<GIT_REPO_URL>'
338338

339339
## 如何在启动 Gitea 之前创建用户
340340

341-
Gitea 提供了一个子命令`gitea migrate`来初始化数据库，然后您可以使用[管理 CLI 命令]({{< relref "doc/administration/command-line.en-us.md#admin" >}})像正常情况下添加用户。
341+
Gitea 提供了一个子命令`gitea migrate`来初始化数据库，然后您可以使用[管理 CLI 命令]({{< relref "doc/administration/command-line.zh-cn.md#admin" >}})像正常情况下添加用户。
342342

343343
## 如何启用密码重置
344344

345-
没有密码重置的设置。当配置了[邮件服务]({{< relref "doc/administration/email-setup.en-us.md" >}})时，密码重置将自动启用；否则将被禁用。
345+
没有密码重置的设置。当配置了[邮件服务]({{< relref "doc/administration/email-setup.zh-cn.md" >}})时，密码重置将自动启用；否则将被禁用。
346346

347347
## 如何更改用户的密码
348348

349349
- 作为管理员，您可以更改任何用户的密码（并可选择强制其在下次登录时更改密码）...
350350
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
351-
- 使用[管理 CLI 命令]({{< relref "doc/administration/command-line.en-us.md#admin" >}})。
351+
- 使用[管理 CLI 命令]({{< relref "doc/administration/command-line.zh-cn.md#admin" >}})。
352352

353-
请注意，大多数命令还需要一个[全局标志]({{< relref "doc/administration/command-line.en-us.- md#global-options" >}})来指向正确的配置。
353+
请注意，大多数命令还需要一个[全局标志]({{< relref "doc/administration/command-line.zh-cn.- md#global-options" >}})来指向正确的配置。
354354
- 作为**用户**，您可以更改密码...
355355
- 在您的账户的`设置 -> 账户`页面（此方法**需要**您知道当前密码）。
356356
- 使用`忘记密码`链接。
357357

358-
如果`忘记密码/账户恢复`页面被禁用，请联系管理员配置[邮件服务]({{< relref "doc/administration/email-setup.en-us.md" >}})。
358+
如果`忘记密码/账户恢复`页面被禁用，请联系管理员配置[邮件服务]({{< relref "doc/administration/email-setup.zh-cn.md" >}})。
359359

360360
## 为什么我的 Markdown 显示错误
361361

@@ -410,7 +410,7 @@ SystemD 上的标准输出默认会写入日志记录中。您可以尝试使用
410410

411411
类似地，Docker 上的标准输出可以使用`docker logs <container>`来查看。
412412

413-
要收集日志以进行帮助和问题报告，请参阅[支持选项]({{< relref "doc/help/support.en-us.md" >}})。
413+
要收集日志以进行帮助和问题报告，请参阅[支持选项]({{< relref "doc/help/support.zh-cn.md" >}})。
414414

415415
## 初始日志记录
416416

@@ -467,6 +467,6 @@ gitea doctor recreate-table
467467
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
468468
- 确保存在要采用存储库的用户/组织。
469469
- 作为管理员，转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
470-
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`]({{< relref "doc/administration/- config-cheat-sheet.en-us.md#repository" >}}) 获得类似的权限。
470+
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`]({{< relref "doc/administration/config-cheat-sheet.zh-cn.md#repository" >}}) 获得类似的权限。
471471
- 如果上述步骤都正确执行，您应该能够选择要采用的存储库。
472-
- 如果没有找到存储库，请启用[调试日志记录]({{< relref "doc/administration/config-cheat-sheet.en-us.- md#repository" >}})以检查是否有特定错误。
472+
- 如果没有找到存储库，请启用[调试日志记录]({{< relref "doc/administration/config-cheat-sheet.zh-cn.md#repository" >}})以检查是否有特定错误。

‎docs/content/doc/usage/actions/comparison.zh-cn.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ Gitea Actions默认不从GitHub下载Actions。
132132
这意味着`uses: actions/checkout@v3`将从[gitea.com/actions/checkout](https://gitea.com/actions/checkout)下载该Action，而不是[github.com/actions/checkout](https://github.com/actions/checkout)。
133133

134134
正如前面提到的，这是可配置的。
135-
如果您希望您的运行程序默认从GitHub或您自己的Gitea实例下载动作，您可以通过设置`[actions].DEFAULT_ACTIONS_URL`进行配置。请参阅[配置备忘单]({{< relref "doc/administration/config-cheat-sheet.en-us.md#actions-actions" >}})。
135+
如果您希望您的运行程序默认从GitHub或您自己的Gitea实例下载动作，您可以通过设置`[actions].DEFAULT_ACTIONS_URL`进行配置。请参阅[配置备忘单]({{< relref "doc/administration/config-cheat-sheet.zh-cn.md#actions-actions" >}})。
136136

137137
### 上下文可用性
138138

‎docs/content/doc/usage/actions/quickstart.zh-cn.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ menu:
2424
## 设置Gitea
2525

2626
首先，您需要一个Gitea实例。
27-
您可以按照[文档]({{< relref "doc/installation/from-package.en-us.md" >}}) 来设置一个新实例或升级现有实例。
27+
您可以按照[文档]({{< relref "doc/installation/from-package.zh-cn.md" >}}) 来设置一个新实例或升级现有实例。
2828
无论您如何安装或运行Gitea，只要版本号是1.19.0或更高即可。
2929

3030
默认情况下，Actions是禁用的，因此您需要将以下内容添加到配置文件中以启用它：
@@ -34,7 +34,7 @@ menu:
3434
ENABLED=true
3535
```
3636

37-
如果您想了解更多信息或在配置过程中遇到任何问题，请参考[配置速查表]({{< relref "doc/administration/config-cheat-sheet.en-us.md#actions-actions" >}})。
37+
如果您想了解更多信息或在配置过程中遇到任何问题，请参考[配置速查表]({{< relref "doc/administration/config-cheat-sheet.zh-cn.md#actions-actions" >}})。
3838

3939
### 设置Runner
4040

@@ -128,7 +128,7 @@ jobs:
128128
请注意，演示文件中包含一些表情符号。
129129
请确保您的数据库支持它们，特别是在使用MySQL时。
130130
如果字符集不是`utf8mb4，将出现错误，例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`。
131-
有关更多信息，请参阅[数据库准备工作]({{< relref "doc/installation/database-preparation.en-us.md#mysql" >}})。
131+
有关更多信息，请参阅[数据库准备工作]({{< relref "doc/installation/database-preparation.zh-cn.md#mysql" >}})。
132132

133133
或者，您可以从演示文件中删除所有表情符号，然后再尝试一次。
134134

‎docs/content/doc/usage/packages/alpine.zh-cn.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ curl --user your_username:your_password_or_token \
8080
https://gitea.example.com/api/packages/testuser/alpine/v3.17/main
8181
```
8282

83-
如果您使用的是双重身份验证或 OAuth，请使用[个人访问令牌]({{< relref "doc/development/api-usage.en-us.md#authentication" >}})代替密码。
83+
如果您使用的是双重身份验证或 OAuth，请使用[个人访问令牌]({{< relref "doc/development/api-usage.zh-cn.md#authentication" >}})代替密码。
8484
您不能将具有相同名称的文件两次发布到一个包中。您必须首先删除现有的包文件。
8585

8686
服务器将以以下的 HTTP 状态码响应：

‎docs/content/doc/usage/packages/overview.zh-cn.md

+21-21
Original file line numberDiff line numberDiff line change
@@ -27,27 +27,27 @@ menu:
2727

2828
| Name | Language | Package client |
2929
| ------------------------------------------------------------------- | ---------- | ------------------------- |
30-
| [Alpine]({{< relref "doc/usage/packages/alpine.en-us.md" >}}) | - | `apk` |
31-
| [Cargo]({{< relref "doc/usage/packages/cargo.en-us.md" >}}) | Rust | `cargo` |
32-
| [Chef]({{< relref "doc/usage/packages/chef.en-us.md" >}}) | - | `knife` |
33-
| [Composer]({{< relref "doc/usage/packages/composer.en-us.md" >}}) | PHP | `composer` |
34-
| [Conan]({{< relref "doc/usage/packages/conan.en-us.md" >}}) | C++ | `conan` |
35-
| [Conda]({{< relref "doc/usage/packages/conda.en-us.md" >}}) | - | `conda` |
36-
| [Container]({{< relref "doc/usage/packages/container.en-us.md" >}}) | - | 任何符合OCI规范的客户端 |
37-
| [CRAN]({{< relref "doc/usage/packages/cran.en-us.md" >}}) | R | - |
38-
| [Debian]({{< relref "doc/usage/packages/debian.en-us.md" >}}) | - | `apt` |
39-
| [Generic]({{< relref "doc/usage/packages/generic.en-us.md" >}}) | - | 任何HTTP客户端 |
40-
| [Go]({{< relref "doc/usage/packages/go.en-us.md" >}}) | Go | `go` |
41-
| [Helm]({{< relref "doc/usage/packages/helm.en-us.md" >}}) | - | 任何HTTP客户端, `cm-push` |
42-
| [Maven]({{< relref "doc/usage/packages/maven.en-us.md" >}}) | Java | `mvn`, `gradle` |
43-
| [npm]({{< relref "doc/usage/packages/npm.en-us.md" >}}) | JavaScript | `npm`, `yarn`, `pnpm` |
44-
| [NuGet]({{< relref "doc/usage/packages/nuget.en-us.md" >}}) | .NET | `nuget` |
45-
| [Pub]({{< relref "doc/usage/packages/pub.en-us.md" >}}) | Dart | `dart`, `flutter` |
46-
| [PyPI]({{< relref "doc/usage/packages/pypi.en-us.md" >}}) | Python | `pip`, `twine` |
47-
| [RPM]({{< relref "doc/usage/packages/rpm.en-us.md" >}}) | - | `yum`, `dnf` |
48-
| [RubyGems]({{< relref "doc/usage/packages/rubygems.en-us.md" >}}) | Ruby | `gem`, `Bundler` |
49-
| [Swift]({{< relref "doc/usage/packages/rubygems.en-us.md" >}}) | Swift | `swift` |
50-
| [Vagrant]({{< relref "doc/usage/packages/vagrant.en-us.md" >}}) | - | `vagrant` |
30+
| [Alpine]({{< relref "doc/usage/packages/alpine.zh-cn.md" >}}) | - | `apk` |
31+
| [Cargo]({{< relref "doc/usage/packages/cargo.zh-cn.md" >}}) | Rust | `cargo` |
32+
| [Chef]({{< relref "doc/usage/packages/chef.zh-cn.md" >}}) | - | `knife` |
33+
| [Composer]({{< relref "doc/usage/packages/composer.zh-cn.md" >}}) | PHP | `composer` |
34+
| [Conan]({{< relref "doc/usage/packages/conan.zh-cn.md" >}}) | C++ | `conan` |
35+
| [Conda]({{< relref "doc/usage/packages/conda.zh-cn.md" >}}) | - | `conda` |
36+
| [Container]({{< relref "doc/usage/packages/container.zh-cn.md" >}}) | - | 任何符合OCI规范的客户端 |
37+
| [CRAN]({{< relref "doc/usage/packages/cran.zh-cn.md" >}}) | R | - |
38+
| [Debian]({{< relref "doc/usage/packages/debian.zh-cn.md" >}}) | - | `apt` |
39+
| [Generic]({{< relref "doc/usage/packages/generic.zh-cn.md" >}}) | - | 任何HTTP客户端 |
40+
| [Go]({{< relref "doc/usage/packages/go.zh-cn.md" >}}) | Go | `go` |
41+
| [Helm]({{< relref "doc/usage/packages/helm.zh-cn.md" >}}) | - | 任何HTTP客户端, `cm-push` |
42+
| [Maven]({{< relref "doc/usage/packages/maven.zh-cn.md" >}}) | Java | `mvn`, `gradle` |
43+
| [npm]({{< relref "doc/usage/packages/npm.zh-cn.md" >}}) | JavaScript | `npm`, `yarn`, `pnpm` |
44+
| [NuGet]({{< relref "doc/usage/packages/nuget.zh-cn.md" >}}) | .NET | `nuget` |
45+
| [Pub]({{< relref "doc/usage/packages/pub.zh-cn.md" >}}) | Dart | `dart`, `flutter` |
46+
| [PyPI]({{< relref "doc/usage/packages/pypi.zh-cn.md" >}}) | Python | `pip`, `twine` |
47+
| [RPM]({{< relref "doc/usage/packages/rpm.zh-cn.md" >}}) | - | `yum`, `dnf` |
48+
| [RubyGems]({{< relref "doc/usage/packages/rubygems.zh-cn.md" >}}) | Ruby | `gem`, `Bundler` |
49+
| [Swift]({{< relref "doc/usage/packages/rubygems.zh-cn.md" >}}) | Swift | `swift` |
50+
| [Vagrant]({{< relref "doc/usage/packages/vagrant.zh-cn.md" >}}) | - | `vagrant` |
5151

5252
**以下段落仅适用于未全局禁用软件包的情况！**
5353

0 commit comments

Comments
 (0)