| @@ -0,0 +1,13 @@ | |||||
| --- | |||||
| date: "2016-12-27T16:00:00+02:00" | |||||
| title: "使用指南" | |||||
| slug: "usage" | |||||
| weight: 35 | |||||
| toc: false | |||||
| draft: false | |||||
| menu: | |||||
| sidebar: | |||||
| name: "使用指南" | |||||
| weight: 35 | |||||
| identifier: "usage" | |||||
| --- | |||||
| @@ -1,6 +1,6 @@ | |||||
| --- | --- | ||||
| date: "2018-06-06T09:33:00+08:00" | date: "2018-06-06T09:33:00+08:00" | ||||
| title: "使用: 备份与恢复" | |||||
| title: "使用:备份与恢复" | |||||
| slug: "backup-and-restore" | slug: "backup-and-restore" | ||||
| weight: 11 | weight: 11 | ||||
| toc: true | toc: true | ||||
| @@ -0,0 +1,37 @@ | |||||
| --- | |||||
| date: "2018-05-10T16:00:00+02:00" | |||||
| title: "使用:Issue 和 Pull Request 模板" | |||||
| slug: "issue-pull-request-templates" | |||||
| weight: 15 | |||||
| toc: true | |||||
| draft: false | |||||
| menu: | |||||
| sidebar: | |||||
| parent: "usage" | |||||
| name: "Issue 和 Pull Request 模板" | |||||
| weight: 15 | |||||
| identifier: "issue-pull-request-templates" | |||||
| --- | |||||
| # 使用 Issue 和 Pull Request 模板 | |||||
| 对于一些项目,在创建 issue 或 pull request 时有一个标准的询问列表需要提交者填写。Gitea 支持添加此类模板至 repository 的主分支,以便提交者在创建 issue 或 pull request 时可以自动生成一个需要完成的表单,这么做可以减少一些前期关于 issue 抑或 pull request 细节上的沟通成本。 | |||||
| 以下罗列了一些可供参考的 issue 模板: | |||||
| * ISSUE_TEMPLATE.md | |||||
| * issue_template.md | |||||
| * .gitea/ISSUE_TEMPLATE.md | |||||
| * .gitea/issue_template.md | |||||
| * .github/ISSUE_TEMPLATE.md | |||||
| * .github/issue_template.md | |||||
| 以下罗列了一些可供参考的 PR 模板: | |||||
| * PULL_REQUEST_TEMPLATE.md | |||||
| * pull_request_template.md | |||||
| * .gitea/PULL_REQUEST_TEMPLATE.md | |||||
| * .gitea/pull_request_template.md | |||||
| * .github/PULL_REQUEST_TEMPLATE.md | |||||
| * .github/pull_request_template.md | |||||
| @@ -0,0 +1,31 @@ | |||||
| --- | |||||
| date: "2018-06-01T19:00:00+02:00" | |||||
| title: "使用:Pull Request" | |||||
| slug: "pull-request" | |||||
| weight: 13 | |||||
| toc: true | |||||
| draft: false | |||||
| menu: | |||||
| sidebar: | |||||
| parent: "usage" | |||||
| name: "Pull Request" | |||||
| weight: 13 | |||||
| identifier: "pull-request" | |||||
| --- | |||||
| # Pull Request | |||||
| ## 在 pull requests 使用“Work In Progress”标记 | |||||
| 您可以通过在一个进行中的 pull request 的标题上添加前缀 `WIP:` 或者 `[WIP]`(此处大小写敏感)来防止它被意外合并,具体的前缀设置可以在配置文件 `app.ini` 中找到: | |||||
| ``` | |||||
| [repository.pull-request] | |||||
| WORK_IN_PROGRESS_PREFIXES=WIP:,[WIP] | |||||
| ``` | |||||
| 列表的第一个值将用于 helpers 程序。 | |||||
| ## Pull Request 模板 | |||||
| 有关 pull request 模板的更多信息请您移步 : [Issue and Pull Request templates](../issue-pull-request-templates) | |||||
| @@ -81,7 +81,7 @@ Then set `[server] ROOT_URL = http://git.example.com/git/` in your configuration | |||||
| Note: The following Apache HTTPD mods must be enabled: `proxy`, `proxy_http` | Note: The following Apache HTTPD mods must be enabled: `proxy`, `proxy_http` | ||||
| ## Using Caddy with a Sub-path as a reverse proxy | |||||
| ## Using Caddy as a reverse proxy | |||||
| If you want Caddy to serve your Gitea instance you can add the following server block to your Caddyfile: | If you want Caddy to serve your Gitea instance you can add the following server block to your Caddyfile: | ||||
| @@ -0,0 +1,105 @@ | |||||
| --- | |||||
| date: "2018-05-22T11:00:00+00:00" | |||||
| title: "使用:反向代理" | |||||
| slug: "reverse-proxies" | |||||
| weight: 17 | |||||
| toc: true | |||||
| draft: false | |||||
| menu: | |||||
| sidebar: | |||||
| parent: "usage" | |||||
| name: "反向代理" | |||||
| weight: 16 | |||||
| identifier: "reverse-proxies" | |||||
| --- | |||||
| ## 使用 Nginx 作为反向代理服务 | |||||
| 如果您想使用 Nginx 作为 Gitea 的反向代理服务,您可以参照以下 `nginx.conf` 配置中 `server` 的 `http` 部分: | |||||
| ``` | |||||
| server { | |||||
| listen 80; | |||||
| server_name git.example.com; | |||||
| location / { | |||||
| proxy_pass http://localhost:3000; | |||||
| } | |||||
| } | |||||
| ``` | |||||
| ## 使用 Nginx 作为反向代理服务并将 Gitea 路由至一个子路径 | |||||
| 如果您已经有一个域名并且想与 Gitea 共享该域名,您可以增加以下 `nginx.conf` 配置中 `server` 的 `http` 部分,为 Gitea 添加路由规则: | |||||
| ``` | |||||
| server { | |||||
| listen 80; | |||||
| server_name git.example.com; | |||||
| location /git/ { # Note: Trailing slash | |||||
| proxy_pass http://localhost:3000/; # Note: Trailing slash | |||||
| } | |||||
| } | |||||
| ``` | |||||
| 然后在您的 Gitea 配置文件中添加 `[server] ROOT_URL = http://git.example.com/git/`。 | |||||
| ## 使用 Apache HTTPD 作为反向代理服务 | |||||
| 如果您想使用 Apache HTTPD 作为 Gitea 的反向代理服务,您可以为您的 Apache HTTPD 作如下配置(在 Ubuntu 中,配置文件通常在 `/etc/apache2/httpd.conf` 目录下): | |||||
| ``` | |||||
| <VirtualHost *:80> | |||||
| ... | |||||
| ProxyPreserveHost On | |||||
| ProxyRequests off | |||||
| ProxyPass / http://localhost:3000/ | |||||
| ProxyPassReverse / http://localhost:3000/ | |||||
| </VirtualHost> | |||||
| ``` | |||||
| 注:必须启用以下 Apache HTTPD 组件:`proxy`, `proxy_http` | |||||
| ## 使用 Apache HTTPD 作为反向代理服务并将 Gitea 路由至一个子路径 | |||||
| 如果您已经有一个域名并且想与 Gitea 共享该域名,您可以增加以下配置为 Gitea 添加路由规则(在 Ubuntu 中,配置文件通常在 `/etc/apache2/httpd.conf` 目录下): | |||||
| ``` | |||||
| <VirtualHost *:80> | |||||
| ... | |||||
| <Proxy *> | |||||
| Order allow,deny | |||||
| Allow from all | |||||
| </Proxy> | |||||
| ProxyPass /git http://localhost:3000 # Note: no trailing slash after either /git or port | |||||
| ProxyPassReverse /git http://localhost:3000 # Note: no trailing slash after either /git or port | |||||
| </VirtualHost> | |||||
| ``` | |||||
| 然后在您的 Gitea 配置文件中添加 `[server] ROOT_URL = http://git.example.com/git/`。 | |||||
| 注:必须启用以下 Apache HTTPD 组件:`proxy`, `proxy_http` | |||||
| ## 使用 Caddy 作为反向代理服务 | |||||
| 如果您想使用 Caddy 作为 Gitea 的反向代理服务,您可以在 `Caddyfile` 中添加如下配置: | |||||
| ``` | |||||
| git.example.com { | |||||
| proxy / http://localhost:3000 | |||||
| } | |||||
| ``` | |||||
| ## 使用 Caddy 作为反向代理服务并将 Gitea 路由至一个子路径 | |||||
| 如果您已经有一个域名并且想与 Gitea 共享该域名,您可以在您的 `Caddyfile` 文件中增加以下配置,为 Gitea 添加路由规则: | |||||
| ``` | |||||
| git.example.com { | |||||
| proxy /git/ http://localhost:3000 # Note: Trailing Slash after /git/ | |||||
| } | |||||
| ``` | |||||
| 然后在您的 Gitea 配置文件中添加 `[server] ROOT_URL = http://git.example.com/git/`。 | |||||