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

197

Закрыто. Этот вопрос не по теме . В настоящее время он не принимает ответы.

Хотите улучшить этот вопрос? Обновите вопрос, чтобы он соответствовал теме переполнения стека.

Закрыто 7 лет назад .

Вики 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 для получения дополнительной информации.

— Калрион