[функция] anchor-a, aa

Сигнатура

anchor-a link &key class target content text suffix

aa link &key class target content text suffix

Пакет

ystok.help

Аргументы
link
Строка или объект типа ystok.uri:uri, представляющий гибкую ссылку.
Если в строке не указаны ни схема help:, ни знак #, то строка трактуется как якорь, т.е. она целиком считается фрагментом, а не путём, и подразумевает схему help.
class
Имя CSS-класса, который будет приписан элементу A.
target
позволяет уточнить исходный файл фрагмента, на который ссылается якорь:
"_popup" означает искать только во всплывающих заметках,
"_self", "_parent" или другое непустое значение означает искать только в обычных статьях,
если не задан или nil, то искать везде.
content
LHTML список, задающий содержимое генерируемого элемента A.
text
Либо t, либо строка, явно задающая содержимое генерируемого элемента A.
suffix
Булево значение,
умолчание есть nil.
Значение

Если якорь найден в книге, то возвращается кусок HTML-кода, состоящий из элемента

<A [class="class"] [target="target"] href="ahref">content-or-text</A>

где ahref — спецификация целевой страницы и, возможно, фрагмента для якоря, вычисленная с помощью функции anchor-href, ahref.

Если в качестве class явно передаётся nil, то атрибут class не выдаётся.
Если class не задан, то по умолчанию в качестве значения атрибута class будут перечислены те классы, которые

Если text есть t, то содержимое будет плоским текстом, вычисленным с помощью функции anchor-text, atext.

Если оба аргумента content и text есть nil, то содержимое вычисляется исходя из определения якоря с помощью функции anchor-content, acontent.

Если значение suffix истино, к содержимому якоря присоединяются дополнительные свойства, нампример, category. Если значение suffix есть nil, вслед за содержимым ничего не выдаётся.

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

См.также