【问题标题】:In GitHub wiki, absolute links to Markdown leads to raw.githubusercontent在 GitHub wiki 中,指向 Markdown 的绝对链接指向 raw.githubusercontent
【发布时间】:2016-04-20 15:51:56
【问题描述】:

这是我的问题: 我想写一个 GitHub wiki,其中指向其他页面的超文本链接是绝对路径(我有子文件夹等。在我的情况下,这样会更容易)。

\[label](https://github.com/repo/../fileName.md)

当我点击链接时,它会指向正确的页面,但没有任何 Markdown 格式的解释。我怎样才能编写这个链接,以便它会导致一个解释页面?

【问题讨论】:

    标签: github markdown wiki


    【解决方案1】:

    我刚刚得到了答案:

    如果我们希望文件被解释为 Markdown 文件,我们不需要任何文件路径。只需写下名称,其余的由 GitHub wiki 完成。一旦您编写了路径(相对或绝对),GitHub 会将其解释为 raw.githubusercontent。

    【讨论】:

    • 很高兴您找到了问题的答案 :) 但只是为了让人们可以看到此问题已得到解答,请将您的评论标记为您问题的答案。
    【解决方案2】:

    当使用位于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 无法影响外部网页的呈现行为。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 2021-01-10
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2012-09-12
      • 2023-03-12
      • 2010-11-10
      相关资源
      最近更新 更多