Jekyll 教程

相比 文档，教程提供更详细的内容，并以叙述的形式讲解流程，涵盖 Jekyll 各种功能和使用场景。教程可能包含以下内容：

  • 根据特定场景需求，分步流程示范
  • 使用完整的示例数据演示，包含输入的数据（CSV等数据或 Liquid、Markdown、HTML内容）和输出的结果（最终生成的 HTML 或 页面元素）
  • 详解不同 Jekyll 方法的优点和缺点
  • 本地构建 Jekyll 和将 Jekyll 站点部署到互联网的
  • Jekyll 站点在本地构建和部署到互联网的指南
  • 结合文档中相关的技术说明

教程不同于文档，文档更像速查手册。而教程是将实现一个需求从零到一，手把手教学。

下面是一些推荐教程：

Jekyllrb.com 的教程还不多，你可以 Fork Jekyll github 仓库，添加你写的教程。

部分教程可能引导你使用一些工具、脚本、服务或插件实现 Jekyll 网站需求，也可能包含了 Jekyllrb 外部站点的教程。但是这些内容可能与 Jekyll 无关，请自行判断，因为 Jekyll 并不一定认可这些第三方内容。

如何在 Jekyllrb.com 发布教程Permalink

Jekyll 接受任何人将教程添加到 Jekyllrb.com 中，如果你想要贡献你的教程，可按以下步骤操作：

  1. 打开 jekyll/jekyll 项目 GitHub 仓库 并点击右上角的 Fork 按钮，Fork Jekyll项目到自己的 Github。
  2. 将自己的教程添加到 _tutorials collection（集合）目录中.
  3. 确保你的教程文件的命名、permalink 和 front matter（页面头部参数）的格式结构与现有教程相似。
  4. 并在把你的教程文件的名称添加到 _data/tutorials.yml （教程页面导航菜单配置文件）。
  5. 按照常规的 git 操作流程，提交拉取请求（pull request）。

你提交拉取请求以后，Jekyll 文档团队会审核你提交的内容，会根据你内容的情况合并内容或者提出修改建议。