Горыныч
Система литературного программирования
НОВОСТИ | СКАЧАТЬ | РУКОВОДСТВО | КУПИТЬ | ПОМОЩЬ | КОНТАКТЫ |
<< Назад | Оглавление | Вперёд >>
Ссылки
Ссылка - это специальным образом оформленный блок текста, содержащий имя или номер элемента и связывающий один элемент с другим. Ссылки записывают в полях, предназначенных для документации и кода ("Сводка", "Код" и "Примечания"). В обозревателе ссылки отображаются в виде гиперссылок. Генератор кода раскрывает ссылки - заменяет их исходным кодом тех элементов, на которые они указывают.
Примеры ссылок:
@<мой элемент@>
- ссылка по имени элемента;@<#12345@>
- ссылка по номеру (ссылки такого вида также называются упакованными).
Здесь:
- @< - открывающий тег, обозначает начало ссылки;
- мой элемент - наименование целевого элемента, на который указывает ссылка;
- # - формальный признак номера;
- 12345 - номер целевого элемента, на который указывает ссылка;
- @> - закрывающий тег, обозначает конец ссылки.
Наименование, записанное в ссылке, должно полностью совпадать с именем какого-либо элемента, но без учёта регистра. Сокращения и многоточия не допускаются. То же относится к номерам. Если имя или номер не соответствуют ни одному элементу, такая ссылка является "битой".
Cимвол '@'
обозначает начало тега. Из-за этого запрещается присваивать элементам имена, содержащие этот символ, и запрещается записывать его внутри ссылок. Если этот символ требуется записать вне ссылки, тогда его необходимо "экранировать" путём удвоения. Вот так: @@
.
Разрешается присваивать элементам имена, состоящие из одних цифр. Чтобы отличать в ссылках наименования от номеров, введён формальный признак номера - символ '#
'. Если ссылка начинается с этого символа, значит её содержанием является номер. Как следствие, запрещены имена, начинающиеся символом '#
'.
Разрешается создавать более одной ссылки на один и тот же элемент. Например, один и тот же фрагмент можно вставить в несколько других фрагментов.
Не разрешается вкладывать одну ссылку в другую.
<< Назад | Оглавление | Вперёд >>