Программирование с C++ Builder



Использование HTML Help Workshop



Использование HTML-редактора, входящего в состав HTML Help Workshop, предполагает знание основ HTML — языка гипертекстовой разметки (далее приведены краткие сведения об HTML, которых достаточно для того, чтобы создать вполне приличную справочную систему).

Чтобы создать HTML-файл, надо запустить HTML Help Workshop, из меню File выбрать команду New | HTML File и в появившемся окне HTML Title (рис. 8.18) задать название раздела справки, текст которого будет находиться в создаваемом файле.



Рис. 8.18. Начало работы над новым HTML-файлом


После щелчка на кнопке ОК становится доступным окно HTML-редактора, в котором находится шаблон HTML-документа. В этом окне, сразу после строки <BODY>, можно набирать текст.

Основы HTML

HTML-документ представляет собой текст, в который помимо обычного текста включены специальные последовательности символов — теги. Тег начинается символом < и заканчивается символом >. Теги используются программами отображения HTML-документов для форматирования текста в окне просмотра (сами теги не отображаются).

Большинство тегов парные. Например, пара тегов <Н2> </H2> сообщает программе отображения HTML-документа, что текст, который находится между этими тегами, является заголовком второго уровня и должен быть отображен соответствующим стилем.

В табл. 8.1 представлен минимальный набор тегов, используя которые можно подготовить HTML-файл с целью дальнейшего его преобразования в chm-файл справочной системы.

Таблица 8.1. HTML-теги

Тег Пояснение

<TITLE> Название </TITLE>

Задает название HTML-документа. Программы отображения HTML-документов, как правило, выводят название документа в заголовке окна, в котором документ отображается. Если название не задано, то в заголовке окна будет выведено название файла

<BODY BACKGROUND = "Файл" BGCOLOR="Цвет" ТЕХТ="Цвет">

Параметр BACKGROUND задает фоновый рисунок, BGCOLOR — цвет фона, TEXT — цвет символов HTML-документа

<BASEFONT FАСЕ="Шрифт" SIZE=n>

Задает основной шрифт, который используется для отображения текста: FACE— название шрифта, SIZE — размер в относительных единицах. По умолчанию значение параметра SIZE равно 3. Размер шрифта заголовков (см. тег <H>) берется от размера, заданного параметром SIZE

<H1> </Н1>

Определяет текст, находящийся между тегами <Н1> и </Н1>, как заголовок уровня 1. Пара тегов <Н2> </H2> определяет заголовок второго уровня, а пара <H3> </H3> — третьего

<BR>

Конец строки. Текст, находящийся после этого тега, будет выведен с начала новой строки

<Р> </Р>

Текст, находящийся внутри этих тегов, является параграфом

<В> </В>

Текст, находящийся внутри этой пары тегов, будет выделен полужирным

<I> </I>

Текст, находящийся внутри этой пары тегов, будет выделен курсивом

<А NAME="Закладка"> </А>

Помечает фрагмент документа закладкой. Имя закладки задает параметр NAME. Это имя используется для перехода к закладке

<А НRЕF="Файл.htm#Закладка"> </А>

Выделяет фрагмент документа как гиперссылку, при выборе которой происходит перемещение к закладке, имя которой указано в параметре HREF

<IMG SRC= "Иллюстрация" >

Выводит иллюстрацию, имя файла которой указано в параметре SRC

<!-- -->

Комментарий. Текст, находящийся между дефисами, на экран не выводится


Набирается HTML-текст обычным образом. Теги можно набирать как прописными, так и строчными буквами. Однако, для того чтобы лучше была видна структура документа, рекомендуется записывать все теги строчными (большими) буквами. Следующее, на что надо обратить внимание — это то, что программы отображения HTML-документов игнорируют "лишние" пробелы и другие "невидимые" символы (табуляция, новая строка). Это значит, что для того чтобы фрагмент документа начинался с новой строки, в конце предыдущей строки надо поставить тег <BR>, а для того чтобы между строками текста появилась пустая строка, в HTML-текст надо вставить два тега <BR> подряд.

Работая с HTML-редактором в программе HTML Help Workshop, уже в процессе набора HTML-текста можно увидеть, как будет выглядеть набираемый текст. Для этого надо из меню View выбрать команду In Browser или щелкнуть на командной кнопке, на которой изображен стандартный значок Internet Explorer.

В качестве примера на рис. 8.19 приведен текст одного из разделов справочной системы программы "Сапер 2003".



Рис. 8.19. HTML-текст раздела справочной системы