Jekyll 的理念

Jekyll 在静态网站生成方面有一套独特的理念,这些原则指导着 Jekyll 的开发和产品决策。当贡献者、维护者或用户思考 Jekyll 的本质时,应该想到以下几点:

1. 无魔法操作

Jekyll 不是黑箱操作。用户应该能轻松理解 Jekyll 构建网站的过程,而不需要大量阅读文档。Jekyll 只会执行你明确要求的操作,不会擅自做额外的事情。每个操作的结果都应该是清晰可预测的。

2. 开箱即用

Jekyll 的目标是让用户开箱即用。运行 gem install jekyll 后,它应该能顺利构建任何 Jekyll 网站。自动重建、Markdown 解析等默认设置应当足够合理,满足大多数用户的需求,而不需要用户一开始就进行复杂配置。

3. 内容至上

Jekyll 受到内容创作者的喜爱,因为它始终专注于内容,致力于让 Web 发布变得简单。用户应该能够轻松管理自己的内容,并从中获得良好的体验。

4. 稳定性

如果一个网站今天能正常构建,明天也应该能正常构建。Jekyll 强调向后兼容,尽量避免破坏性变更。只有在有明确的实际需求时才考虑引入破坏性变更,而不会单纯为了代码整洁或方便维护者管理而修改。
如果确实需要进行破坏性更改,Jekyll 会提供清晰的升级路径,以减少用户在版本升级时的困扰。

5. 轻量且可扩展

Jekyll 的核心应该保持小巧简洁,同时提供强大的扩展能力,让社区贡献者可以添加更多功能。核心功能应该覆盖 90% 以上的用户需求,其他功能则应作为插件提供。新功能应优先以插件形式发布,同时确保核心 API 具有良好的可扩展性,以支持各种插件开发。