0
0
mirror of https://gitea.com/gitea/docs.git synced 2025-05-24 23:40:02 +00:00

Fix more links and problems (#3)

Reviewed-on: https://gitea.com/gitea/docs/pulls/3
This commit is contained in:
Lunny Xiao
2024-06-14 08:53:10 +00:00
parent 9a8396aa29
commit ab2cdde840
45 changed files with 83 additions and 174 deletions

3
.gitignore vendored

@ -20,5 +20,4 @@ yarn-debug.log*
yarn-error.log*
.tmp/
# Static files other than those explicitly tracked
/static
awesome.md

@ -38,6 +38,10 @@ build:
serve: prepare-docs
npm run start
.PHONY: serve-zh
serve-zh: prepare-docs
npm run start -- --locale zh-cn
.PHONY: clean
clean:
rm -rf .tmp

@ -1,13 +0,0 @@
---
date: "2023-04-27T14:00:00+08:00"
title: "Actions"
slug: "actions"
sidebar_position: 36
toc: false
draft: false
menu:
sidebar:
name: "Usage - Actions"
sidebar_position: 31
identifier: "actions"
---

@ -1,10 +1,7 @@
---
date: "2016-11-08T16:00:00+02:00"
title: "Documentation"
slug: /
sidebar_position: 10
toc: false
draft: false
---
# What is Gitea?

@ -1,13 +0,0 @@
---
date: "2016-12-27T16:00:00+02:00"
title: "Packages"
slug: "packages"
sidebar_position: 35
toc: false
draft: false
menu:
sidebar:
name: "Usage - Packages"
sidebar_position: 30
identifier: "packages"
---

@ -169,6 +169,9 @@ const config = {
themeConfig:
/** @type {import('@docusaurus/preset-classic').ThemeConfig} */
({
metadata: [
{name: 'keywords', content: 'gitea, git, devops, actions, packages, documentation, self-hosted, open-source, version control, gitlab, github'}
],
colorMode: {
defaultMode: 'light',
disableSwitch: false,

@ -1,6 +1,5 @@
---
date: "2017-04-15T14:56:00+02:00"
title: "自定义 Gitea 配置"
slug: "customizing-gitea"
sidebar_position: 100
toc: false
@ -88,4 +87,4 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
内置主题是“gitea-light”、“gitea-dark”和“gitea-auto”自动适应操作系统设置
默认主题可以通过 `app.ini` 的 [ui](../administration/config-cheat-sheet.md#ui-ui) 部分中的 `DEFAULT_THEME` 进行更改。
默认主题可以通过 `app.ini` 的 [ui](../administration/config-cheat-sheet.md#界面) 部分中的 `DEFAULT_THEME` 进行更改。

@ -91,4 +91,4 @@ REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
`REVERSE_PROXY_LIMIT` 限制反向代理服务器的层数,设置为 `0` 表示不使用这些标头。
`REVERSE_PROXY_TRUSTED_PROXIES` 表示受信任的反向代理服务器网络地址,
经过该网络地址转发来的流量会经过解析 `X-Real-IP` 头部得到真实客户端地址。
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#security-security)
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#安全性)

@ -20,7 +20,7 @@ menu:
在启用HTTPS之前确保您拥有有效的SSL/TLS证书。
建议在测试和评估情况下使用自签名证书,请运行 `gitea cert --host [HOST]` 以生成自签名证书
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](../administration/reverse-proxies.md)。
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](reverse-proxies.md)。
要使用Gitea内置HTTPS支持您必须编辑`app.ini`文件。
@ -86,7 +86,7 @@ ACME_EMAIL=email@example.com
## 使用反向代理服务器
按照 [reverse proxy guide](../administration/reverse-proxies.md) 的规则设置你的反向代理服务器
按照 [reverse proxy guide](reverse-proxies.md) 的规则设置你的反向代理服务器
然后,按照下面的向导启用 HTTPS

@ -112,7 +112,7 @@ Gitea的自定义模板必须将其添加到正确的位置否则Gitea将无
如果找不到,请尝试`echo $GITEA_CUSTOM`
2. 如果仍然找不到,默认值可以被[计算](help/faq.md#where-does-gitea-store-what-file)
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径,则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
## Gitea是否有"GitHub/GitLab Pages"功能?
@ -200,7 +200,7 @@ Gitea还提供了自己的SSH服务器用于在SSHD不可用时使用。
请确保Gitea具有足够的权限来写入其主目录和数据目录。
参见[AppDataPath 和 RepoRootPath](help/faq.md#where-does-gitea-store-what-file)
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
**适用于Arch用户的注意事项**在撰写本文时Arch软件包的systemd文件包含了以下行
@ -336,7 +336,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#global-options)来指向正确的配置。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
- 作为**用户**,您可以更改密码...
- 在您的账户的`设置 -> 账户`页面(此方法**需要**您知道当前密码)。
- 使用`忘记密码`链接。
@ -433,6 +433,6 @@ gitea doctor recreate-table
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
- 确保存在要采用存储库的用户/组织。
- 作为管理员,转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#repository-repository) 获得类似的权限。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的权限。
- 如果上述步骤都正确执行,您应该能够选择要采用的存储库。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#repository-repository)以检查是否有特定错误。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以检查是否有特定错误。

@ -128,7 +128,7 @@ jobs:
请注意,演示文件中包含一些表情符号。
请确保您的数据库支持它们特别是在使用MySQL时。
如果字符集不是`utf8mb4`,将出现错误,例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`
有关更多信息,请参阅[数据库准备工作](installation/database-preparation.md#mysql)。
有关更多信息,请参阅[数据库准备工作](../../installation/database-preparation.md#mysqlmariadb)。
或者,您可以从演示文件中删除所有表情符号,然后再尝试一次。

@ -49,7 +49,7 @@ git push -o repo.private=false -u origin main
## 启用推送创建
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#repository-repository) 中了解有关这两个选项的更多信息。
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。
## 使用推送创建

@ -85,4 +85,4 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
## 更改 Gitea 外观
Gitea 目前由两种内置主题,分别为默认 `gitea` 主题和深色主题 `arc-green`,您可以通过修改
`app.ini` [ui](https://docs.gitea.io/en-us/config-cheat-sheet/#ui-ui) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。
`app.ini` [ui](https://docs.gitea.io/en-us/config-cheat-sheet/#界面) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。

@ -89,4 +89,4 @@ REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
`REVERSE_PROXY_LIMIT` 限制反向代理服务器的层数,设置为 `0` 表示不使用这些标头。
`REVERSE_PROXY_TRUSTED_PROXIES` 表示受信任的反向代理服务器网络地址,
经过该网络地址转发来的流量会经过解析 `X-Real-IP` 头部得到真实客户端地址。
(参考 [configuration cheat sheet](https://docs.gitea.io/en-us/config-cheat-sheet/#security-security)
(参考 [configuration cheat sheet](https://docs.gitea.io/en-us/config-cheat-sheet/#安全性)

@ -1,10 +1,7 @@
---
date: "2023-05-25T16:00:00+02:00"
title: "常见问题"
slug: "faq"
sidebar_position: 5
toc: false
draft: false
aliases:
- /zh-cn/faq
menu:
@ -15,11 +12,11 @@ menu:
identifier: "faq"
---
# 常见问题 <!-- omit in toc -->
# 常见问题
本页面包含一些常见问题和答案。
有关更多帮助资源,请查看所有[支持选项](help/seek-help.md)。
有关更多帮助资源,请查看所有[支持选项](seek-help.md)。
## 1.x和1.x.x下载之间的区别
@ -113,7 +110,7 @@ Gitea的自定义模板必须将其添加到正确的位置否则Gitea将无
如果找不到,请尝试`echo $GITEA_CUSTOM`
2. 如果仍然找不到,默认值可以被[计算](help/faq.md#where-does-gitea-store-what-file)
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径,则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
## Gitea是否有"GitHub/GitLab Pages"功能?
@ -155,7 +152,7 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
1. 通过设置电子邮件域名的白名单或黑名单。
2. 通过设置一些域名或者OpenID白名单见下文
3. 在您的`app.ini`中将`ENABLE_CAPTCHA`设置为`true`,并正确配置`RECAPTCHA_SECRET``RECAPTCHA_SITEKEY`
4.`DISABLE_REGISTRATION`设置为`true`,并通过 [CLI](../administration/command-line.md)、[API](development/api-usage.md) 或 Gitea 的管理界面创建新用户。
4.`DISABLE_REGISTRATION`设置为`true`,并通过 [CLI](../administration/command-line.md)、[API](../development/api-usage.md) 或 Gitea 的管理界面创建新用户。
### 仅允许/阻止特定的电子邮件域名
@ -212,7 +209,7 @@ Gitea还提供了自己的SSH服务器用于在SSHD不可用时使用。
请确保Gitea具有足够的权限来写入其主目录和数据目录。
参见[AppDataPath 和 RepoRootPath](help/faq.md#where-does-gitea-store-what-file)
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
**适用于Arch用户的注意事项**在撰写本文时Arch软件包的systemd文件包含了以下行
@ -244,7 +241,7 @@ Gitea还提供了自己的SSH服务器用于在SSHD不可用时使用。
如果连接成功,您应该会收到以下错误消息:
```
```bash
Hi there, You've successfully authenticated, but Gitea does not provide shell access.
If this is unexpected, please log in with password and setup Gitea under another user.
```
@ -256,7 +253,7 @@ If this is unexpected, please log in with password and setup Gitea under another
### SSH 常见错误
```
```bash
Permission denied (publickey).
fatal: Could not read from remote repository.
```
@ -284,7 +281,7 @@ fatal: Could not read from remote repository.
认证成功,但是其他设置导致 SSH 无法访问正确的
存储库。
```
```bash
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
@ -306,13 +303,13 @@ and the repository exists.
- 推送标签到存储库:
```
```bash
git push --tags
```
- 在 Gitea 中重新同步所有存储库的标签:
```
```bash
gitea admin repo-sync-releases
```
@ -320,7 +317,7 @@ gitea admin repo-sync-releases
针对涉及 LFS 数据上传的问题
```
```bash
batch response: Authentication required: Authorization error: <GITEA_LFS_URL>/info/lfs/objects/batch
Check that you have proper access to the repository
error: failed to push some refs to '<GIT_REPO_URL>'
@ -346,7 +343,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#global-options)来指向正确的配置。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
- 作为**用户**,您可以更改密码...
- 在您的账户的`设置 -> 账户`页面(此方法**需要**您知道当前密码)。
- 使用`忘记密码`链接。
@ -367,18 +364,18 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
> `ORM engine initialization failed: migrate: do migrate: Error: 1118: Row size too large...`
请运行`gitea convert`或对数据库中的每个表运行`ALTER TABLE table_name ROW_FORMAT=dynamic;`
请运行 `gitea convert` 或对数据库中的每个表运行 `ALTER TABLE table_name ROW_FORMAT=dynamic;`
潜在问题是默认行格式分配给每个表的索引空间
太小。Gitea 要求其表的`ROWFORMAT``DYNAMIC`
太小。Gitea 要求其表的 `ROWFORMAT``DYNAMIC`
如果收到包含`Error 1071: Specified key was too long; max key length is 1000 bytes...`
如果收到包含 `Error 1071: Specified key was too long; max key length is 1000 bytes...`
的错误行,则表示您正在尝试在使用 ISAM 引擎的表上运行 Gitea。尽管在先前版本的 Gitea 中可能是凑巧能够工作的,但它从未得到官方支持,
您必须使用 InnoDB。您应该对数据库中的每个表运行`ALTER TABLE table_name ENGINE=InnoDB;`
如果您使用的是 MySQL 5另一个可能的修复方法是
```mysql
```SQL
SET GLOBAL innodb_file_format=Barracuda;
SET GLOBAL innodb_file_per_table=1;
SET GLOBAL innodb_large_prefix=1;
@ -390,7 +387,7 @@ SET GLOBAL innodb_large_prefix=1;
他们创建了一个名为 `utf8mb4`的字符集和校对规则,允许存储 Emoji但使用
utf8 字符集的表和连接将不会使用它。
请运行 `gitea convert` 或对数据库运行`ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
请运行 `gitea convert` 或对数据库运行 `ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
并对每个表运行
`ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
@ -398,7 +395,7 @@ utf8 字符集的表和连接将不会使用它。
## 为什么 Emoji 只显示占位符或单色图像
Gitea 需要系统或浏览器安装其中一个受支持的 Emoji 字体,例如 Apple Color EmojiSegoe UI EmojiSegoe UI SymbolNoto Color Emoji 和 Twemoji Mozilla。通常操作系统应该已经提供了其中一个字体但特别是在 Linux 上,可能需要手动安装它们。
Gitea 需要系统或浏览器安装其中一个受支持的 Emoji 字体,例如 `Apple Color Emoji``Segoe UI Emoji``Segoe UI Symbol``Noto Color Emoji``Twemoji Mozilla`。通常,操作系统应该已经提供了其中一个字体,但特别是在 Linux 上,可能需要手动安装它们。
## SystemD 和 Docker 上的标准输出日志
@ -406,7 +403,7 @@ SystemD 上的标准输出默认会写入日志记录中。您可以尝试使用
类似地Docker 上的标准输出可以使用`docker logs <container>`来查看。
要收集日志以进行帮助和问题报告,请参阅[支持选项](help/seek-help.md)。
要收集日志以进行帮助和问题报告,请参阅[支持选项](seek-help.md)。
## 初始日志记录
@ -423,13 +420,13 @@ SystemD 上的标准输出默认会写入日志记录中。您可以尝试使用
有时,在迁移过程中,旧列和默认值可能在数据库架构中保持不变。
这可能会导致警告,例如:
```
```bash
2020/08/02 11:32:29 ...rm/session_schema.go:360:Sync2() [W] Table user Column keep_activity_private db default is , struct default is 0
```
可以安全地忽略这些警告,但您可以通过让 Gitea 重新创建这些表来停止这些警告,使用以下命令:
```
```bash
gitea doctor recreate-table user
```
@ -438,13 +435,13 @@ gitea doctor recreate-table user
您可以使用以下命令要求 Gitea 重新创建多个表:
```
```bash
gitea doctor recreate-table table1 table2 ...
```
如果您希望 Gitea 重新创建所有表,请使用以下命令:
```
```bash
gitea doctor recreate-table
```
@ -463,6 +460,6 @@ gitea doctor recreate-table
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
- 确保存在要采用存储库的用户/组织。
- 作为管理员,转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#repository-repository) 获得类似的权限。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的权限。
- 如果上述步骤都正确执行,您应该能够选择要采用的存储库。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#repository-repository)以检查是否有特定错误。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以检查是否有特定错误。

@ -1,6 +1,5 @@
---
date: "2017-01-20T15:00:00+08:00"
title: "需要帮助"
slug: "seek-help"
sidebar_position: 20
toc: false
@ -13,7 +12,7 @@ menu:
identifier: "seek-help"
---
## 需要帮助?
# 需要帮助
如果您在使用或者开发过程中遇到问题,请到以下渠道咨询:

@ -155,6 +155,6 @@ GITEA_WORK_DIR=/var/lib/gitea/ /usr/local/bin/gitea web -c /etc/gitea/app.ini
## 排查故障
> 更多经验总结,请参考英文版 [Troubleshooting](/en-us/install-from-binary/#troubleshooting)
> 更多经验总结,请参考英文版 [Troubleshooting](/en-us/install-from-binary.md#troubleshooting)
如果从本页中没有找到你需要的内容,请访问 [帮助页面](help/seek-help.md)

@ -49,7 +49,7 @@ git push -o repo.private=false -u origin main
## 启用推送创建
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#repository-repository) 中了解有关这两个选项的更多信息。
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。
## 使用推送创建

@ -87,4 +87,4 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
## 更改 Gitea 外观
Gitea 目前由两种内置主题,分别为默认 `gitea` 主题和深色主题 `arc-green`,您可以通过修改
`app.ini` [ui](../administration/config-cheat-sheet.md#ui-ui) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。
`app.ini` [ui](../administration/config-cheat-sheet.md#界面) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。

@ -91,4 +91,4 @@ REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
`REVERSE_PROXY_LIMIT` 限制反向代理服务器的层数,设置为 `0` 表示不使用这些标头。
`REVERSE_PROXY_TRUSTED_PROXIES` 表示受信任的反向代理服务器网络地址,
经过该网络地址转发来的流量会经过解析 `X-Real-IP` 头部得到真实客户端地址。
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#security-security)
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#安全性)

@ -1,6 +1,5 @@
---
date: "2023-04-09T11:00:00+02:00"
title: "HTTPS配置"
slug: "https-setup"
sidebar_position: 12
toc: false
@ -13,14 +12,14 @@ menu:
identifier: "https-setup"
---
# HTTPS setup to encrypt connections to Gitea
# HTTPS配置
## 使用内置服务器
在启用HTTPS之前确保您拥有有效的SSL/TLS证书。
建议在测试和评估情况下使用自签名证书,请运行 `gitea cert --host [HOST]` 以生成自签名证书
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](../administration/reverse-proxies.md)。
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](reverse-proxies.md)。
要使用Gitea内置HTTPS支持您必须编辑`app.ini`文件。
@ -86,7 +85,7 @@ ACME_EMAIL=email@example.com
## 使用反向代理服务器
按照 [reverse proxy guide](../administration/reverse-proxies.md) 的规则设置你的反向代理服务器
按照 [反向代理指南](reverse-proxies.md) 的规则设置你的反向代理服务器
然后,按照下面的向导启用 HTTPS

@ -113,7 +113,7 @@ Gitea的自定义模板必须将其添加到正确的位置否则Gitea将无
如果找不到,请尝试`echo $GITEA_CUSTOM`
2. 如果仍然找不到,默认值可以被[计算](help/faq.md#where-does-gitea-store-what-file)
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径,则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
## Gitea是否有"GitHub/GitLab Pages"功能?
@ -212,7 +212,7 @@ Gitea还提供了自己的SSH服务器用于在SSHD不可用时使用。
请确保Gitea具有足够的权限来写入其主目录和数据目录。
参见[AppDataPath 和 RepoRootPath](help/faq.md#where-does-gitea-store-what-file)
参见[AppDataPath 和 RepoRootPath](help/faq.md#Gitea存储文件的位置)
**适用于Arch用户的注意事项**在撰写本文时Arch软件包的systemd文件包含了以下行
@ -346,7 +346,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#global-options)来指向正确的配置。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
- 作为**用户**,您可以更改密码...
- 在您的账户的`设置 -> 账户`页面(此方法**需要**您知道当前密码)。
- 使用`忘记密码`链接。
@ -463,6 +463,6 @@ gitea doctor recreate-table
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
- 确保存在要采用存储库的用户/组织。
- 作为管理员,转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#repository-repository) 获得类似的权限。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的权限。
- 如果上述步骤都正确执行,您应该能够选择要采用的存储库。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#repository-repository)以检查是否有特定错误。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以检查是否有特定错误。

@ -124,7 +124,7 @@ jobs:
请注意,演示文件中包含一些表情符号。
请确保您的数据库支持它们特别是在使用MySQL时。
如果字符集不是`utf8mb4`,将出现错误,例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`
有关更多信息,请参阅[数据库准备工作](installation/database-preparation.md#mysql)。
有关更多信息,请参阅[数据库准备工作](../../installation/database-preparation.md#mysqlmariadb)。
或者,您可以从演示文件中删除所有表情符号,然后再尝试一次。

@ -49,7 +49,7 @@ git push -o repo.private=false -u origin main
## 启用推送创建
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#repository-repository) 中了解有关这两个选项的更多信息。
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。
## 使用推送创建

@ -87,4 +87,4 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
## 更改 Gitea 外观
Gitea 目前由两种内置主题,分别为默认 `gitea` 主题和深色主题 `arc-green`,您可以通过修改
`app.ini` [ui](../administration/config-cheat-sheet.md#ui-ui) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。
`app.ini` [ui](../administration/config-cheat-sheet.md#界面) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。

@ -91,4 +91,4 @@ REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
`REVERSE_PROXY_LIMIT` 限制反向代理服务器的层数,设置为 `0` 表示不使用这些标头。
`REVERSE_PROXY_TRUSTED_PROXIES` 表示受信任的反向代理服务器网络地址,
经过该网络地址转发来的流量会经过解析 `X-Real-IP` 头部得到真实客户端地址。
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#security-security)
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#安全性)

@ -20,7 +20,7 @@ menu:
在启用HTTPS之前确保您拥有有效的SSL/TLS证书。
建议在测试和评估情况下使用自签名证书,请运行 `gitea cert --host [HOST]` 以生成自签名证书
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](../administration/reverse-proxies.md)。
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](reverse-proxies.md)。
要使用Gitea内置HTTPS支持您必须编辑`app.ini`文件。
@ -86,7 +86,7 @@ ACME_EMAIL=email@example.com
## 使用反向代理服务器
按照 [reverse proxy guide](../administration/reverse-proxies.md) 的规则设置你的反向代理服务器
按照 [reverse proxy guide](reverse-proxies.md) 的规则设置你的反向代理服务器
然后,按照下面的向导启用 HTTPS

@ -113,7 +113,7 @@ Gitea的自定义模板必须将其添加到正确的位置否则Gitea将无
如果找不到,请尝试`echo $GITEA_CUSTOM`
2. 如果仍然找不到,默认值可以被[计算](help/faq.md#where-does-gitea-store-what-file)
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径,则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
## Gitea是否有"GitHub/GitLab Pages"功能?
@ -212,7 +212,7 @@ Gitea还提供了自己的SSH服务器用于在SSHD不可用时使用。
请确保Gitea具有足够的权限来写入其主目录和数据目录。
参见[AppDataPath 和 RepoRootPath](help/faq.md#where-does-gitea-store-what-file)
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
**适用于Arch用户的注意事项**在撰写本文时Arch软件包的systemd文件包含了以下行
@ -348,7 +348,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#global-options)来指向正确的配置。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
- 作为**用户**,您可以更改密码...
- 在您的账户的`设置 -> 账户`页面(此方法**需要**您知道当前密码)。
- 使用`忘记密码`链接。
@ -465,6 +465,6 @@ gitea doctor recreate-table
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
- 确保存在要采用存储库的用户/组织。
- 作为管理员,转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#repository-repository) 获得类似的权限。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的权限。
- 如果上述步骤都正确执行,您应该能够选择要采用的存储库。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#repository-repository)以检查是否有特定错误。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以检查是否有特定错误。

@ -128,7 +128,7 @@ jobs:
请注意,演示文件中包含一些表情符号。
请确保您的数据库支持它们特别是在使用MySQL时。
如果字符集不是`utf8mb4`,将出现错误,例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`
有关更多信息,请参阅[数据库准备工作](installation/database-preparation.md#mysql)。
有关更多信息,请参阅[数据库准备工作](../../installation/database-preparation.md#mysqlmariadb)。
或者,您可以从演示文件中删除所有表情符号,然后再尝试一次。

@ -49,7 +49,7 @@ git push -o repo.private=false -u origin main
## 启用推送创建
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#repository-repository) 中了解有关这两个选项的更多信息。
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。
## 使用推送创建

@ -88,4 +88,4 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
内置主题是“gitea-light”、“gitea-dark”和“gitea-auto”自动适应操作系统设置
默认主题可以通过 `app.ini` 的 [ui](../administration/config-cheat-sheet.md#ui-ui) 部分中的 `DEFAULT_THEME` 进行更改。
默认主题可以通过 `app.ini` 的 [ui](../administration/config-cheat-sheet.md#界面) 部分中的 `DEFAULT_THEME` 进行更改。

@ -91,4 +91,4 @@ REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
`REVERSE_PROXY_LIMIT` 限制反向代理服务器的层数,设置为 `0` 表示不使用这些标头。
`REVERSE_PROXY_TRUSTED_PROXIES` 表示受信任的反向代理服务器网络地址,
经过该网络地址转发来的流量会经过解析 `X-Real-IP` 头部得到真实客户端地址。
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#security-security)
(参考 [configuration cheat sheet](../administration/config-cheat-sheet.md#安全性)

@ -20,7 +20,7 @@ menu:
在启用HTTPS之前确保您拥有有效的SSL/TLS证书。
建议在测试和评估情况下使用自签名证书,请运行 `gitea cert --host [HOST]` 以生成自签名证书
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](../administration/reverse-proxies.md)。
如果您在服务器上使用阿帕奇Apache或Nginx建议参考 [反向代理指南](reverse-proxies.md)。
要使用Gitea内置HTTPS支持您必须编辑`app.ini`文件。
@ -86,7 +86,7 @@ ACME_EMAIL=email@example.com
## 使用反向代理服务器
按照 [reverse proxy guide](../administration/reverse-proxies.md) 的规则设置你的反向代理服务器
按照 [反向代理指南](reverse-proxies.md) 的规则设置你的反向代理服务器
然后,按照下面的向导启用 HTTPS

@ -112,7 +112,7 @@ Gitea的自定义模板必须将其添加到正确的位置否则Gitea将无
如果找不到,请尝试`echo $GITEA_CUSTOM`
2. 如果仍然找不到,默认值可以被[计算](help/faq.md#where-does-gitea-store-what-file)
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径,则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
## Gitea是否有"GitHub/GitLab Pages"功能?
@ -200,7 +200,7 @@ Gitea还提供了自己的SSH服务器用于在SSHD不可用时使用。
请确保Gitea具有足够的权限来写入其主目录和数据目录。
参见[AppDataPath 和 RepoRootPath](help/faq.md#where-does-gitea-store-what-file)
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
**适用于Arch用户的注意事项**在撰写本文时Arch软件包的systemd文件包含了以下行
@ -336,7 +336,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#global-options)来指向正确的配置。
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
- 作为**用户**,您可以更改密码...
- 在您的账户的`设置 -> 账户`页面(此方法**需要**您知道当前密码)。
- 使用`忘记密码`链接。
@ -433,6 +433,6 @@ gitea doctor recreate-table
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
- 确保存在要采用存储库的用户/组织。
- 作为管理员,转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#repository-repository) 获得类似的权限。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的权限。
- 如果上述步骤都正确执行,您应该能够选择要采用的存储库。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#repository-repository)以检查是否有特定错误。
- 如果没有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以检查是否有特定错误。

@ -128,7 +128,7 @@ jobs:
请注意,演示文件中包含一些表情符号。
请确保您的数据库支持它们特别是在使用MySQL时。
如果字符集不是`utf8mb4`,将出现错误,例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`
有关更多信息,请参阅[数据库准备工作](installation/database-preparation.md#mysql)。
有关更多信息,请参阅[数据库准备工作](../../installation/database-preparation.md#mysqlmariadb)。
或者,您可以从演示文件中删除所有表情符号,然后再尝试一次。

@ -49,7 +49,7 @@ git push -o repo.private=false -u origin main
## 启用推送创建
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#repository-repository) 中了解有关这两个选项的更多信息。
`app.ini` 文件中,将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`,如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库,将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。
## 使用推送创建

62
main.go

@ -1,62 +0,0 @@
package main
import (
"fmt"
"io/fs"
"os"
"path/filepath"
"strings"
)
func main() {
args := os.Args
if len(args) != 4 {
fmt.Println("Please provide the path to the directory")
return
}
srcDir := os.Args[1]
if _, err := os.Stat(srcDir); os.IsNotExist(err) {
fmt.Println("Src directory does not exist")
return
}
dstDir := os.Args[2]
err := os.MkdirAll(dstDir, os.ModePerm)
if err != nil {
fmt.Println("Dst directory does not exist")
return
}
lang := os.Args[3]
if lang == "" || (lang != "en-us" && lang != "zh-cn" && lang != "zh-tw" && lang != "de-de" && lang != "fr-fr") {
fmt.Println("Please provide the language")
return
}
err = filepath.Walk(srcDir, func(path string, info fs.FileInfo, err error) error {
if err != nil {
return err
}
if info.IsDir() {
fmt.Println("Directory: ", path)
} else {
if strings.HasSuffix(path, "."+lang+".md") {
p := strings.Replace(path, "."+lang, "", 1)
rPath, err := filepath.Rel(srcDir, p)
if err != nil {
return err
}
p = filepath.Join(dstDir, rPath)
if err := os.MkdirAll(filepath.Dir(p), os.ModePerm); err != nil {
return err
}
if err := os.Rename(path, p); err != nil {
return err
}
}
}
return nil
})
if err != nil {
fmt.Println(err)
}
}