【发布时间】:2020-05-31 21:08:43
【问题描述】:
我正在尝试使用 github 页面使用 markdown 文档创建一个简单的文档网站。
目录结构为:
root
|-- index.md
+-- _topic
|-- doc1.md
|-- doc2.md
|-- ...
+-- docn.md
index.md 文件内容:
---
title: TOC
---
{% for topic in site.topics %}
* [{{topic.title}}]({{topic.url}}]
{% endfor %}
我期待生成的 html 将包含一个超链接列表,因为 markdown 使用 []() 作为超链接。相反,我在 Jekyll 生成的 index.html 中看到以下内容:
<ul>
<li>
<p>[doc1_title](/topics/doc1.html]</p>
</li>
<li>
<p>[doc2_title](/topics/doc2.html]</p>
</li>
...
<li>
<p>[docn_title](/topics/docn.html]</p>
</li>
</ul>
任何想法我在这里做错了什么?
【问题讨论】:
-
必须有右括号而不是右括号。也许您正在寻找 {{page.path}} 而不是 url。
-
非常感谢,这确实解决了我的问题,但现在 url 指向 markdown 文件而不是生成的 doc.html 文件。
-
我认为问题出在括号上,对吗? Url 不应该指向 md 文件,但路径应该指向。改回来就好了。
-
是的,问题出在支架上。但是, url 也不会产生正确的结果,因为它没有产生相对路径。在 github 页面中,这是为一个 repo 托管的,它产生一个像 https://
.github.io/ /index.html 这样的 URL。无论如何这里是 github repo,github.com/kkibria/dev_cookbook,请随时 fork 并尝试 :) 非常感谢您的帮助。 -
获取相对 URL 的方法:{{page.url |相对网址}}