From 4cb7ac710069876a5a8015a5c676a7fb7e2a4f5f Mon Sep 17 00:00:00 2001 From: lofyer Date: Wed, 5 Aug 2026 19:09:02 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=AC=E5=BC=80=E6=BA=90=E7=A0=81?= =?UTF-8?q?=E5=89=8D=E7=A7=BB=E9=99=A4=E7=AB=99=E7=82=B9=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E9=87=8C=E7=9A=84=E7=A7=81=E6=9C=89=E8=BF=9C=E7=AB=AF=E5=9C=B0?= =?UTF-8?q?=E5=9D=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- site/DEPLOY.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/site/DEPLOY.md b/site/DEPLOY.md index 96dfebe..9202525 100644 --- a/site/DEPLOY.md +++ b/site/DEPLOY.md @@ -48,10 +48,10 @@ 本仓库有两个远端，用途不同： -- `github`（`git@github.com:lofyer/peoplelib.git`，公开）：只放 README 与截图，不推源码，历史与本地无共同祖先。 -- `origin`（`ssh://git@git.digiman.live:11022/root/peoplelib.git`，私有）：完整源码。 +- `github`（`git@github.com:lofyer/peoplelib.git`，公开）：源码与 CI，历史与本地无共同祖先。 +- `origin`（私有 Gitea）：完整源码，日常开发推这里。 -GitHub Pages 只能托管在公开仓库或付费计划的私有仓库上。站点要走公开仓库，所以核心问题是：**怎么把 `site/` 推上公开仓库，同时一行源码都不带过去。** +GitHub Pages 只能托管在公开仓库或付费计划的私有仓库上。站点要走公开仓库，所以核心问题是：**怎么让站点有自己独立的一条历史，改站点不牵动源码分支。** 顺带提醒一句（查证）：Pages 站点在互联网上始终是公开的，即使仓库是私有的。所以不要指望靠仓库权限藏住站点内容。 @@ -62,8 +62,8 @@ GitHub 文档明确的发布源只有两类（查证）：从某个分支发布 | 方式 | 是否可行 | 评价 | |---|---|---| | 公开仓库 `main` 分支的 `/docs` | 可行 | 但公开仓库的 `docs/screenshots/` 已被 README 引用，站点文件混进同一目录后，`docs/` 既是文档目录又是站点根，语义混乱。而且 README 与站点共用一次提交，改站点会污染 README 的历史 | -| 公开仓库独立 `gh-pages` 分支，根目录就是站点 | **推荐** | 分支里只有站点文件，物理上不可能带上源码。与现有的「用独立 orphan 提交推公开仓库」约定同构。README 留在 `main`，两条线互不干扰 | -| GitHub Actions 工作流 | 不推荐 | 需要在公开仓库放 `.github/workflows/`，与「只放 README 与截图」的约定冲突；而且站点零构建，Actions 唯一的价值是自动化，收益抵不上多出来的运行时依赖与调试面 | +| 公开仓库独立 `gh-pages` 分支，根目录就是站点 | **推荐** | 分支里只有站点文件，改站点不牵动 `main` 的源码历史，两条线互不干扰 | +| GitHub Actions 工作流 | 不推荐 | 站点零构建，Actions 唯一的价值是自动化，收益抵不上多出来的运行时依赖与调试面。`main` 上的工作流只管应用的构建与发布 | ### 结论：公开仓库的 `gh-pages` orphan 分支，源目录 `/`