





中文 | English
主题版本号与 Gitea 版本号保持一致
Gitea 版本号格式: 1.大版本号.小版本号
Gitea 理论上小版本号变更不会修改前端布局, 所以主题的小版本号适用于所有 Gitea 大版本号相同的 Gitea 版本.
比如: 主题版本 1.24.5
适用于 Gitea 版本 >=1.24.0
<1.25.0
仅维护项目发布中的最新的 Gitea 版本, 其他旧版本主题不接受 Issue 和 PR.
开发阶段的主题版本号格式:
1.大版本号.小版本号.时间戳
- 在发布页下载最新的 CSS 主题文件放入
gitea/public/assets/css
目录下 - 修改
gitea/conf/app.ini
,并将 CSS 文件名去掉theme-
的名称附加到[ui]
下的THEMES
末尾 - 重启 Gitea
- 在设置中查看主题
Important
自动颜色主题需要亮色和暗色的主题文件
例: 主题文件名为 theme-github-dark.css
,则添加 github-dark
到 THEMES
末尾
gitea/conf/app.ini
例:
[ui]
THEMES = gitea-auto, gitea-light, gitea-dark, github-auto, github-light, github-dark, github-soft-dark
详细请查看 Gitea 文档 Gitea docs
THEMES = github-auto, github-light, github-dark, github-soft-dark
THEMES = github-colorblind-auto, github-colorblind-light, github-colorblind-dark
THEMES = github-tritanopia-auto, github-tritanopia-light, github-tritanopia-dark
可以根据自己的偏好自定义主题的一部分样式
在主题的 CSS 文件的头部或尾部添加以下代码
:root {
--custom-clone-menu-width: 150px;
...
}
Important
请确保在 :root
选择器中添加自定义变量,否则无法生效
变量之间用 ;
分隔
建议自定义变量放在单独的文件中, 通过 shell 命令等方式追加到主题文件中
变量名 | 描述 | 默认 | Github | 推荐 | 最小 | 最大 |
---|---|---|---|---|---|---|
–custom-clone-menu-width | 克隆按钮的菜单宽度 | Gitea | 332px | 200px | 150px | 400px |
–custom-explore-repolist-columns | 探索页面的仓库列表列数 | 2 | 2 | 2 | ||
–custom-explore-userlist-columns | 探索页面的用户/组织列表列数 | 3 | 1 | 2/3 | ||
–custom-user-repolist-columns | 用户页面的仓库列表列数 | 2 | 2 | 1/2 | ||
–custom-org-repolist-columns | 组织页面的仓库列表列数 | 1 | 1 | 1/2 | ||
–custom-org-userlist-columns | 组织页面的用户列表列数 | 2 | 1 | 1/2 |
也许你会想使用开发中的主题, 而不是发布的主题
请确保你已经安装了 Node.js 环境, 推荐使用 Node.js 20 或以上版本
git clone https://github.com/lutinglt/gitea-github-theme.git
cd gitea-github-theme
npm install
npm run build
编译完成后, 会在 dist
目录下生成主题文件, 你可以将主题文件放入 gitea/public/assets/css
目录下, 然后在
gitea/conf/app.ini
中添加主题名称到 THEMES
末尾
请查看 CONTRIBUTING

Leave a Reply