В: есть ли в asciidoc компактный синтаксис ссылок? Как [[page name]]
, где цель ссылки определяется текстом ссылки?
--- + ПОДРОБНЕЕ
Большинство вики имеют очень простой и компактный синтаксис для ссылок на разные страницы одной и той же вики.
Например. исходный WikiWikiWeb использовал CamelCase
- слова, которые были CamelCase, автоматически были ссылками.
Например. многие вики приняли синтаксис типа двойных квадратных скобок для обозначения [[link to a page]]
. Обычно фактическое имя целевой страницы получается из текста ссылки с помощью преобразований, таких как замена пробелов на _underscore, -dash, + плюс или полное кодирование URI.
Вики-сайты, связанные с репозиториями проектов Github, поддерживают синтаксис двойной квадратной скобки - с дополнительной функцией поиска по последовательности суффиксов файлов, .md / markdown, .asciidoc / :-) и т. Д., Что позволяет одной и той же вики содержать написанные страницы в разных наценках. Для всех поддерживаемых вариантов разметки, кроме asciidoc, в котором уже используются двойные квадратные скобки для целей ссылок или якорей.
К сожалению, AFAICT полуформальные документы GitHub Flavored Markdown, такие как https://github.github.com/gfm/#links не описывают этот компактный синтаксис с двойными скобками и, возможно, как следствие, не описывают и инструмент преобразования GFM в asciidoc kramdoc.
В: есть ли в asciidoc компактный синтаксис ссылок?
AFAIK, ссылки AsciiDoc должны указывать как текст ссылки, так и цель, причем наиболее компактной формой является относительная ссылка link:Page-Name.html[Page-Name]
. Это избыточно, если текст ссылки и базовое имя страницы совпадают.
(Кроме того, asciidoc делает текст ссылки и таргетинг одинаковым, если он выглядит как ссылка: https://asciidoctor.org. )
Если на то пошло, есть ли в Markdown официальный синтаксис компактных ссылок, понятный для kramdown / kramdoc? Или это отсутствие причины, по которой вики GitHub поддерживает двойные квадратные скобки [[page name]]
?
--- + ПОНТИФИКАЦИЯ
ИМХО самые важные особенности вики - это
быстро и легко редактируется в Интернете
быстрое и простое компактное представление ссылок, так что разметка вики почти так же удобочитаема, как если бы ссылки там не было
ссылки на страницы, которые еще не существуют, разрешены и выделяются, побуждая вас нажать на них и начать просмотр
то есть ссылки, которые легко написать, легко найти и легко создать.
Я был бы очень разочарован, если официальные Markdown и AsciiDoc не поддерживают такие компактные ссылки. тем более, что меня заставляют использовать AsciiDoc на работе.
AFAICT AsciiDoc поддерживает компактные <<intra-document>>
ссылки или перекрестные ссылки, часто с целевыми привязками, созданными неявно из текста заголовка раздела. Но ссылки AFAICT между разными вики-страницами или документами вынуждены быть более подробными.
В этом отношении я также жалуюсь, что на вики-странице GitHub на вики-странице .asciidoc ссылки на страницы, которые еще не существуют, не отличаются от страниц, которые уже существуют.