[enhancement] 关于github-page

HectorYuan / The-Whole-Web-Catalog

Creative Commons Zero v1.0 Universal

1 stars 1 forks source link

Open BobAnkh opened 4 years ago

BobAnkh commented 4 years ago

对于gh-page我感觉有几个方面可以讨论，首先我认为无需采用gh-page分支，而应当选择master分支上的docs文件夹这个位置来构建gh-page，一来管理起来更为方便，二来内容更为集中，结构看起来更直观。

其次，可以考虑采用其他框架来实现，例如docsify也是一个简单的好选择，但是否需要变更值得讨论，感觉目前的gh-page比较单薄

HectorYuan commented 4 years ago

github pages 这个分支的确没有太多存在必要，本想着可以作为一个独立分支单独存放文档信息，但是考虑下来脱离csv2md也无法单独管理，所以就先删去该分支，然后着手优化主分支结构。

HectorYuan commented 4 years ago

基于主分支在构建一个gh page 这个想法不错，也要考虑如何后面主题，如软件主题，增加后的工作流，看看是否足够兼容

BobAnkh commented 4 years ago

我个人比较推荐直接将于gh-page有关的内容放在主分支下的docs文件夹下交由github完成build工作，我目前写有gh-page文档的项目也是这样的架构，不过这个可以由你来确定具体规划

HectorYuan commented 4 years ago

可以，我也正好研究下这种方式，以及基于 github 的项目看板简单罗列下后续的计划