分步教程

6. 数据文件

Jekyll 支持从位于 _data 目录中的 YAML、JSON 和 CSV 文件加载数据。数据文件是将内容与源代码分离开来以使网站更易于维护的绝佳方式。

在此步骤中,您将在数据文件中存储导航内容,然后在导航包含中对其进行迭代。

数据文件用法

YAML 是一种在 Ruby 生态系统中常见的格式。您将使用它来存储一个导航项数组,每个导航项都有一个名称和链接。

_data/navigation.yml 中为导航创建一个数据文件,内容如下

- name: Home
  link: /
- name: About
  link: /about.html

Jekyll 会在 site.data.navigation 中向您提供此数据文件。您现在可以迭代数据文件,而不是在 _includes/navigation.html 中输出每个链接

<nav>
  {% for item in site.data.navigation %}
    <a href="{{ item.link }}" {% if page.url == item.link %}style="color: red;"{% endif %}>
      {{ item.name }}
    </a>
  {% endfor %}
</nav>

输出将完全相同。不同之处在于,您已经让添加新的导航项和更改 HTML 结构变得更加容易。

没有 CSS、JS 和图像,网站有什么用?让我们看看如何在 Jekyll 中处理资产。

  1. 设置
  2. Liquid
  3. 页眉信息
  4. 布局
  5. 包含
  6. 数据文件
  7. 资产
  8. 博客
  9. 集合
  10. 部署