如何在 Liquid (Jekyll) 中获取页面的 url

Question

我正在使用 Github 页面 (Jekyll) 编写文档，并且在其中一个页面中我想链接到另一个页面。我尝试使用{% page_url post-name %}但没有运气。当我运行时，出现bundle exec jekyll serve此异常：

Liquid Exception: no implicit conversion of nil into String in docs/page1.md

我的帖子在子目录中docs，我的文档结构如下所示：

CNAME
_config.yml
_includes/
_layouts/
_site/
css/
docs/
   page1.md
   page2.md
   page3.md
imgs/
js/
index.md

配置文件包含：

safe: true
lsi: false
pygments: true
markdown: kramdown

docs/子目录中的所有页面都包含 YAML 块：

---
layout: docs
title: Page Two
permalink: /docs/page2/
---

现在，我尝试获取此页面的 url page2：

{% page_url page2 %}
{% page_url docs/page2 %}
{% page_url /docs/page2/ %}
{% page_url /docs/page2.md/ %}

这些都不起作用，我仍然得到Liquid Exception.

那么在子目录中获取页面 url 的正确方法是什么？

Answer 1

使用通用链接标签：{% link _collection/name-of-document.md %}

所以，像 {% link docs/page2.md %}

Answer 2

你应该使用 `{% post_url %}' 标签，例如：

{% post_url 2010-07-21-name-of-post %}