Формирователь описания

Это «хитрое» поле служит для формирования отображения информации о справочнике. Это достигается путем вставки тега форматирования описания <dirfield>. Его формате следующий:

<dirfield id='%#<название поля>#%' empty='< вместо пустого поля>' showempty='<yes /no>'>%#%</yes></dirfield>

id — «название поля» — имя вашего поля, значение которого должно быть вставлено в это место формирователя.

empty — «вместо пустого поля» — что вывести, если значение поля — пустая строка.

showempty — «yes/no» — показывать ли вообще что-то если поле пустое.

%#% — вместо этого вставляется значение поля.

Рассмотрим на примере. Допустим у вас есть справочник персонажей и в нем есть следующие поля:

Имя — Имя персонажа

Описание персонажа — ну какое-то описание персонажа

Пол — понятно, что

Дом — Принадлежность персонажа к какому-то благородному дому.

Специализация — Какая-то специализация персонажа, скажем «Маг», «Вор», «Воин».

У вас есть три персонажа:

Наран

• Простой воин
• Мужской
• -
• Воин

Парган

• Хитрая бестия с отрогов Мглистых гор
• Мужской
• Ал'аш'низак
• Вор

Сариссо

• Основатель и лидер магического дома Наргин
• -
• Наргин
• Маг

Установим следующее значение формирователя:

<dirfield id='%#Пол#%' showempty='no'>Пол: %#%
</dirfield><dirfield id='%#Дом#%' empty='Нет'>Дом: %#%
</dirfield><dirfield id='%#Специализация#%' showempty='no'>Специализация: %#%
</dirfield>
<dirfield id='%#Описание персонажа#%'>%#%</dirfield>

Тогда в списке справочника (или в глоссарии) мы получим следущее

Наран

Пол: Мужской

Дом: Нет

Специализация: Воин

Простой воин

Парган

Пол: Мужской

Дом: Ал'аш'низак

Специализация: Вор

Хитрая бестия с отрогов Мглистых гор

Сарисса

Дом: Наргин

Специализация: Маг

Основатель и лидер магического дома Наргин

Т.е. мы указали, что для поля «Дом» при отсутствии значения выводится слово «Нет», а если отсутствует «Пол» или «Специализация», то все, что заключено внутри соотвествующих тегов <dirfield> не выводится совсем.