@@ -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" | |||
title: "使用: 备份与恢复" | |||
title: "使用:备份与恢复" | |||
slug: "backup-and-restore" | |||
weight: 11 | |||
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` | |||
## 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: | |||
@@ -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/`。 |