首页 文章

jekyll markdown内部链接

提问于
浏览 次
120

Jekyll使用Markdown格式的链接，但我如何链接到内部内容？

[[link]]
markdown jekyll

5 回答

  • 25

    您现在可以使用以下内容发布内部链接：

    [Some Link]({% post_url 2010-07-21-name-of-post %})

    这也在Jekyll Documentation中引用 .

    https://github.com/mojombo/jekyll/pull/369

    回复于
  • 3

    对于页面，they decided not to add a page_url tag因为您无论如何都必须知道页面的路径 . 所以你只需要手动链接到它：

    [My page](/path/to/page.html)

    或者，如果您想以编程方式获取页面 Headers ，则可以执行大而丑陋的操作：

    {% for page in site.pages %}
  {% if page.url == '/path/to/page.html' %}
[{{ page.title }}]({{ page.url }})
  {% endif %}
{% endfor %}
    回复于
  • 6

    现在可以使用 link 标记链接到帖子以外的页面 . link 适用于帖子，页面，集合中的文档和文件 .

    {{ 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 标记时，请记住包含文件扩展名 . 要用它来创建链接：

    [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 Documentation .

    回复于
  • 221

    在Jekyll中有多种链接方式，其中一些现在已经过时了 .

    带链接标签

    建议的链接到内部文件的方法是

    [Link]({{ site.baseurl }}{% link path/to/file.md %})

    请注意，如果文件移动或被删除，这将导致错误 .

    永久链接

    链接到页面而不会导致错误（改为链接断开）：

    [Link]({{ '/path/to/page/' | relative_url }})

    请注意，在这里您需要知道页面的永久链接并将其传递给 relative_url 过滤器，以确保它以站点的基本URL为前缀 .

    页面的永久链接取决于配置文件中的 permalink 设置和文件前面的 permalink 键 .

    如果你想使用相对路径（并希望链接在GitHub的降价视图中工作），你应该使用jekyll-relative-links . 这可以让你编写如下链接：

    [Link](./path/to/file.md)

[Link to file in parent folder](../file.md)
    回复于
  • 22

    如果内部内容位于同一页面上，则可以使用 auto_ids 功能链接到该内容 . 您在 _config.yml 中启用此功能：

    kramdown:
    auto_ids: true

    启用此功能后，每个 Headers 将根据 Headers 文本获取 id ref . 例如

    ### My Funky Heading

    会变成

    <h3 id="my-funky-heading">My Funky Heading</h3>

    您可以通过执行以下操作从同一文档中链接到此：

    The funky text is [described below](#my-funky-heading)

    如果您愿意，可以指定显式ID：

    ### My Funky Heading
{: #funky }

    并链接到它

    The funky text is [described below](#funky)
    回复于

相关问题