语言
亦有
English
何以吾今须有一套 Pages 风格文档站
吾之所向,在渐近 GitHub Pages 常见之法。既然如此,最自然者,便是使吾亦立于一套 Pages 风格文档站之上。
此站不独为门面
今此 docs 源站,同时任三事:
- 为初识吾者立清晰入口
- 为特性、配置、工作流诸文安其所
- 作为真实站点 fixture,参与构建回归测试
比诸仅有 README,抑或脱离实现之设计稿,此法更足以随项目长久而进。
何以兼容性为先
吾所求者,不在自创奇诡之站点个性,而在使常见 Jekyll 形制,于 .NET 中仍保其熟悉:
- 熟悉之目录结构
- 熟悉之 front matter 与 permalink 预期
- 熟悉之 layout 与 include 组织
- 熟悉之 Filters、分页与主题侧行为