Add markdownlint (#20512 )

Add `markdownlint` linter and fix issues. Config is based on the one
from electron's repo with a few rules relaxed.

2022-07-28 09:22:47 +08:00

7.1 KiB

Raw Blame History

date	title	slug	url	weight	toc	draft
2016-11-08T16:00:00+02:00	文件	documentation	/zh-tw/	10	false	false

關於 Gitea

Gitea 是一個可自行託管的 Git 服務。你可以拿 GitHub、Bitbucket 或 Gitlab 來比較看看。 Gitea 是從 Gogs Fork 出來的，請閱讀部落格文章 Gitea 公告以了解我們 Fork 的理由。

目標

本專案的首要目標是建立一個容易安裝，執行快速，安装和使用體驗良好的自建 Git 服務。我們採用 GO 為後端語言，Go 可以產生各平台使用的執行檔。它支援 Linux、macOS 和 Windows 外，處理器架構包含 amd64、i386、ARM 和 PowerPC 等。

功能

使用者面板
- 內容切換（組織或目前使用者）
- 動態時間軸
  - 提交
  - 問題
  - 合併請求
  - 儲存庫的建立
- 可搜尋的儲存庫清單
- 組織清單
- 鏡像儲存庫清單
問題面板
- 內容切換（組織或目前使用者）
- 篩選器
  - 開放中
  - 已關閉
  - 您的儲存庫
  - 被指派的問題
  - 您的問題
  - 儲存庫
- 排序
  - 最舊
  - 最近更新
  - 留言數量
合併請求面板
- 和問題面板相同
儲存庫類型
- 鏡像
- 一般
- 已遷移
通知（email 和網頁）
- 已讀
- 未讀
- 釘選
探索頁面
- 使用者
- 儲存庫
- 組織
- 搜尋
自訂範本
複寫 public 檔案（logo, css 等）
CSRF 與 XSS 保護
支援 HTTPS
設定允許上傳的檔案大小和類型
日誌
組態
- 資料庫
  - MySQL
  - PostgreSQL
  - SQLite3
  - MSSQL
  - TiDB（MySQL 協議）
- 設定檔
  - app.ini
- 管理員面板
  - 系統摘要
  - 維護操作
    - 刪除未啟用帳戶
    - 刪除快取的儲存庫存檔
    - 刪除遺失 Git 檔案的儲存庫
    - 對儲存庫進行垃圾回收
    - 重寫 SSH 金鑰
    - 重新同步 hooks
    - 重新建立遺失的儲存庫
  - 伺服器狀態
    - 執行時間
    - 記憶體
    - 目前的 Goroutines 數量
    - 還有更多……
  - 使用者管理
    - 搜尋
    - 排序
    - 最後登入時間
    - 認證來源
    - 儲存庫上限
    - 停用帳戶
    - 管理員權限
    - 建立 Git Hook 的權限
    - 建立組織的權限
    - 匯入儲存庫的權限
  - 組織管理
    - 成員
    - 團隊
    - 大頭貼
    - Hook
  - 儲存庫管理
    - 查看所有儲存庫資訊和管理儲存庫
  - 認證來源
    - OAuth
    - PAM
    - LDAP
    - SMTP
  - 組態檢視器
    - 所有設定檔中的值
  - 系統提示
    - 當有未預期的事情發生時
  - 應用監控面板
    - 目前的處理程序
    - Cron 任務
      - 更新鏡像
      - 儲存庫健康檢查
      - 檢查儲存庫的統計資料
      - 刪除舊的儲存庫存檔
- 環境變數
- 命令列選項
支援多國語言 (21 種語言)
支援 Mermaid 圖表
郵件服務
- 通知
- 確認註冊
- 重設密碼
支援反向代理（Reverse Proxy）
- 包含子路徑
使用者
- 個人資料
  - 姓名
  - 帳號
  - 電子信箱
  - 網站
  - 加入日期
  - 追蹤者和追蹤中
  - 組織
  - 儲存庫
  - 動態
  - 已加星號的儲存庫
- 設定
  - 和個人資料相同並包含下列功能
  - 隱藏電子信箱
  - 大頭貼
    - Gravatar
    - Libravatar
    - 自訂
  - 密碼
  - 多個電子信箱
  - SSH 金鑰
  - 已連結的應用程式
  - 兩步驟驗證
  - 已連結 OAuth2 來源
  - 刪除帳戶
儲存庫
- 以 SSH/HTTP/HTTPS Clone
- Git LFS
- 關注、星號、Fork
- 檢視關注、已加星號、Fork 的使用者
- 程式碼
  - 瀏覽分支
  - 從網頁上傳和建立檔案
  - Clone url
  - 下載
    - ZIP
    - TAR.GZ
  - 網頁程式碼編輯器
    - Markdown 編輯器
    - 文本編輯器
      - 語法高亮
    - 預覽差異
    - 預覽
    - 選擇提交目標分支
  - 檢視檔案歷史
  - 刪除檔案
  - 檢視 raw
- 問題
  - 問題範本
  - 里程碑
  - 標籤
  - 指派問題
  - 時間追蹤
  - 表情反應
  - 篩選器
    - 開放中
    - 已關閉
    - 被指派的人
    - 您的問題
    - 提及您
  - 排序
    - 最舊
    - 最近更新
    - 留言數量
  - 搜尋
  - 留言
  - 附件
- 合併請求
  - 功能和問題相同
- 提交
  - 提交線圖
  - 不同分支的提交
  - 搜尋
  - 在所有分支中搜尋
  - 檢視差異（diff）
  - 檢視 SHA
  - 檢視作者（author）
  - 瀏覽提交中的檔案
- 版本發佈
  - 附件
  - 標題
  - 內容
  - 刪除
  - 標記為 pre-release
  - 選擇分支
- Wiki
  - 匯入
  - Markdown 編輯器
- 設定
  - 選項
    - 名稱
    - 描述
    - 私有/公開
    - 網站
    - Wiki
      - 開啟/關閉
      - 內部/外部
    - 問題
      - 開啟/關閉
      - 內部/外部
      - 外部問題追蹤器支援 URL 重寫（URL Rewrite）以獲得更好的整合性
    - 開啟/關閉合併請求
    - 轉移儲存庫所有權
    - 刪除 wiki
    - 刪除儲存庫
  - 協作者
    - 讀取/寫入/管理員
  - 分支
    - 預設分支
    - 分支保護
  - Webhook
  - Git hook
  - 部署金鑰

系統需求

Raspberry Pi 3 的效能足夠讓 Gitea 承擔小型工作負載。
雙核心 CPU 和 1GB 記憶體通常足以應付小型團隊/專案。
在類 UNIX 系統上，應該以專用的非 root 系統帳號來執行 Gitea。
- 備註：Gitea 管理著 ~/.ssh/authorized_keys 檔案。以一般身份使用者執行 Gitea 可能會破壞該使用者的登入能力。
Git 的最低需求為 2.0 或更新版本。
- 當 git 版本 >= 2.1.2 時，可啟用 Git large file storage。
- 當 git 版本 >= 2.18 時，將自動啟用 Git 提交線圖渲染。

瀏覽器支援

最近 2 個版本的 Chrome, Firefox, Safari, Edge
Firefox ESR

元件

Web 框架： Chi
ORM： XORM
UI 元件：
- jQuery
- Fomantic UI
- Vue2
- CodeMirror
- EasyMDE
- Monaco Editor
- ... (package.json)
資料庫驅動程式：

軟體和服務支援

Drone (CI)

7.1 KiB Raw Blame History Unescape Escape

關於 Gitea

目標

功能

系統需求

瀏覽器支援

元件

軟體和服務支援

7.1 KiB

Raw Blame History