mirror of
				https://gitee.com/gitea/gitea
				synced 2025-11-04 08:30:25 +08:00 
			
		
		
		
	Use docs.gitea.com instead of docs.gitea.io (#26739)
This commit is contained in:
		@@ -36,7 +36,7 @@ Application settings can be found in file `CustomConf` which is by default,
 | 
			
		||||
Again `gitea help` will allow you review this variable and you can override it using the
 | 
			
		||||
`--config` option on the `gitea` binary.
 | 
			
		||||
 | 
			
		||||
- [Quick Cheat Sheet](https://docs.gitea.io/en-us/config-cheat-sheet/)
 | 
			
		||||
- [Quick Cheat Sheet](administration/config-cheat-sheet.md)
 | 
			
		||||
- [Complete List](https://github.com/go-gitea/gitea/blob/main/custom/conf/app.example.ini)
 | 
			
		||||
 | 
			
		||||
If the `CustomPath` folder can't be found despite checking `gitea help`, check the `GITEA_CUSTOM`
 | 
			
		||||
@@ -44,7 +44,7 @@ environment variable; this can be used to override the default path to something
 | 
			
		||||
`GITEA_CUSTOM` might, for example, be set by an init script. You can check whether the value
 | 
			
		||||
is set under the "Configuration" tab on the site administration page.
 | 
			
		||||
 | 
			
		||||
- [List of Environment Variables](https://docs.gitea.io/en-us/environment-variables/)
 | 
			
		||||
- [List of Environment Variables](administration/environment-variables.md)
 | 
			
		||||
 | 
			
		||||
**Note:** Gitea must perform a full restart to see configuration changes.
 | 
			
		||||
 | 
			
		||||
@@ -84,7 +84,7 @@ for C++ repositories, we want to replace `options/gitignore/C++`. To do this, a
 | 
			
		||||
must be placed in `$GITEA_CUSTOM/options/gitignore/C++` (see about the location of the `CustomPath`
 | 
			
		||||
directory at the top of this document).
 | 
			
		||||
 | 
			
		||||
Every single page of Gitea can be changed. Dynamic content is generated using [go templates](https://golang.org/pkg/html/template/),
 | 
			
		||||
Every single page of Gitea can be changed. Dynamic content is generated using [go templates](https://pkg.go.dev/html/template),
 | 
			
		||||
which can be modified by placing replacements below the `$GITEA_CUSTOM/templates` directory.
 | 
			
		||||
 | 
			
		||||
To obtain any embedded file (including templates), the [`gitea embedded` tool](administration/cmd-embedded.md) can be used. Alternatively, they can be found in the [`templates`](https://github.com/go-gitea/gitea/tree/main/templates) directory of Gitea source (Note: the example link is from the `main` branch. Make sure to use templates compatible with the release you are using).
 | 
			
		||||
@@ -108,7 +108,7 @@ just place it under your "$GITEA_CUSTOM/public/assets/" directory (for instance
 | 
			
		||||
To match the current style, the link should have the class name "item", and you can use `{{AppSubUrl}}` to get the base URL:
 | 
			
		||||
`<a class="item" href="{{AppSubUrl}}/assets/impressum.html">Impressum</a>`
 | 
			
		||||
 | 
			
		||||
For more information, see [Adding Legal Pages](https://docs.gitea.io/en-us/adding-legal-pages).
 | 
			
		||||
For more information, see [Adding Legal Pages](administration/adding-legal-pages.md).
 | 
			
		||||
 | 
			
		||||
You can add new tabs in the same way, putting them in `extra_tabs.tmpl`.
 | 
			
		||||
The exact HTML needed to match the style of other tabs is in the file
 | 
			
		||||
@@ -371,10 +371,10 @@ A full list of supported emoji's is at [emoji list](https://gitea.com/gitea/gite
 | 
			
		||||
## Customizing the look of Gitea
 | 
			
		||||
 | 
			
		||||
The default built-in themes are `gitea` (light), `arc-green` (dark), and `auto` (chooses light or dark depending on operating system settings).
 | 
			
		||||
The default theme can be changed via `DEFAULT_THEME` in the [ui](https://docs.gitea.io/en-us/config-cheat-sheet/#ui-ui) section of `app.ini`.
 | 
			
		||||
The default theme can be changed via `DEFAULT_THEME` in the [ui](administration/config-cheat-sheet.md#ui-ui) section of `app.ini`.
 | 
			
		||||
 | 
			
		||||
Gitea also has support for user themes, which means every user can select which theme should be used.
 | 
			
		||||
The list of themes a user can choose from can be configured with the `THEMES` value in the [ui](https://docs.gitea.io/en-us/config-cheat-sheet/#ui-ui) section of `app.ini`.
 | 
			
		||||
The list of themes a user can choose from can be configured with the `THEMES` value in the [ui](administration/config-cheat-sheet.md#ui-ui) section of `app.ini`.
 | 
			
		||||
 | 
			
		||||
To make a custom theme available to all users:
 | 
			
		||||
 | 
			
		||||
 
 | 
			
		||||
@@ -23,13 +23,13 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
 | 
			
		||||
将会自动创建包括 `custom/` 在内的必要应用目录,应用本身的配置存放在
 | 
			
		||||
`custom/conf/app.ini` 当中。在发行版中可能会以 `/etc/gitea/` 的形式为 `custom` 设置一个符号链接,查看配置详情请移步:
 | 
			
		||||
 | 
			
		||||
- [快速备忘单](https://docs.gitea.io/en-us/config-cheat-sheet/)
 | 
			
		||||
- [快速备忘单](administration/config-cheat-sheet.md)
 | 
			
		||||
- [完整配置清单](https://github.com/go-gitea/gitea/blob/main/custom/conf/app.example.ini)
 | 
			
		||||
 | 
			
		||||
如果您在 binary 同目录下无法找到 `custom` 文件夹,请检查您的 `GITEA_CUSTOM`
 | 
			
		||||
环境变量配置, 因为它可能被配置到了其他地方(可能被一些启动脚本设置指定了目录)。
 | 
			
		||||
 | 
			
		||||
- [环境变量清单](https://docs.gitea.io/en-us/specific-variables/)
 | 
			
		||||
- [环境变量清单](administration/environment-variables.md)
 | 
			
		||||
 | 
			
		||||
**注:** 必须完全重启 Gitea 以使配置生效。
 | 
			
		||||
 | 
			
		||||
@@ -87,4 +87,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](administration/config-cheat-sheet.md#ui-ui) 部分的 `DEFAULT_THEME` 的值来变更至一个可用的 Gitea 外观。
 | 
			
		||||
 
 | 
			
		||||
@@ -119,7 +119,7 @@ proxy_set_header X-Real-IP $remote_addr;
 | 
			
		||||
 | 
			
		||||
The security options in `app.ini` need to be adjusted to allow the interpretation of the headers
 | 
			
		||||
as well as the list of IP addresses and networks that describe trusted proxy servers
 | 
			
		||||
(See the [configuration cheat sheet](https://docs.gitea.io/en-us/config-cheat-sheet/#security-security) for more information).
 | 
			
		||||
(See the [configuration cheat sheet](administration/config-cheat-sheet.md#security-security) for more information).
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
REVERSE_PROXY_LIMIT = 1
 | 
			
		||||
 
 | 
			
		||||
@@ -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](https://docs.gitea.io/en-us/config-cheat-sheet/#security-security))
 | 
			
		||||
(参考 [configuration cheat sheet](administration/config-cheat-sheet.md#security-security))
 | 
			
		||||
 
 | 
			
		||||
@@ -18,7 +18,7 @@ menu:
 | 
			
		||||
# Mail templates
 | 
			
		||||
 | 
			
		||||
To craft the e-mail subject and contents for certain operations, Gitea can be customized by using templates. The templates
 | 
			
		||||
for these functions are located under the [`custom` directory](https://docs.gitea.io/en-us/customizing-gitea/).
 | 
			
		||||
for these functions are located under the [`custom` directory](administration/customizing-gitea.md).
 | 
			
		||||
Gitea has an internal template that serves as default in case there's no custom alternative.
 | 
			
		||||
 | 
			
		||||
Custom templates are loaded when Gitea starts. Changes made to them are not recognized until Gitea is restarted again.
 | 
			
		||||
@@ -165,7 +165,7 @@ If the template fails to render, it will be noticed only at the moment the mail
 | 
			
		||||
A default subject is used if the subject template fails, and whatever was rendered successfully
 | 
			
		||||
from the the _mail body_ is used, disregarding the rest.
 | 
			
		||||
 | 
			
		||||
Please check [Gitea's logs](https://docs.gitea.io/en-us/logging-configuration/) for error messages in case of trouble.
 | 
			
		||||
Please check [Gitea's logs](administration/logging-config.md) for error messages in case of trouble.
 | 
			
		||||
 | 
			
		||||
## Example
 | 
			
		||||
 | 
			
		||||
 
 | 
			
		||||
@@ -17,7 +17,7 @@ menu:
 | 
			
		||||
 | 
			
		||||
# 邮件模板
 | 
			
		||||
 | 
			
		||||
为了定制特定操作的电子邮件主题和内容,可以使用模板来自定义 Gitea。这些功能的模板位于 [`custom` 目录](https://docs.gitea.io/en-us/customizing-gitea/) 下。
 | 
			
		||||
为了定制特定操作的电子邮件主题和内容,可以使用模板来自定义 Gitea。这些功能的模板位于 [`custom` 目录](administration/customizing-gitea.md) 下。
 | 
			
		||||
如果没有自定义的替代方案,Gitea 将使用内部模板作为默认模板。
 | 
			
		||||
 | 
			
		||||
自定义模板在 Gitea 启动时加载。对它们的更改在 Gitea 重新启动之前不会被识别。
 | 
			
		||||
@@ -148,7 +148,7 @@ _主题_ 和 _邮件正文_ 由 [Golang的模板引擎](https://golang.org/pkg/t
 | 
			
		||||
如果模板无法呈现,则只有在发送邮件时才会注意到。
 | 
			
		||||
如果主题模板失败,将使用默认主题,如果从 _邮件正文_ 中成功呈现了任何内容,则将使用该内容,忽略其他内容。
 | 
			
		||||
 | 
			
		||||
如果遇到问题,请检查 [Gitea的日志](https://docs.gitea.io/en-us/logging-configuration/) 以获取错误消息。
 | 
			
		||||
如果遇到问题,请检查 [Gitea的日志](administration/logging-config.md) 以获取错误消息。
 | 
			
		||||
 | 
			
		||||
## 示例
 | 
			
		||||
 | 
			
		||||
 
 | 
			
		||||
@@ -19,7 +19,7 @@ menu:
 | 
			
		||||
 | 
			
		||||
## Setting up the repository indexer
 | 
			
		||||
 | 
			
		||||
Gitea can search through the files of the repositories by enabling this function in your [`app.ini`](https://docs.gitea.io/en-us/config-cheat-sheet/):
 | 
			
		||||
Gitea can search through the files of the repositories by enabling this function in your [`app.ini`](administration/config-cheat-sheet.md):
 | 
			
		||||
 | 
			
		||||
```ini
 | 
			
		||||
[indexer]
 | 
			
		||||
 
 | 
			
		||||
@@ -19,7 +19,7 @@ menu:
 | 
			
		||||
 | 
			
		||||
## 设置仓库索引器
 | 
			
		||||
 | 
			
		||||
通过在您的 [`app.ini`](https://docs.gitea.io/en-us/config-cheat-sheet/) 中启用此功能,Gitea 可以通过仓库的文件进行搜索:
 | 
			
		||||
通过在您的 [`app.ini`](administration/config-cheat-sheet.md) 中启用此功能,Gitea 可以通过仓库的文件进行搜索:
 | 
			
		||||
 | 
			
		||||
```ini
 | 
			
		||||
[indexer]
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user