Динамический список ссылок

Назначение

Связывание шаблонных переменных на каждой итерации цикла по именам якорей.

Сигнатура

[функция] anchor-topics &rest anchors

[функция] atopics &rest anchors

Пакет

ystok.help

Аргументы

anchors: Список строк или объектов типа ystok.uri:uri, представляющих якоря, т.е. во внимание принимается только фрагмент.

Значение

Список ассоциативных списков, связывающих шаблонные переменные, для всех из указанных якорей, найденных в книге. Список отсортирован в "естественном" порядке вхождения статей в книгу.

Описание

Шаблон списка ссылок позволяет указать имена якорей и не требует спецификации файлов, где эти якоря находятся.

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

Примеры

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

<ul>
<!-- TMPL_LOOP (anchor-topics "help-scheme" "index-compiler") -->
<li><a href="{item-uri}" class="{item-class}" title="{item-description}">{item-content}</a></li>
<!-- /TMPL_LOOP -->
</ul>

Функция может вызываться в шаблоне из псевдо-элемента условной компиляции для проверки, нужно ли вставлять определённый код в результирующую страницу. Например:

<!-- TMPL_IF (anchor-topics "SLAVE-INTERFACE") -->
<tr>HTML-код, вставляемый, только если якорь 
 определён где-либо...</tr>
<!-- /TMPL_IF -->