构建社区文档网站
我们需要一个网站用来展示社区相关的文档,包括社区指南、贡献指南等等。 这个网站将放在gdou.openio.net域名下,作为社区的一个入口,并通过网站链接到Github和JihuLab中。
初步方案
网站框架
目前我对此还没有太多的想法,不过我看到Hugo看起来挺不错,我们可以使用Hugo的GeekDoc主题作为网站文档主题,不过欢迎提出更好的框架和主题。
网站仓库
我们可以在社区的项目组中维护网站的源代码。
网站部署
网站全部使用静态部署的方式,但是在国内似乎没有太多可供静态部署的平台,也许都需要备案, JihuLab并不提供Pages的功能,所以我们应该会选择Github Pages作为静态部署的方式。
不过因为我们的网站仓库维护在JihuLab中,但是Github Pages部署需要有一个在Github上的仓库。为此,我们可以在 https://github.com/openio-net 下创建一个用于存放构建出来的网站静态页面的仓库,并命名为gdou-website
,让Github Pages可以直接以此进行部署。我们同时需要编写一个CI Bot可以定期将网站源码仓库进行构建并将静态页面更新到github的仓库中。
步骤
- 创建网站源代码仓库和网站静态页面仓库
- 选定网站框架和主题
- 创建网站最基础的版本
- 编写CI Bot以实现定期更新网站和部署网站