在Jekyll(即Markdown)中,可以在链接之间共享集合URL的基本部分吗?

时间:2014-09-25 03:52:30

标签: markdown jekyll jekyll-extensions

The MD syntax允许两种基本的链接方式:[title](link)[title][reference][reference]可以在文档中多次使用,但它仅适用于绝对URL。

如果我正在编写代码博客并经常引用API文档,那么会有很多网址开始相同,例如,http://developer.android.com/reference/android/作为http://developer.android.com/reference/android/content/Context.html的基础。有没有办法模块化这样的链接?

除了Markdown之外还有另外一个与Jekyll兼容的选择吗?一个插件?这似乎是一种普遍的需求。

相关:How to set a base url for markdown links in IPython?

1 个答案:

答案 0 :(得分:2)

我个人使用链接库(包含),我可以在任何帖子或页面中使用。

注意:如果站点不在域的根目录(例如:localhost /或example.com/)       并且存在于我们需要的子文件夹(例如:localhost / subfolder /)中       使用 site.baseurl

的值预先添加内部链接
<!--- file : _includes/_links_library.markdown --->

<!--- POSTS --->
[welcome]: {{site.baseurl}}{% post_url 2014-09-09-welcome-to-jekyll %}

<!--- PAGES --->
[index]: {{site.baseurl}}/subfolder/
[file]: {{site.baseurl}}/subfolder/file.html

<!--- EXTERNAL PAGES --->
[jekyll]: http://jekyllrb.com/

<!--- ANDROID API REF --->
{% assign androidRef = "http://developer.android.com/reference/android" %}
[context]: {{ androidRef }}/content/Context.html

然后我们必须包含我们的库以使用这样的链接:

---
front matter
---

Link to [welcome post][welcome]
Link to [index][]
Link to [Jekyll doc][jekyll]

{% include _links_library.markdown %}