mirror of
https://gitea.com/gitea/docs.git
synced 2026-07-22 02:37:42 +00:00
Backport #31054 by @lunny Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
This commit is contained in:
@@ -117,7 +117,7 @@ curl -v "http://localhost/api/v1/repos/search?limit=1"
|
|||||||
API Reference guide is auto-generated by swagger and available on:
|
API Reference guide is auto-generated by swagger and available on:
|
||||||
`https://gitea.your.host/api/swagger`
|
`https://gitea.your.host/api/swagger`
|
||||||
or on the
|
or on the
|
||||||
[Gitea demo instance](https://try.gitea.io/api/swagger)
|
[Gitea instance](https://gitea.com/api/swagger)
|
||||||
|
|
||||||
The OpenAPI document is at:
|
The OpenAPI document is at:
|
||||||
`https://gitea.your.host/swagger.v1.json`
|
`https://gitea.your.host/swagger.v1.json`
|
||||||
|
|||||||
@@ -45,7 +45,7 @@ To migrate from GitHub to Gitea, you can use Gitea's built-in migration form.
|
|||||||
|
|
||||||
In order to migrate items such as issues, pull requests, etc. you will need to input at least your username.
|
In order to migrate items such as issues, pull requests, etc. you will need to input at least your username.
|
||||||
|
|
||||||
[Example (requires login)](https://try.gitea.io/repo/migrate)
|
[Example (requires login)](https://demo.gitea.com/repo/migrate)
|
||||||
|
|
||||||
To migrate from GitLab to Gitea, you can use this non-affiliated tool:
|
To migrate from GitLab to Gitea, you can use this non-affiliated tool:
|
||||||
|
|
||||||
@@ -137,9 +137,9 @@ All Gitea instances have the built-in API and there is no way to disable it comp
|
|||||||
You can, however, disable showing its documentation by setting `ENABLE_SWAGGER` to `false` in the `api` section of your `app.ini`.
|
You can, however, disable showing its documentation by setting `ENABLE_SWAGGER` to `false` in the `api` section of your `app.ini`.
|
||||||
For more information, refer to Gitea's [API docs](development/api-usage.md).
|
For more information, refer to Gitea's [API docs](development/api-usage.md).
|
||||||
|
|
||||||
You can see the latest API (for example) on https://try.gitea.io/api/swagger
|
You can see the latest API (for example) on https://gitea.com/api/swagger
|
||||||
|
|
||||||
You can also see an example of the `swagger.json` file at https://try.gitea.io/swagger.v1.json
|
You can also see an example of the `swagger.json` file at https://gitea.com/swagger.v1.json
|
||||||
|
|
||||||
## Adjusting your server for public/private use
|
## Adjusting your server for public/private use
|
||||||
|
|
||||||
|
|||||||
@@ -47,7 +47,7 @@ menu:
|
|||||||
|
|
||||||
为了迁移诸如问题、拉取请求等项目,您需要至少输入您的用户名。
|
为了迁移诸如问题、拉取请求等项目,您需要至少输入您的用户名。
|
||||||
|
|
||||||
[Example (requires login)](https://try.gitea.io/repo/migrate)
|
[Example (requires login)](https://demo.gitea.com/repo/migrate)
|
||||||
|
|
||||||
要从GitLab迁移到Gitea,您可以使用这个非关联的工具:
|
要从GitLab迁移到Gitea,您可以使用这个非关联的工具:
|
||||||
|
|
||||||
@@ -141,9 +141,9 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
|
|||||||
但是,您可以在app.ini的api部分将ENABLE_SWAGGER设置为false,以禁用其文档显示。
|
但是,您可以在app.ini的api部分将ENABLE_SWAGGER设置为false,以禁用其文档显示。
|
||||||
有关更多信息,请参阅Gitea的[API文档](development/api-usage.md)。
|
有关更多信息,请参阅Gitea的[API文档](development/api-usage.md)。
|
||||||
|
|
||||||
您可以在上查看最新的API(例如)https://try.gitea.io/api/swagger
|
您可以在上查看最新的API(例如)https://gitea.com/api/swagger
|
||||||
|
|
||||||
您还可以在上查看`swagger.json`文件的示例 https://try.gitea.io/swagger.v1.json
|
您还可以在上查看`swagger.json`文件的示例 https://gitea.com/swagger.v1.json
|
||||||
|
|
||||||
## 调整服务器用于公共/私有使用
|
## 调整服务器用于公共/私有使用
|
||||||
|
|
||||||
|
|||||||
@@ -19,11 +19,11 @@ menu:
|
|||||||
|
|
||||||
- [Paid Commercial Support](https://about.gitea.com/)
|
- [Paid Commercial Support](https://about.gitea.com/)
|
||||||
- [Discord](https://discord.gg/Gitea)
|
- [Discord](https://discord.gg/Gitea)
|
||||||
- [Discourse Forum](https://discourse.gitea.io/)
|
- [Forum](https://forum.gitea.com/)
|
||||||
- [Matrix](https://matrix.to/#/#gitea-space:matrix.org)
|
- [Matrix](https://matrix.to/#/#gitea-space:matrix.org)
|
||||||
- NOTE: Most of the Matrix channels are bridged with their counterpart in Discord and may experience some degree of flakiness with the bridge process.
|
- NOTE: Most of the Matrix channels are bridged with their counterpart in Discord and may experience some degree of flakiness with the bridge process.
|
||||||
- Chinese Support
|
- Chinese Support
|
||||||
- [Discourse Chinese Category](https://discourse.gitea.io/c/5-category/5)
|
- [Discourse Chinese Category](https://forum.gitea.com/c/5-category/5)
|
||||||
- QQ Group 328432459
|
- QQ Group 328432459
|
||||||
|
|
||||||
# Bug Report
|
# Bug Report
|
||||||
@@ -39,7 +39,7 @@ If you found a bug, please [create an issue on GitHub](https://github.com/go-git
|
|||||||
- When using systemd, use `journalctl --lines 1000 --unit gitea` to collect logs.
|
- When using systemd, use `journalctl --lines 1000 --unit gitea` to collect logs.
|
||||||
- When using docker, use `docker logs --tail 1000 <gitea-container>` to collect logs.
|
- When using docker, use `docker logs --tail 1000 <gitea-container>` to collect logs.
|
||||||
4. Reproducible steps so that others could reproduce and understand the problem more quickly and easily.
|
4. Reproducible steps so that others could reproduce and understand the problem more quickly and easily.
|
||||||
- [try.gitea.io](https://try.gitea.io) could be used to reproduce the problem.
|
- [demo.gitea.com](https://demo.gitea.com) could be used to reproduce the problem.
|
||||||
5. If you encounter slow/hanging/deadlock problems, please report the stacktrace when the problem occurs.
|
5. If you encounter slow/hanging/deadlock problems, please report the stacktrace when the problem occurs.
|
||||||
Go to the "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report".
|
Go to the "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report".
|
||||||
|
|
||||||
|
|||||||
@@ -19,11 +19,11 @@ menu:
|
|||||||
|
|
||||||
- [付费商业支持](https://about.gitea.com/)
|
- [付费商业支持](https://about.gitea.com/)
|
||||||
- [Discord](https://discord.gg/Gitea)
|
- [Discord](https://discord.gg/Gitea)
|
||||||
- [Discourse 论坛](https://discourse.gitea.io/)
|
- [论坛](https://forum.gitea.com/)
|
||||||
- [Matrix](https://matrix.to/#/#gitea-space:matrix.org)
|
- [Matrix](https://matrix.to/#/#gitea-space:matrix.org)
|
||||||
- 注意:大多数 Matrix 频道都与 Discord 中的对应频道桥接,可能在桥接过程中会出现一定程度的不稳定性。
|
- 注意:大多数 Matrix 频道都与 Discord 中的对应频道桥接,可能在桥接过程中会出现一定程度的不稳定性。
|
||||||
- 中文支持
|
- 中文支持
|
||||||
- [Discourse 中文分类](https://discourse.gitea.io/c/5-category/5)
|
- [Discourse 中文分类](https://forum.gitea.com/c/5-category/5)
|
||||||
- QQ 群 328432459
|
- QQ 群 328432459
|
||||||
|
|
||||||
# Bug 报告
|
# Bug 报告
|
||||||
@@ -39,7 +39,7 @@ menu:
|
|||||||
- 在使用 systemd 时,使用 `journalctl --lines 1000 --unit gitea` 收集日志。
|
- 在使用 systemd 时,使用 `journalctl --lines 1000 --unit gitea` 收集日志。
|
||||||
- 在使用 Docker 时,使用 `docker logs --tail 1000 <gitea-container>` 收集日志。
|
- 在使用 Docker 时,使用 `docker logs --tail 1000 <gitea-container>` 收集日志。
|
||||||
4. 可重现的步骤,以便他人能够更快速、更容易地重现和理解问题。
|
4. 可重现的步骤,以便他人能够更快速、更容易地重现和理解问题。
|
||||||
- [try.gitea.io](https://try.gitea.io) 可用于重现问题。
|
- [demo.gitea.com](https://demo.gitea.com) 可用于重现问题。
|
||||||
5. 如果遇到慢速/挂起/死锁等问题,请在出现问题时报告堆栈跟踪。
|
5. 如果遇到慢速/挂起/死锁等问题,请在出现问题时报告堆栈跟踪。
|
||||||
转到 "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report"。
|
转到 "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report"。
|
||||||
|
|
||||||
|
|||||||
@@ -21,7 +21,7 @@ up a self-hosted Git service.
|
|||||||
With Go, this can be done platform-independently across
|
With Go, this can be done platform-independently across
|
||||||
**all platforms** which Go supports, including Linux, macOS, and Windows,
|
**all platforms** which Go supports, including Linux, macOS, and Windows,
|
||||||
on x86, amd64, ARM and PowerPC architectures.
|
on x86, amd64, ARM and PowerPC architectures.
|
||||||
You can try it out using [the online demo](https://try.gitea.io/).
|
You can try it out using [the online demo](https://demo.gitea.com).
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
|
|||||||
@@ -236,7 +236,7 @@ configure this, set the fields below:
|
|||||||
|
|
||||||
- Restrict what domains can log in if using a public SMTP host or SMTP host
|
- Restrict what domains can log in if using a public SMTP host or SMTP host
|
||||||
with multiple domains.
|
with multiple domains.
|
||||||
- Example: `gitea.io,mydomain.com,mydomain2.com`
|
- Example: `gitea.com,mydomain.com,mydomain2.com`
|
||||||
|
|
||||||
- Force SMTPS
|
- Force SMTPS
|
||||||
|
|
||||||
|
|||||||
@@ -194,7 +194,7 @@ PAM提供了一种机制,通过对用户进行PAM认证来自动将其添加
|
|||||||
|
|
||||||
- 如果使用公共 SMTP 主机或有多个域的 SMTP 主机,限制哪些域可以登录
|
- 如果使用公共 SMTP 主机或有多个域的 SMTP 主机,限制哪些域可以登录
|
||||||
限制哪些域可以登录。
|
限制哪些域可以登录。
|
||||||
- 示例: `gitea.io,mydomain.com,mydomain2.com`
|
- 示例: `gitea.com,mydomain.com,mydomain2.com`
|
||||||
|
|
||||||
- 强制使用 SMTPS
|
- 强制使用 SMTPS
|
||||||
- 默认情况下将使用SMTPS连接到端口465.如果您希望将smtp用于其他端口,自行设置
|
- 默认情况下将使用SMTPS连接到端口465.如果您希望将smtp用于其他端口,自行设置
|
||||||
|
|||||||
@@ -308,7 +308,7 @@ This is a example for a issue config file
|
|||||||
blank_issues_enabled: true
|
blank_issues_enabled: true
|
||||||
contact_links:
|
contact_links:
|
||||||
- name: Gitea
|
- name: Gitea
|
||||||
url: https://gitea.io
|
url: https://gitea.com
|
||||||
about: Visit the Gitea Website
|
about: Visit the Gitea Website
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user