❗ Вебсайт в стадии бета-тестирования. Возможны ошибки.
Справочники
Инженерия
Goldmark
Гиперссылка

Гиперссылка

Классификация гиперссылок

Различают следующие виды гиперссылок:

  • внутренние ссылки;
  • внешние ссылки.

Внутренняя ссылка

Внутренняя ссылка устанавливает отношения между фрагментами гипертекста внутри вебсайта.

Внешняя ссылка

Внешняя ссылка устанавливает отношения с вебстраницами сторонних вебсайтов.

Пример оформления внешней ссылки:

[link](http://example.ru)

Пример оформления внешней ссылки с наименованием внешнего ресурса:

[link](http://example.ru "Наименование ресурса")

Внешняя ссылка с идентификатором

Если в тексте множество ссылок на один и тот же внешний ресурс, то целесообразно указать этот ресурс всего один раз в примечании под текстом.

Идентификатор (#id) может содержать буквы, цифры, пробелы и знаки препинания. Регистр не имеет значения.

Пример оформления ссылки в тексте:

[link](#id 1)

В любом месте текста, ниже пустой строки следует расшифровать идентификатор. Обычно такие примечания располагают в конце текста.

[id 1]: http://example.ru/ "Наименование внешнего ресурса"

Автоматическая внешняя ссылка

Goldmark позволяет автоматизировать разметку внешних гиперссылок, чем значительно облегчает труд автора гипертекста.

Автоссылка — абсолютные адреса URI и адреса электронной почты, которые служат идентификатором ссылки при автоматическом преобразовании в код HTML.

Правила оформления автоссылки:

  • Ссылку помечают угловыми скобками. Начинают символом < и завершают символом >. Между угловыми скобками и URI недопустимы пробелы!
  • Между угловыми скобками помещают абсолютный URI или почтовый адрес (email).
  • Абсолютный URI и почтовый адрес:
    • Содержит не менее 2 символов и не более 32 символов в кодировке ASCII.
    • Может включать пробелы в виде %20, символы плюс (+), точка (.) и дефис (-).
    • Не должен содержать экранирования символов. Обратная косая черта (\) — недопустима!
    • Нечувствительный к регистру. Допустимо написание <HTTP://EXAMPLE.RU> или <MAILTO:INFO@EXAMPLE.RU>.

Примеры неправильной, автоссылки. Подобные записи приводят к ошибке при генерации гиперссылки.

< http://example.ru >&#8239;&mdash;&thinsp;пробелы между угловыми скобками и адресом
http://example.ru&#8239;&mdash;&thinsp;отсутствуют угловые скобок
info@example.ru&#8239;&mdash;&thinsp;отсутствуют угловые скобок
<info.example.ru>&#8239;&mdash;&thinsp;отсутствует указание на протокол 'http://'

Пример правильной внешней ссылки.

<http://example.ru>

При публикации размеченный текст даст следующий HTML код:

<p><a href="http://example.ru">http://example.ru</a></p>

Пример внешней ссылки с запросом.

<http://example.ru/test?q=hello&id=22&boolean>

При публикации размеченный текст даст следующий HTML код:

<p><a href="http://example.ru/test?q=hello&amp;id=22&amp;boolean">http://example.ru/test?q=hello&amp;id=22&amp;boolean</a></p>

Пример внешней ссылки с почтовым адресом.

<info@example.ru>

При публикации размеченный текст даст следующий HTML код:

<p><a href="mailto:info@example.ru">info@example.ru</a></p>
ВыноскаГлифы