docs: 公开源码前移除站点文档里的私有远端地址

2026-08-05 19:09:02 +08:00
parent 7ca023023e
commit 4cb7ac7100
1 changed files with 5 additions and 5 deletions
@@ -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 分支，源目录 `/`