在github
上部署github pages
时,有两个选项:部署的内容所在的分支,和分支中的哪个文件夹。然而,分支可以选任意的分支,文件夹却只有两个选项:根目录(/
),或/docs
文件夹。
这就带来了几个问题:
- 很多静态网站生成器(比如
hugo
)默认以/public
文件夹为网站生成目录,此时就只能在配置中强行更改生成目录为/docs
/docs
本身语义不明。有些项目将自身的说明文档放在/docs
,并且有另外的展示page
,此时就冲突了- 最重要的一点,此时网站的源代码和生成的内容在同一个分支中,结构较为臃肿,不方便维护
2021年2月16日大约 4 分钟