Центр помощи

Chapter (раздел содержания).

Инструкция «chapter» используется для указания раздела содержания, в который попадает данная страница. Поскольку разделы создаются исключительно на основании страниц, то здесь же указываются параметры разделов.

Синтаксис инструкции следующий:

<meta chapter="Альфа\Бета\Гамма" [location="hidden"] [order="2"] [profile="alpha"]>

Задаваемые параметры относятся к последнему разделу из указанных (т.е. «Гамма» - в примере). Инструкцию «chapter» можно задавать несколько раз в одном html-документе, тогда путь к разделу объединяется в порядке следования инструкций — это дает возможность задавать параметры для каждого раздела, а не только самого последнего. Например, определение раздела «Альфа\Бета\Гамма» можно переписать так:

<meta chapter="Альфа\Бета" location="hidden" order="bottom">
<meta chapter="Гамма" order="2">

Обратите внимание, что теперь задается не только порядок раздела «Гамма» на третьем уровне вложенности содержания, но и раздела «Бета» на втором уровне.

К заданию параметров разделов в разных html-документах следует подходить с осторожностью. Навигатор может игнорировать параметры при наличии неразрешимых противоречий. Если есть возможность описать разделы верхних уровней в обзорных страницах, то этой возможностью следует пользоваться. О привязке страниц к разделам см. подробнее «Представление страницы в содержании».

Необязательный атрибут «location» управляет формирование строки «Расположение», отображаемого для страницы в результатах поиска. Указание атрибута:

location="hidden"

для раздела позволяет выкинуть его имя из строки «Расположение». Так в примере атрибут «location» задан для раздела «Бета», поэтому строка «Расположение» будет «Альфа: Гамма». По умолчанию «Расположение» для этой страницы «Альфа: Бета: Гамма». Цель использования атрибута «location» - выкинуть из строки «Расположение» несущественные имена разделов и сократить ее длину.

Для того, чтобы положить страницу (Страница 2) в корневой раздел, нужно задать:
<meta chapter="_root">

Если для страницы не указаны инструкции «chapter», то разделы автоматически формируются в соответствии с папками на диске, в которых расположены html-документы.

Например, если корневая папка документации «C:\Docs», а страница расположена «C:\Docs\Common\Function reference\index.html», то будет назначен раздел содержания «Common\Function reference».

Необязательный атрибут «profile» позволяет задать еще несколько разделов содержания, в которые следует поместить страницу (или топик). Указание атрибута:

profile="alpha"

позволяет определить дополнительный раздел (с именем профиля "alpha"). Для помещения страницы в три различных раздела содержания надо определить два дополнительных профиля ("alpha" и "beta", например) и т.д.

Разделы для основного профиля задаются, если атрибут «profile» не указан или равен "_default".

Привязка страниц к дополнительным разделам содержания осуществляется указанием соответствующего значения атрибута «profile» для инструкции «content». Если там не указывать «profile», то страница будет привязана к дополнительным разделам содержания также, как и к основному (текст, отдельные узлы для анкерных ссылок, порядок и т.д).


Инфо-Навигатор: Инструкции HTML