Ссылки на другие вики-страницы на GitHub? [закрыто]

197

Вики GitHub позволяют вам ссылаться на другие страницы в вики, например:

[[Wiki Page Name]]

Тем не менее, я хочу отображать текст, отличный от имени страницы вики при создании ссылки. Есть ли способ сделать это? Я неправильно ссылаюсь на вики-страницы?

github TaylorOtwell
источник

Ответы:

86

GitHub по умолчанию использует синтаксис Markdown для вики, поэтому вы можете просто сделать:

[Arbitrary Link Text](Wiki Page Name)

Проверьте Markdown и этот пост в блоге для получения дополнительной информации об их вики и других синтаксисах разметки, которые они поддерживают.

Это решение имеет проблемы, когда вы находитесь на домашней странице, потому что оно создает относительные URL-адреса. Проверьте ответ Свена , ниже.

cbley
источник
24
@ Свен ответ правильный, этот ответ неправильный.
Джон Крам
23
Это создает относительную ссылку URL, поэтому, если вы оказались в том же каталоге, что и страница, на которую вы пытаетесь сослаться, она работает, в противном случае это не так. В частности, если вы находитесь на домашней странице (http: //.../project_name/wiki), это не будет работать, потому что все остальные страницы находятся в каталоге wiki, а домашняя страница - нет.
млцы
4
-1 так как ломается; Необходимо обновить, чтобы включить последний комментарий в этой теме, и я изменю на +1.
Мерлин Морган-Грэм
8
Да, [[Link Text|WikiPage]]у меня работает. Просьба добавить к вашему ответу
Антон Данильченко
5
По состоянию на май 2014 года это, похоже, было исправлено на GitHub. Этот ответ теперь работает на всех страницах. Тем не менее, предварительный просмотр все еще не работает.
drhagen
281

Использование синтаксиса ссылки Markdown

[Link Text](WikiPage)

кажется, работает в предпросмотре редактирования, но не на реальной вики-странице. По крайней мере , для меня генерируемая ссылка WikiPageвместо wiki/WikiPageи я получаю известный GitHub 404 .

Однако синтаксис MediaWiki

[[Link Text|WikiPage]]

работает для меня, даже для вики-страниц Markdown.

Свен Якобс
источник
4
Кроме того, если текст ссылки и Wiki страницы одинаковы, вы можете просто использовать: [[My Wonderful Wiki Page]]. Это будет ссылка на wiki/My-Wonderful-Wiki-Page.
Джимоти
7
Да, [[Link Text|WikiPage]]у меня работает. Прошу отредактировать ваш ответ
Антон Данильченко
6
Это определенно должен быть принятый ответ.
Кенни Кейсон
1
Вот ссылка для добавления ссылок на вики
Ricardo
1
Обратите внимание, что по состоянию на март 2019 года, хотя синтаксис MediaWiki работает для ссылок с простым текстом в качестве текста ссылки, он прерывается, когда его просят проанализировать текст ссылки с любым форматированием, будь то синтаксис Markdown или MediaWiki. Например, `` `[[Description foo| Foo]]` `` будет отображать (в формате кода) исходную разметку, а не предполагаемую ссылку. Если кто-нибудь знает способ обойти это, пожалуйста, дайте мне знать.
Джефф Дики
29

Внутренние иая часть относительно вашего проекта. Для вики-страниц используйте:

[Page Name](wiki/Page-Name)

В предварительном просмотре ссылка будет разорвана, но при сохранении страницы она будет работать.

Brett
источник
1
Работает, но ответ Свена работает лучше.
Ульрих Стерн,
4
Существует проблема с этим при использовании внутри пользовательской боковой панели, если вы переходите к одной из своих ссылок, например wiki/Page-Name, в wiki/Page-Nameбоковой панели страницы, ссылки нарушаются с двойным wikiэлементом, как wiki/wiki/Page-Name.
Мэтт
-7

Проверьте помощь редактора вики. Это говорит вам:

Чтобы создать ссылку, используйте два набора квадратных скобок. [my internal link][internal-ref]будет ссылаться на внутреннюю ссылку internal-ref.

Tekkub
источник
2
Я также видел это, но это не работает, потому что - как упомянул cbley - Markdown требует круглых скобок вокруг internal-ref. Интересно, почему помощь содержит неверную информацию.
Итан Леруа
2
Редактор справки вики действительно говорит это, но «внутренняя ссылка» в данном случае относится к внутренней ссылке Markdown, а не к другой странице в той же вики. См. Синтаксис ссылки Markdown для получения дополнительной информации.
Калрион