如何为公共Github项目配置私有Github Project Site文档站点

方案说明 #

1. 需求可实现的官方方案

首先明确Github Pages的权限规则：公共仓库的Pages站点强制公开，不支持设置私有访问；私有Pages能力仅面向Github Pro/Team/Enterprise账户的私有仓库开放，免费版账户的私有仓库也无法使用该功能。
如果你可以接受升级到Github Pro，可按以下流程实现需求：

• 将未完成的文档从公共开源仓库中拆分，单独存储到你账户下的一个新建私有仓库
• 为该私有仓库开启Pages服务，将站点可见性设置为私有，此时只有你和你邀请的仓库协作者可以访问文档站点
• 文档开发完成准备正式发布时，可直接将私有文档仓库转为公开，或者将文档构建产物同步到原公共仓库的Pages部署分支，即可对所有用户开放访问

2. 无需付费的替代方案

如果不想升级付费账户，可选择以下贴合需求的实现方式：

• 本地预览协作：如果你的文档基于静态站点生成器（如Jekyll、VitePress、Docusaurus等）开发，所有协作者克隆文档仓库到本地后，运行对应本地开发命令即可实时预览效果，全程不会对外暴露未完成内容
• 加密临时托管：将文档临时部署到支持密码访问的静态托管平台，设置自定义访问密码后仅同步给内部预览人员，正式发布时再将静态资源部署到公共仓库的Github Pages即可
• 私有仓库草稿协作：如果不需要在线预览站点，仅需要多人协作编写文档，可以单独创建私有仓库存储文档草稿，所有内容开发完成后再批量同步到公共仓库对外公开

内容的提问来源于stack exchange，提问作者Flame_Phoenix