Files
admin 7d19e2729c feat: 新增 Gitea 定制机制(首页/中文语言/去 Gitea 化)与本地预览
不改 Go 代码、不 fork, 只用官方 CustomPath 覆盖层 + app.ini/env 配置:

- custom/templates: 整文件覆盖 home.tmpl(落地页换成答疑平台介绍)与
  base/head_navbar.tmpl(docs.gitea.com -> 站内提问指南、新增课程官网入口)
- custom/public/assets/tjhlp/ask-guide.html: 站内提问指南静态页
- overrides/ + build.py: 由上游快照确定性生成整份 locale_zh-CN.json
  (工单 -> Issue 等 133 处), 带占位符校验; 缺失键会退回英文, 必须整份覆盖
- build.py 同时负责规范 custom/ 权限: 容器内 Gitea 以 git(982) 运行,
  文件若为 600 只读挂载也会 permission denied 并拒绝启动(生产踩过)
- upstream/<版本>/ + fetch-upstream.sh: 上游基线, 供升级时 diff 与重生成
- preview/: 独立 compose + preview.sh(up/check/reload/admin/reset),
  与生产隔离(独立端口 2081/数据目录/sqlite), 用同一镜像版本验证效果
- website-linkage.md: 官网(VitePress)侧的联动改动提案
2026-09-11 17:07:05 +08:00

39 lines
1.3 KiB
Bash
Executable File

#!/usr/bin/env bash
# 拉取指定 Gitea 版本的上游文件快照到 upstream/<版本>/。
#
# 快照是定制构建的基线: build.py 由它 + overrides/ 生成最终 locale;
# templates/ 下我们整文件覆盖的模板也以它为 diff 依据。
#
# 用法:
# customization/fetch-upstream.sh 1.27.3
#
# 只下载源码包并抽取 upstream-files.txt 列出的文件, 不会保存整份源码。
set -euo pipefail
VERSION="${1:?用法: fetch-upstream.sh <版本, 例如 1.27.3>}"
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
DEST="${HERE}/upstream/${VERSION}"
URL="https://dl.gitea.com/gitea/${VERSION}/gitea-src-${VERSION}.tar.gz"
TMP="$(mktemp -d)"
trap 'rm -rf "${TMP}"' EXIT
echo "下载 ${URL}"
curl -fsSL -o "${TMP}/src.tar.gz" "${URL}"
mkdir -p "${DEST}"
while read -r path; do
[ -z "${path}" ] && continue
case "${path}" in \#*) continue ;; esac
if ! tar -xzf "${TMP}/src.tar.gz" -C "${TMP}" "gitea-src-${VERSION}/${path}" 2>/dev/null; then
echo "✗ 上游不存在该文件(版本里改名/删除了?): ${path}" >&2
exit 1
fi
mkdir -p "${DEST}/$(dirname "${path}")"
cp "${TMP}/gitea-src-${VERSION}/${path}" "${DEST}/${path}"
echo " ✓ ${path}"
done <"${HERE}/upstream-files.txt"
echo "✓ 快照已更新到 ${DEST}"
echo " 下一步: python3 customization/build.py, 然后 diff 上游模板改动"