Условный вывод в шаблонах HTML

В этом разделе:

Вы можете использовать все стандартные опции условного вывода Help & Manual в шаблонах HTML, и ваши определяемые пользователем включенные опции, и опции, основанные на текущем выходном формате. В дополнение к этому есть несколько специальных условных переключателей, которые нужны только для использования в выводе броузерной справки Help & Manual, потому что они уместны только там. См. списки ниже для подобностей.

Вы можете думать об этих условиях, как частных html-тэгах. Они используются, чтобы включать блоки HTML кода в ваш шаблон, который Вы хотите включить в вывод, только если условие выполнено.

Условия, основанные на выходном формате, уместны только в шаблоне страницы раздела, который используется в Справке HTML, Броузерной справке, eBooks и справке Visual Studio / MS Help 2.0. Содержание и шаблоны указателя ключевых слов используются только в Броузерной справке, таким образом, не имеет смысла использовать там условия на основе формата.

Справочная информация условного вывода:

Для получения дополнительной информации о доступных условиях вывода, переменных и как использовать их, смотрите следующие разделы:

·	Список условий вывода шаблона HTML

·	Определение ваших собственных включенных опций

·	Список глобальных предопределенных переменных

·	Список переменных шаблона HTML

·	Создание определяемых пользователем переменных

Как использовать включенные опции в шаблонах HTML:

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

Заметьте, что условие ELSE не доступно в шаблонах HTML.

Примеры:

<IF_TOPIC_HEADER>
Этот текст появляется в разделе, только если раздел имеет заголовок. 
Он не будет включен во всплывающие разделы, которые никогда не имеют заголовка, или если в назначенных разделах
типы справочного окна определены без заголовка.
</IF_TOPIC_HEADER>

<IFNOT_PREVIOUS_PAGE>Этот текст будет отображен только в самом
первом разделе в вашей справке.</IFNOT_PREVIOUS_PAGE>

<IF_NEXT_PAGE>
<a href="<%HREF_NEXT_PAGE%>">Нажмите здесь, чтобы перейти к следующему разделу</a>
</IF_NEXT_PAGE>

·	Заметьте, что последний пример отображает ссылку, только если есть следующий раздел для перехода.

Как использовать определяемые пользователем включенные опции (заказная сборка) в шаблонах HTML:

В основном это - точно то же, как использование предопределенных включенных опций, Вы должны только использовать следующие правила синтаксиса для создания вашего условного выражения, переключая имена ваших включенных опций в Проект > Свойства проекта > Общие свойства > Заказная сборка:

Синтаксис:

Открытие тэга:

< + IF_ + ОПЦИЯ +>

Закрытие тэга:

</ + IF_ + ОПЦИЯ +>

Версия NOT:

< + IFNOT_ + ОПЦИЯ +>

Закрывающий тэг NOT:

</ + IFNOT_ + ОПЦИЯ +>

Пример:

Эти пример показывает, как использовать определяемые пользователем включенные опции ALPHABUILD и BETABUILD:

<IF_ALPHABUILD>
Этот текст будет включен, если ALPHABUILD будет выбран во включенных опциях в
диалоге Компилировать и запустить файл справки.
</IF_ALPHABUILD>
<IFNOT_BETABUILD>
Этот текст будет исключен, если BETABUILD будет выбран во включенных опциях в
диалоге Компилировать и запустить файл справки.
</IFNOT_BETABUILD>

См. также:

Условия вывода шаблона HTML (справочная информация)

Редактирование шаблонов HTML

Переменные в шаблонах HTML