Ссылки (<link>) позволяют при нажатии на текст внутри них переходить на указанную в разметке статью.

При этом текст внутри ссылки и заголовок статьи, на которую осуществляется переход, не обязаны быть как-то связаны (как и в обычных html ссылках): можно сделать так, чтобы по нажатию на текст транскрипции открывалась статья “How to use to dictionary”

Примеры ссылок:

<link list_entry_id="add_art_about" label="pronunciation"><phonetics>/bɔːks/</phonetics></link>
...
<link list_entry_id="irregular_words_list" link_type="1"><img url="irreg.svg" show_width="48" show_height="24" /></link>
  • list_entry_id – id записи списка (атрибута “id” у <article>), на которую нужно перейти при нажатии на текст ссылки
  • label – метка, к которой нужно в момент загрузки подмотать текст открываемой статьи
  • title – позволяет сделать аннотацию к контенту внутри ссылки (например, определенный текст, который отображался бы при наведении курсора на ссылку на десктопе)
  • link_type – в случае, когда list_entry_id ведет на папку, указывает, нужно ли перейти к ней и постараться отобразить его перевод (значение “0”, используется по умолчанию), не заходя при этом внутрь, или же следует перейти внутрь папки для отображения содержимого (“1”). Варианты перехода более детально разобраны в этой статье
  • dictid – DictID (4-символьный, т.е. без расширения “.sdc”) словарной базы, в которой нужно искать целевую статью; несовместим с атрибутом list_entry_id (т.к. он напротив указывает на необходимость использовать текущую базу как источник данных)
  • listidx – индекс списка слов, в котором нужно искать статью для отображения контента всплывающего окна по ключу (описание ниже)
  • key – текстовый ключ, по которому нужно в словарной базе с DictID в списке с индексом listidx поискать статью и получить ее перевод для отображения во всплывающем окне. Предполагается, что значение ключа бинарно (посимвольно) совпадает с текстом одного из заголовков в этом списке

На практике атрибут title не применялся, но не является deprecated и может быть использован

На контент внутри <link> накладываются следующие ограничения:

  • как и в случае других метаданных, это не может быть непосредственно текст – он должен быть обёрнут в отдельный стиль (как “phonetics” на примере выше)
  • как и в случае других метаданных, подобных ссылкам, не допускается размещения одних ссылок внутри других (например, <popup_article> внутри <link> или <url>), т.к. это привело бы к неопределенности при нажатии на текст (непонятно, обрабатывать нажатие как переход по ссылке или как отображение во всплывающем окне).

If you have found a spelling error, please, notify us by selecting that text and pressing Ctrl+Enter.