forked from Shiloh/githaven
6433ba0ec3
Use [chi](https://github.com/go-chi/chi) instead of the forked [macaron](https://gitea.com/macaron/macaron). Since macaron and chi have conflicts with session share, this big PR becomes a have-to thing. According my previous idea, we can replace macaron step by step but I'm wrong. :( Below is a list of big changes on this PR. - [x] Define `context.ResponseWriter` interface with an implementation `context.Response`. - [x] Use chi instead of macaron, and also a customize `Route` to wrap chi so that the router usage is similar as before. - [x] Create different routers for `web`, `api`, `internal` and `install` so that the codes will be more clear and no magic . - [x] Use https://github.com/unrolled/render instead of macaron's internal render - [x] Use https://github.com/NYTimes/gziphandler instead of https://gitea.com/macaron/gzip - [x] Use https://gitea.com/go-chi/session which is a modified version of https://gitea.com/macaron/session and removed `nodb` support since it will not be maintained. **BREAK** - [x] Use https://gitea.com/go-chi/captcha which is a modified version of https://gitea.com/macaron/captcha - [x] Use https://gitea.com/go-chi/cache which is a modified version of https://gitea.com/macaron/cache - [x] Use https://gitea.com/go-chi/binding which is a modified version of https://gitea.com/macaron/binding - [x] Use https://github.com/go-chi/cors instead of https://gitea.com/macaron/cors - [x] Dropped https://gitea.com/macaron/i18n and make a new one in `code.gitea.io/gitea/modules/translation` - [x] Move validation form structs from `code.gitea.io/gitea/modules/auth` to `code.gitea.io/gitea/modules/forms` to avoid dependency cycle. - [x] Removed macaron log service because it's not need any more. **BREAK** - [x] All form structs have to be get by `web.GetForm(ctx)` in the route function but not as a function parameter on routes definition. - [x] Move Git HTTP protocol implementation to use routers directly. - [x] Fix the problem that chi routes don't support trailing slash but macaron did. - [x] `/api/v1/swagger` now will be redirect to `/api/swagger` but not render directly so that `APIContext` will not create a html render. Notices: - Chi router don't support request with trailing slash - Integration test `TestUserHeatmap` maybe mysql version related. It's failed on my macOS(mysql 5.7.29 installed via brew) but succeed on CI. Co-authored-by: 6543 <6543@obermui.de>
75 lines
3.0 KiB
Markdown
75 lines
3.0 KiB
Markdown
---
|
||
date: "2016-11-08T16:00:00+02:00"
|
||
title: "文档"
|
||
slug: "documentation"
|
||
url: "/zh-cn/"
|
||
weight: 10
|
||
toc: false
|
||
draft: false
|
||
---
|
||
|
||
# 关于Gitea
|
||
|
||
Gitea 是一个自己托管的Git服务程序。他和GitHub, Bitbucket or Gitlab等比较类似。他是从 [Gogs](http://gogs.io) 发展而来，不过我们已经Fork并且命名为Gitea。对于我们Fork的原因可以看 [这里](https://blog.gitea.io/2016/12/welcome-to-gitea/)。
|
||
|
||
## 目标
|
||
|
||
Gitea的首要目标是创建一个极易安装，运行非常快速，安装和使用体验良好的自建 Git 服务。我们采用Go作为后端语言，这使我们只要生成一个可执行程序即可。并且他还支持跨平台，支持 Linux, macOS 和 Windows 以及各种架构，除了x86，amd64，还包括 ARM 和 PowerPC。
|
||
|
||
## 功能特性
|
||
|
||
- 支持活动时间线
|
||
- 支持 SSH 以及 HTTP/HTTPS 协议
|
||
- 支持 SMTP、LDAP 和反向代理的用户认证
|
||
- 支持反向代理子路径
|
||
- 支持用户、组织和仓库管理系统
|
||
- 支持添加和删除仓库协作者
|
||
- 支持仓库和组织级别 Web 钩子（包括 Slack 集成）
|
||
- 支持仓库 Git 钩子和部署密钥
|
||
- 支持仓库工单（Issue）、合并请求（Pull Request）以及 Wiki
|
||
- 支持迁移和镜像仓库以及它的 Wiki
|
||
- 支持在线编辑仓库文件和 Wiki
|
||
- 支持自定义源的 Gravatar 和 Federated Avatar
|
||
- 支持邮件服务
|
||
- 支持后台管理面板
|
||
- 支持 MySQL、PostgreSQL、SQLite3, MSSQL 和 TiDB（实验性支持） 数据库
|
||
- 支持多语言本地化（21 种语言）
|
||
|
||
## 系统要求
|
||
|
||
- 最低的系统硬件要求为一个廉价的树莓派
|
||
- 如果用于团队项目，建议使用 2 核 CPU 及 1GB 内存
|
||
|
||
## 浏览器支持
|
||
|
||
- 请根据 [Semantic UI](https://github.com/Semantic-Org/Semantic-UI#browser-support) 查看具体支持的浏览器版本。
|
||
- 官方支持的最小 UI 尺寸为 **1024*768**，UI 不一定会在更小尺寸的设备上被破坏，但我们无法保证且不会修复。
|
||
|
||
## 组件
|
||
|
||
* Web框架： [Chi](http://github.com/go-chi/chi)
|
||
* ORM: [XORM](https://xorm.io)
|
||
* UI组件：
|
||
* [Semantic UI](http://semantic-ui.com/)
|
||
* [GitHub Octicons](https://octicons.github.com/)
|
||
* [Font Awesome](http://fontawesome.io/)
|
||
* [DropzoneJS](http://www.dropzonejs.com/)
|
||
* [Highlight](https://highlightjs.org/)
|
||
* [Clipboard](https://zenorocha.github.io/clipboard.js/)
|
||
* [CodeMirror](https://codemirror.net/)
|
||
* [jQuery MiniColors](https://github.com/claviska/jquery-minicolors)
|
||
* 数据库驱动：
|
||
* [github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql)
|
||
* [github.com/lib/pq](https://github.com/lib/pq)
|
||
* [github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3)
|
||
* [github.com/pingcap/tidb](https://github.com/pingcap/tidb)
|
||
* [github.com/denisenkom/go-mssqldb](https://github.com/denisenkom/go-mssqldb)
|
||
|
||
## 软件及服务支持
|
||
|
||
- [Drone](https://github.com/drone/drone) (CI)
|
||
|
||
## 需要帮助?
|
||
|
||
如果从本页中没有找到你需要的内容，请访问 [帮助页面]({{< relref "seek-help.zh-cn.md" >}})
|