GitHub 页面中的分层类别

Question

我在 GitHub 页面上使用 Jekyll，我希望有这样的分层类别：

• 动物 -> 哺乳动物 -> 猫 -> _posts -> housecat.md, tiger.md
• 动物 -> 哺乳动物 -> 狗 -> _posts -> poodle.md, doberman.md
• 动物 -> 爬行动物 -> 蜥蜴 -> _posts -> iguana.md, chameleon.md

我希望用户能够访问 /animals 并查看每个类别的每个帖子的列表。但是如果他们去/animals/mammals，他们只会看到哺乳动物。如果他们去/animals/mammals/cats，那么他们只会看到猫。

我知道我可以手动执行此操作，例如，将 index.html 文件放在每个目录中，然后循环通过 site.categories.mammals 或 site.categories.cats。

但这似乎有点太暴力了，我希望有更好的方法。如果我想更改显示列表的方式，我必须在每个子类别中进行更改。当子类别共享名称时，我也会遇到问题，例如 /ABC/XYZ/_posts/one.md 和 /DEF/XYZ/_posts/two.md。

我尝试关注this 文章，该文章使用一个主要的category.html 页面循环通过page.category：

{% for post in site.categories.[page.category] %}
  <h2><a href=""></a></h2>
  <p></p>
{% endfor %}

然后每个index.html 文件都使用它作为它的布局。这几乎可行，但似乎仅限于一个类别，而不是多个层次类别。

在为分层类别创建列表时，是否有一种不那么暴力的方法？

Answer 1

page.categories 是一个列表

https://stackoverflow.com/a/23927986

{% for cat in page.categories %}
  <h1>{{ cat }}</h1>
  <ul>
    {% for post in site.categories[cat] %}
      <li><a href="{{ post.url }}">{{ post.title }}</a></li>
    {% endfor %}
  </ul>
{% endfor %}

来自 jekyll 关于 page.category http://jekyllrb.com/docs/variables/#page-variables 的文档

此帖子所属的类别列表。类别是 源自 _posts 目录上方的目录结构。为了 例如，/work/code/_posts/2008-12-24-closures.md 上的帖子会 此字段设置为 ['work', 'code']。这些也可以在 YAML 前端。

您应该能够轻松地向每个文件夹添加一个简单的动态 index.html，并且类别应该自动分层。

更新

上述方法不起作用。您需要将每个层次结构的类别组合视为唯一项目。连接索引页面的类别，并将其与网站中的所有帖子进行比较。

/foo/bar/_posts/2016-08-01-foo-bar-test.html

---
categories:
  - foo
  - bar
title: test foo bar
---

<h2>Foo Bar</h2>

/var/bar/_posts/2016-08-01-test-var-bar.html

---
categories:
  - var
  - bar
title: test var bar
---

<h2>Var Bar</h2>

/foo/bar/index.html

---
categories:
 - foo
 - bar
---

{% assign pagecat = page.categories | join ' ' | append: ' '%}
{% assign pagecatlen = page.categories.size %}
  <h1>{{ cat }}</h1>
  <ul>
    {% for post in site.posts %}
    {% assign postcat = '' %}
    {% for thispostcat in post.categories limit: pagecatlen %}
      {% assign postcat = postcat | append: thispostcat %}
      {% assign postcat = postcat | append: ' ' %}
    {% endfor %}

    {% if (postcat == pagecat) %}
      <li><a href="{{ post.url }}">{{ post.title }}</a></li>
    {% endif %}
    {% endfor %}
  </ul>

_posts 中的文件的类别是可选的，但对于每个索引文件的前端，它们是必需的。

Answer 2

相应地修改你的 _config.yml

collections:
    animals:
        output: true
        mammals:
            output: true
            cats:
                output: true
            dogs:
                output: true
        reptiles:
            output: true
            lizards:
                output: true

然后创建结构：

mkdir -p _animals/reptiles/lizards
mkdir -p _animals/mammals/cats
mkdir _animals/mammals/dogs

添加您的 md 文件和所有 index.html，它们将使用过滤器索引项目。它应该看起来像这样（可能有更多索引）：

_animals/
├── index.html
├── mammals
│   ├── cats
│   │   ├── housecat.md
│   │   └── tiger.md
│   ├── dogs
│   │   ├── doberman.md
│   │   └── poodle.md
│   └── index.html
└── reptiles
    └── lizards
        ├── chameleon.md
        └── iguana.md

然后你创建_includes/list_animals.html

{% assign animals = site.animals| sort:'title' %}
{% for animal in animals %}
{% if page.url != animal.url  and include.taxonomy == nil or animal.url contains include.taxonomy %}
<a  href={{ animal.url | prepend: site.baseurl }}>{{animal.title}}</a>
{% endif %}
{% endfor %} 

列出animals/index.html 中的所有动物：

---
title: animals
---
{% include list_animals.html %}

例如，列出animals/mammals/index.html 中的所有哺乳动物：

---
title: animals
---
{% include list_animals.html taxonomy="mammals" %}

最后生成的结构应该是这样的（还有一些 index.html）：

_site
└── animals
    ├── index.html
    ├── mammals
    │   ├── cats
    │   │   ├── housecat.html
    │   │   └── tiger.html
    │   ├── dogs
    │   │   ├── doberman.html
    │   │   └── poodle.html
    │   └── index.html
    └── reptiles
        └── lizards
            ├── chameleon.html
            └── iguana.html