在GitHub上如何链接到其他维基页面?

239

GitHub的Wiki允许您像这样链接到Wiki中的其他页面:

[[Wiki Page Name]]

然而,我希望在创建链接时显示不同于维基页面名称的文本。是否有方法可以实现这一点?我链接维基页面的方式是否不正确?


2
虽然Markdown不是一种编程语言,但我们在StackOverflow上有很多标记为XML(另一种标记语言)的问题。我没有检查,但我敢打赌也有一些关于数据交换格式如JSON的问题。为什么不允许这个问题呢? - Jasper Blues
5个回答

334

使用Markdown链接语法

[Link Text](WikiPage)
似乎在编辑预览中有效,但在实际的维基页面上无效。至少对我来说,生成的链接是WikiPage而不是wiki/WikiPage,因此我遇到了著名的GitHub 404错误。
然而,这里提供了MediaWiki语法。
[[Link Text|WikiPage]]

对我来说有效,甚至适用于Markdown维基页面。


6
如果链接文本和维基页面名称相同,您可以直接使用:[[我美妙的维基页面]]。这将链接到wiki/My-Wonderful-Wiki-Page - Jimothy
7
好的,[[链接文字|维基页面]] 对我有效。请编辑您的回答。 - Anton Danilchenko
2
这里是一个引用添加链接到维基的参考。 - Ricardo
3
请注意,截至2019年3月,虽然MediaWiki语法可以用于链接,并将纯文本作为链接文本,但它在解析任何格式的链接文本时(无论是Markdown还是MediaWiki语法)都会出现错误。例如,[[描述 `foo` 的内容|Foo]]将呈现源标记(代码格式),而不是预期的链接。如果有人知道解决此问题的方法,请告诉我。 - Jeff Dickey
1
要在另一页中的标题上添加链接,请使用以下语法:[[链接文本|维基页面#标题以小写字母表示,空格用连字符代替]]。请注意,标题文本必须全部小写,任何大写字母都会破坏链接。 - undefined
显示剩余4条评论

99

GitHub默认使用Markdown语法来编写Wiki页面,因此您可以直接这样做:

GitHub用Markdown语法来编写维基百科,所以您只需:

[Arbitrary Link Text](Wiki Page Name)

查看Markdown这篇博客文章获取更多关于他们的维基和其他标记语法支持的信息。

当你在首页时,这种解决方案会创建相对URL存在问题。请查看下面Sven的回答


31
@Sven的答案是正确的,而这个答案是错误的。 - Jon Cram
26
这会创建一个相对 URL 链接,所以如果你恰好在与你想要链接的页面相同的目录中,它就能够工作;否则,它不行。具体来说,如果你在首页(http://.../project_name/wiki),这个链接是行不通的,因为所有其他页面都在 wiki 目录下,而首页不在。 - mltsy
4
如果出现错误需要进行修正,同时需要更新以包含此主题中的最新评论,届时我将会改为赞同。 - Merlyn Morgan-Graham
10
是的,[[Link Text|WikiPage]] 对我有效。请将其添加到您的回答中。 - Anton Danilchenko
7
截至2014年5月,GitHub上似乎已经修复了这个问题。现在该答案适用于所有页面。但预览仍然存在问题。 - drhagen
显示剩余5条评论

41

internal-ref 部分是相对于您的项目而言的。对于维基页面,请使用:

[Page Name](wiki/Page-Name)

在预览时链接会失效,但保存页面后就会生效。


2
可行,但Sven的答案更好。 - Ulrich Stern
5
在自定义侧边栏中使用时会出现问题,如果您导航到其中一个链接,例如 wiki/Page-Name,那么在 wiki/Page-Name 页面的侧边栏中,链接将被打破,具有双重 wiki 元素,如 wiki/wiki/Page-Name - Matt
这个在<html>...</html>标签内不起作用,而[[链接文本|页面名称]]则可以。 - Paul Wintz
当我包含“wiki/”时,生成的链接会包括“wiki/wiki/Page-Name”。 - Paul Wintz

2
  • 最常见的用法是[链接文本](维基页面URL)
  • 第二种方式:[[链接文本|维基页面URL]]
  • 第三种方式,如果你不想重复并且需要多次使用超链接:[链接文本],在页面末尾使用一次[链接文本]:维基页面URL

-8

查看维基编辑器的帮助。它会告诉你:

要创建引用链接,请使用两组方括号。[我的内部链接][内部引用]将链接到内部引用内部引用


2
我也看到了,但它不起作用,因为 - 正如cbley所提到的 - Markdown要求在内部引用周围加上圆括号。我想知道为什么帮助文档包含错误信息。 - Ethan Leroy
2
维基的帮助编辑器确实如此说,但在这种情况下,“内部引用”指的是页面内的Markdown引用,而不是同一维基中的另一页。有关更多信息,请参见Markdown链接语法 - Calrion

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接