【发布时间】:2016-04-20 15:51:56
【问题描述】:
这是我的问题: 我想写一个 GitHub wiki,其中指向其他页面的超文本链接是绝对路径(我有子文件夹等。在我的情况下,这样会更容易)。
即\[label](https://github.com/repo/../fileName.md)。
当我点击链接时,它会指向正确的页面,但没有任何 Markdown 格式的解释。我怎样才能编写这个链接,以便它会导致一个解释页面?
【问题讨论】:
这是我的问题: 我想写一个 GitHub wiki,其中指向其他页面的超文本链接是绝对路径(我有子文件夹等。在我的情况下,这样会更容易)。
即\[label](https://github.com/repo/../fileName.md)。
当我点击链接时,它会指向正确的页面,但没有任何 Markdown 格式的解释。我怎样才能编写这个链接,以便它会导致一个解释页面?
【问题讨论】:
我刚刚得到了答案:
如果我们希望文件被解释为 Markdown 文件,我们不需要任何文件路径。只需写下名称,其余的由 GitHub wiki 完成。一旦您编写了路径(相对或绝对),GitHub 会将其解释为 raw.githubusercontent。
【讨论】:
当使用位于https://github.com/<org>/<repo>/wiki/... 下方的路径链接到 GitHub wiki 中的另一个页面时,您必须省略任何额外的路径信息以及 .md 扩展名并仅使用文件名。
如果您包含 .md 扩展名,GitHub 将提供原始文本。如果您不使用扩展名,则文件将呈现为 HTML。
此行为仅适用于链接到另一个页面。当链接到 图像 时,行为是不同的;您必须包含任何额外的路径信息和/或文件扩展名。
例如[API Reference](API-Reference) 等同于 https://github.com/<org>/<repo>/wiki/API-Reference 并且可以链接到 https://github.com/<org>/<repo>/wiki/api/API-Reference.md 文件中描述的页面 - 尽管后一个链接将返回原始文件内容。
如果您链接到当前 GitHub wiki 之外的页面,则行为再次不同。例如即使带有.md 扩展名,repo 本身中的 README.md 文件也会呈现为 html。 (事实上,我怀疑如果您不使用扩展名,链接是否会起作用。)原因是它是一个 wiki 功能,允许您在没有扩展名的情况下处理文件。 wiki 无法影响外部网页的呈现行为。
【讨论】: