当前位置: 首页 > 文档资料 > Jekyll 中文文档 >

数据文件

优质
小牛编辑
139浏览
2023-12-01

除了 Jekyll 的内建变量之外,你还可以指定用于 Liquid 模板系统 的自定义数据。

Jekyll 支持从 _data 目录下的 YAMLJSONCSV 载入数据,注意 CSV 文件必须包含表头行。

这个强大的特性可以帮你避免模板中的重复,并能在不修改 _config.yml 的情况下设置网站特定的选项。

插件和主题也可以通过数据文件来配置变量。

数据目录

正如在目录结构中所描述的,_data 目录用于存储供 Jekyll 生成网站的附加数据。这些文件可以使用 .yml.yaml.jsoncsv 扩展名,并可通过 site.data 访问。

示例:成员列表

这是一个数据文件的简单示例,用以避免在模板中复制粘贴大段代码。

_data/members.yml:

- name: Tom Preston-Werner
  github: mojombo

- name: Parker Moore
  github: parkr

- name: Liu Fengyun
  github: liufengyun

_data/members.csv:

name,github
Tom Preston-Werner,mojombo
Parker Moore,parkr
Liu Fengyun,liufengyun

这些数据可以通过 site.data.members 访问(注意文件名决定了变量名)。

你现在可以在模板中使用该成员列表了:

<ul>
{% for member in site.data.members %}
  <li>
    <a href="https://github.com/{{ member.github }}">
      {{ member.name }}
    </a>
  </li>
{% endfor %}
</ul>

示例:组织结构

数据文件也可以被放在 _data 的子目录下,每层目录都将添加进变量的命名空间。下面的示例展示了如何在 orgs 目录下分别定义 GitHub 的组织结构:

_data/orgs/jekyll.yml:

username: jekyll
name: Jekyll
members:
  - name: Tom Preston-Werner
    github: mojombo

  - name: Parker Moore
    github: parkr

_data/orgs/doeorg.yml:

username: doeorg
name: Doe Org
members:
  - name: John Doe
    github: jdoe

该组织结构能够通过 site.data.orgs 加上各自的文件名访问:

<ul>
{% for org_hash in site.data.orgs %}
{% assign org = org_hash[1] %}
  <li>
    <a href="https://github.com/{{ org.username }}">
      {{ org.name }}
    </a>
    ({{ org.members | size }} members)
  </li>
{% endfor %}
</ul>

示例:访问特定的作者

页面和文章也可以访问特定的数据项目,下面的例子展示了如何实现:

_data/people.yml:

dave:
    name: David Smith
    twitter: DavidSilvaSmith

然后可在文章的头信息中指定作者:

---
title: sample post
author: dave
---

{% assign author = site.data.people[page.author] %}
<a rel="author"
  href="{{ author.twitter }}"
  title="{{ author.name }}">
    {{ author.name }}
</a>