[функция] anchor-href, ahref

Сигнатура

anchor-href link &key target

ahref link &key target

Пакет

ystok.help

Аргументы

link

Строка или объект типа ystok.uri:uri, представляющий гибкую ссылку.
Если в строке не указаны ни схема help:, ни знак #, то строка трактуется как якорь, т.е. она целиком считается фрагментом, а не путём, и подразумевает схему help.

target

позволяет уточнить исходный файл фрагмента, на который ссылается якорь:
"_popup" означает искать только во всплывающих заметках,
"_self", "_parent" или другое непустое значение означает искать только в обычных статьях,
если не задан или nil, то искать везде.

Значение

Если якорь найден в книге, то возвращается объект типа ystok.uri:uri, который может быть использован в качестве значения атрибута href HTML-элемента A. Результат есть спецификация целевой страницы и, возможно, включает якорь в качестве фрагмента.

Если якорь не найден в книге, возвращается nil, а в журнал пишется соответствующее предупреждение.