Статейные страницы

Статейная страница — это "обычная" страница, показываемая в правой фрамуге. Она реализуется файлом в стандартном формате HTML или XHTML. В заголовок файла, т.е. внутри элемента HEAD, могут быть включены HTML-элементы и метаэлементы вида:

<META name="свойство" content="значение">.

Интересны элемент TITLE и метаэлементы, задающие следующие свойства статей.

<TITLE>значение</TITLE>: Текст заголовка статейной страницы, высвечиваемых в различных ссылках на неё. Стандартно, данный элемент задаёт заголовок окна браузера — неактуально для книги помощи, потому что статейные страницы отображается внутри фрамуги.
Если элемент TITLE отсутствует, компилятор книги интерпретирует содержимое самого первого в исходном файле заголовочного элемента в качестве этого свойства.
description: Текст аннотации (краткого описания) статьи.
Компилятор иногда вставляет это описание в качестве всплывающей подсказки к гиперссылке на данную статью.
keywords: Ключевые слова
braces: Только для исходной статей, пропускаемых через компилятор книги.

Статьи верхнего уровня

HTML-код статейных страниц верхнего уровня должен включать в себя следующие вызовы скриптов:

<script src="help.js" type="text/javascript"></script>
<script type="text/javascript">
<!--[CDATA[
cont_onopen();
// ]]-->
</script>

Один из статейных файлов — файл так называемой статьи по умолчанию — показывается при первой загрузке набора фрамуг. URI, ссылающийся на данный файл должен быть жестко зашит в качестве атрибута src правой фрамуги, см. help.html.

Статьи разделов и подразделов

HTML-код всех страниц, расположенных в подпапках первого уровня, должен включать в себя следующие вызовы скриптов:

<script src="../help.js" type="text/javascript"></script>
<!--[CDATA[
cont_onopen(1);
// ]]-->
</script>

Сигнатура

[ECMAScript Function] cont_onopen([level [, default_navi]])

Аргументы

level: целое число, глубина вложенности в физической структуре папок; 0 (умолчание) означает, что данная страница расположена в папке help верхнего уровня.
default_navi: навигационная страница по умолчанию, которая открывается в левой фрамуге, как только в правую будет загружен данный файл; возможные значения:
null или unspecified — без изменения (умолчание),
"name.ext" — URI нужной страницы относительно папки раздела.