链接到 GitHub 上的其他 Wiki 页面？答案

【问题标题】：Linking to other Wiki pages on GitHub?链接到 GitHub 上的其他 Wiki 页面？
【发布时间】：2022-05-11 22:30:55
【问题描述】：

GitHub wiki 允许您链接到 wiki 中的其他页面，如下所示：

[[Wiki Page Name]]

但是，我想在创建链接时显示与 wiki 页面名称不同的文本。有没有办法做到这一点？我链接到 wiki 页面是否都错了？

【问题讨论】：

虽然 markdown 不是一种编程语言，但我们在 StackOverflow 上有很多标记为 XML（另一种标记语言）的问题。我没有检查，但我敢打赌有一些像 JSON 这样的数据交换格式。为什么不允许这个问题？

标签： github

【解决方案1】：

使用 Markdown 链接语法

[Link Text](WikiPage)

似乎在编辑预览中有效，但在实际的 wiki 页面上无效。至少对我来说，生成的链接是WikiPage 而不是wiki/WikiPage，我得到了著名的GitHub 404。

但是 MediaWiki 语法

[[Link Text|WikiPage]]

适用于我，甚至适用于 Markdown wiki 页面。

【讨论】：

这似乎一直有效，即使它不在 Github 的标记文档中。请参阅我对 @cbley 的回答的评论，了解为什么他的解决方案有时似乎有效，但在其他情况下无效。
另外，如果链接文本和Wiki页面相同，您可以简单地使用：[[My Wonderful Wiki Page]]。这将链接到wiki/My-Wonderful-Wiki-Page。
是的，[[Link Text|WikiPage]] 为我工作。请编辑您的答案
这里引用Add links to wikis
请注意，截至 2019 年 3 月，虽然 MediaWiki 语法适用于以 纯文本 作为链接文本的链接，但当被要求解析任何格式的链接文本时，它会中断，无论是 Markdown 还是 MediaWiki 语法。例如，``` [[Description of foo|Foo]] ``` 将呈现（代码格式的）源标记，而不是预期的链接。如果有人知道解决此问题的方法，请告诉我。

【解决方案2】：

GitHub 默认使用Markdown wiki 语法，因此您可以这样做：

[Arbitrary Link Text](Wiki Page Name)

查看 Markdown 和 this blog post 了解有关他们的 wiki 和他们支持的其他标记语法的更多信息。

当您在主页上时，此解决方案会出现问题，因为它会创建相对 URL。查看下面的Sven's answer。

【讨论】：

@Sven 的答案是正确的，这个答案是错误的。
这会创建一个相对 url 链接，因此如果您碰巧与您尝试链接到的页面位于同一目录中，则它可以正常工作，否则不会。具体来说，如果您在主页 (http://.../project_name/wiki) 上，这将不起作用，因为所有其他页面都在 wiki 目录中，而主页不在。
-1 因为它坏了；需要更新以包含对此线程的最后评论，我将更改为 +1。
是的，[[Link Text|WikiPage]] 为我工作。请添加到您的答案中
截至 2014 年 5 月，这似乎已在 GitHub 上得到修复。这个答案现在适用于所有页面。但是，预览仍然损坏。

【解决方案3】：

internal-ref 部分与您的项目相关。对于 wiki 页面，请使用：

[Page Name](wiki/Page-Name)

在预览中链接会被破坏，但当页面保存时它会起作用。

【讨论】：

有效，但 Sven 的回答效果更好。
在自定义侧边栏中使用时会出现问题，如果您导航到其中一个链接，例如 wiki/Page-Name，然后在 wiki/Page-Name 页面的侧边栏中，链接会被破坏并出现双wiki 类似 wiki/wiki/Page-Name 的元素。

【解决方案4】：

查看 wiki 编辑器的帮助。它告诉你：

要创建参考链接，请使用两组方括号。 [my internal link][internal-ref] 将链接到内部引用 internal-ref。

【讨论】：

我也看到了，但它不起作用，因为 - 正如 cbley 所提到的 - Markdown 需要内部参考周围的圆括号。我想知道为什么帮助包含错误的信息。
wiki 的帮助编辑器确实这么说，但在这种情况下，“内部参考”指的是页面内 Markdown 参考，而不是同一 wiki 中的另一个页面。请参阅Markdown link syntax 了解更多信息。