jekyll markdown内部链接
Jekyll使用Markdown格式的链接,但是如何链接到内部内容?
[[link]]
您现在可以使用以下内容发布内部链接:
[Some Link]({% post_url 2010-07-21-name-of-post %})
这也在Jekyll文档中被引用。
对于页面, 他们决定不添加page_url
标签,因为无论如何你必须知道页面的path。 所以你只需要手动链接到它:
[My page](/path/to/page.html)
或者,如果你想以编程方式获得页面的标题,你可以做这样一个大而难看的东西:
{% for page in site.pages %} {% if page.url == '/path/to/page.html' %} [{{ page.title }}]({{ page.url }}) {% endif %} {% endfor %}
现在可以使用link
标记链接到post以外的页面。 link
适用于post,页面,集合中的文档和文件。
{{ site.baseurl }}{% link _collection/name-of-document.md %} {{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %} {{ site.baseurl }}{% link news/index.html %} {{ site.baseurl }}{% link /assets/files/doc.pdf %}
请记住在使用link
标记时包含文件扩展名。 用它来创build一个链接:
[Link to a document]({{ site.baseurl }}{% link _collection/name-of-document.md %}) [Link to a post]({{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %}) [Link to a page]({{ site.baseurl }}{% link news/index.html %}) [Link to a file]({{ site.baseurl }}{% link /assets/files/doc.pdf %})
查看Jekyll文档 。
在Jekyll中有多种连接方式,其中一些现在已经过时。
带有链接标签
链接到内部文件的推荐方式是
[Link]({{ site.baseurl }}{% link path/to/file.md %})
请注意,如果文件移动或被删除,这将导致错误。
永久链接
链接到一个页面而不会导致错误(改为断开的链接):
[Link]({{ '/path/to/page/' | relative_url }})
请注意,在这里您需要知道页面的固定链接,并通过relative_url
filter将其传递,以确保它以该网站的基本url为前缀。
一个页面的permalink
取决于你的configuration文件中的permalink
设置和文件前端的permalink
。
与jekyll相关链接
如果你想使用相对path(并希望链接在GitHub的markdown视图中工作),你应该使用jekyll-relative-links
。 这可以让你写下如下链接:
[Link](./path/to/file.md) [Link to file in parent folder](../file.md)