Ссылки
GetSelfLink
Модуль: smeretags/substfields.php (доступен по умолчанию)
Параметры: нет.
Назначение: генерирует ссылку на ту вершину, в контексте которой исчисляется смеретег. Текстом ссылки выступает результат вызова метода DocTitle для вершины.
Пример вызова: <Smereka Func="GetSelfLink" />
Пример результата: <a href="https://www.m-zharkikh.name/uk/Smereka/Smeretags/Links.html">Ссылки</a>
GetURL
Модуль: smeretags/substfields.php (доступен по умолчанию)
Параметры: [NodeId] [URLMode] [Query] [Fragment]
Назначение: генерирует URL для вершины.
Необязательный параметр NodeId задает ид вершины, для которой надо вычислить URL. Если этот параметр не задан, URL вычисляется для контекстной вершины.
Необязательный параметр URLMode задает режим формирования адреса. Если этот параметр не задан, URL вычисляется с использованием текущего режима формирования адресов.
Необязательный параметр Query задает строку параметров, которые надо присоединить к адресу (по умолчанию – пустая строка).
Необязательный параметр Fragment задает название фрагмента, которую надо присоединить к адресу (по умолчанию – пустая строка).
Пример вызова: <Smereka Func="GetURL" NodeId="1075" Query="Param1=Value1" Fragment="SomeText" />
Пример результата: https://www.m-zharkikh.name/uk/Smereka.html?Param1=Value1#SomeText
Smeref
Модуль: smeretags/substfields.php (доступен по умолчанию)
Параметры: [NodeId] [URLMode] [Query] [Fragment] [SMText="Auto"]
Назначение: генерирует ссылку на заданную вершину.
Если задано необязательный параметр SMText="Auto", текст ссылки будет образовано путем вызова метода DocTitle для вершины. Если этот параметр не задан, следует задать текст ссылки явно.
Действие других перечисленных параметров описано в смеретеге GetURL. Стандартные атрибуты HTML (class, title…) передаются в генерируемый тег anchor
Пример вызова: <Smereka Func="Smeref" NodeId="1075" SMText="Auto" />
Пример результата: <a href="https://www.m-zharkikh.name/ru/Smereka.html">Смерека</a>
Пример вызова: <Smereka Func="Smeref" NodeId="1075" class="AClass">Текст ссылки</Smereka>
Пример результата: <a href="https://www.m-zharkikh.name/ru/Smereka.html" class="AClass">Текст ссылки</a>
SmerefRelative
Модуль: smeretags/substfields.php (доступен по умолчанию)
Параметры: rel [параметры смеретега Smeref]
Назначение: генерирует ссылку на вершину, позиция которой определяется относительно контекстной вершины.
Параметр rel может принимать одно из следующих значений:
first – первая вершина проекта; если контекстная вершина не принадлежит проекту – то же, что и firstsibl.
firstchild – первая дочерняя вершина.
firstsibl – первая вершина, равная контекстной.
prev – предыдущая вершина, равная контекстной или вершина-хозяйка: если контекстная вершина не принадлежит проекту – то же, что и prevsibl.
prevsibl – предыдущая вершина, равная контекстной.
next – следующая вершина в дереве вершин проекта; если контекстная вершина не принадлежит проекту – то же, что и nextsibl.
nextsibl – следующая вершина, равная контекстной.
last – последняя вершина в дереве вершин проекта; если контекстная вершина не принадлежит проекту – то же, что и lastsibl.
lastchild – последняя дочерняя вершина.
lastsibl – последняя вершина, равная контекстной.
root – корневая вершина проекта; если контекстная вершина не принадлежит проекту – то же, что и parent.
parent – вершина-хозяйка.
Этот смеретег не использует параметр NodeId – целевая вершина всегда определяется относительно контекстной вершины.
Поведение смеретега существенно зависит от того, относится ли контекстная вершина к проекту, то есть имеет ли она атрибут ProjectId, который является указателем на корневую вершину проекта.
Пример вызова: <Smereka Func="SmerefRelative" rel="prev">Предыдущая вершина</Smereka>
Пример результата: <a href="https://www.m-zharkikh.name/ru/Smereka.html">Предыдущая вершина</a>
SmerefThumb
Модуль: smeretags/substfields.php (доступен по умолчанию)
Параметры: [параметры смеретега Smeref] [ImageAttr] [border] […]
Назначение: генерирует ссылку на вершину в виде маленького изображения.
Чтобы этот смеретег эффективно работал, его параметр NodeId должен указывать на вершину, которая имеет атрибутом графический файл. Имя этого атрибута можно задать через параметр ImageAttr (по умолчанию – Image). Необязательный параметр border по умолчанию имеет значение 2.
Пример вызова: <Smereka func="SmerefThumb" Node="1081" />
Пример результата: <a href="https://www.m-zharkikh.name/uk/Gallery/Landscapes/KarpatianSmereka.html"><img src="https://www.m-zharkikh.name/files/MZh/gallery/paysages/_thumbs/076-12.jpg" width="200" height ="130" border="2" alt="Смереки на фоне холма (Славское, 1979 г.)" title="Смереки в Карпатах" /></a>