Горыныч
Система литературного программирования

Ссылки

Ссылка - это специальным образом оформленный блок текста, содержащий имя или номер элемента и связывающий один элемент с другим. Ссылки записывают в полях, предназначенных для документации и кода ("Сводка", "Код" и "Примечания"). В обозревателе ссылки отображаются в виде гиперссылок. Генератор кода раскрывает ссылки - заменяет их исходным кодом тех элементов, на которые они указывают.

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

@<мой элемент@> - ссылка по имени элемента;
@<#12345@> - ссылка по номеру (ссылки такого вида также называются упакованными).

Здесь:

@< - открывающий тег, обозначает начало ссылки;
мой элемент - наименование целевого элемента, на который указывает ссылка;
# - формальный признак номера;
12345 - номер целевого элемента, на который указывает ссылка;
@> - закрывающий тег, обозначает конец ссылки.

Наименование, записанное в ссылке, должно полностью совпадать с именем какого-либо элемента, но без учёта регистра. Сокращения и многоточия не допускаются. То же относится к номерам. Если имя или номер не соответствуют ни одному элементу, такая ссылка является "битой".

Cимвол '@' обозначает начало тега. Из-за этого запрещается присваивать элементам имена, содержащие этот символ, и запрещается записывать его внутри ссылок. Если этот символ требуется записать вне ссылки, тогда его необходимо "экранировать" путём удвоения. Вот так: @@.

Разрешается присваивать элементам имена, состоящие из одних цифр. Чтобы отличать в ссылках наименования от номеров, введён формальный признак номера - символ '#'. Если ссылка начинается с этого символа, значит её содержанием является номер. Как следствие, запрещены имена, начинающиеся символом '#'.

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

Не разрешается вкладывать одну ссылку в другую.

<< Назад | Оглавление | Вперёд >>