语言 亦有 English

何以吾今须有一套 Pages 风格文档站

吾之所向,在渐近 GitHub Pages 常见之法。既然如此,最自然者,便是使吾亦立于一套 Pages 风格文档站之上。

此站不独为门面

今此 docs 源站,同时任三事:

  • 为初识吾者立清晰入口
  • 为特性、配置、工作流诸文安其所
  • 作为真实站点 fixture,参与构建回归测试

比诸仅有 README,抑或脱离实现之设计稿,此法更足以随项目长久而进。

何以兼容性为先

吾所求者,不在自创奇诡之站点个性,而在使常见 Jekyll 形制,于 .NET 中仍保其熟悉:

  • 熟悉之目录结构
  • 熟悉之 front matter 与 permalink 预期
  • 熟悉之 layout 与 include 组织
  • 熟悉之 Filters、分页与主题侧行为