Создание Windows-приложений на основе Visual C#

         

Создание содержания


После того как в проект были включены исходные страницы, можно приступать к созданию содержания. Щелкаем на вкладку Contents, при этом появляется окно — "Таблица содержания не определена" (Table Contents Not Specified) — при создании проекта мы пропустили шаг Мастера с созданием файла содержания. Сделаем это теперь – выбираем пункт Create new contents file, указываем директорию для сохранения (желательно сохранять файл содержания там же, где расположен файл проекта notepadhelp.hhp) и называем его ContentsNhelp.hhc. Щелкаем на кнопке добавления страницы

(Insert a page), в поле Entry title вводим название заголовка, которое будет отображаться в содержании, щелкаем на кнопке Add/Edit… и выбираем аналогичный заголовок HTML-страницы из файла проекта (рис. 8.6).


увеличить изображение
Рис. 8.6.  Добавление страницы в содержание справки

Добавляем таким же образом страницу "Структура программы". Изменяем порядок расположения заголовков в содержании, щелкая на кнопках со стрелками

и
на панели инструментов. На рис. 8.1 замечаем, что заголовок "Главная форма frmmain" представляет собой папку, содержащую заголовок "Полный листинг главной формы", и папки c названиями пунктов меню, которые, в свою очередь, тоже содержат вложенные заголовки. Для вставки заголовка-папки нажимаем на кнопку
(Insert a heading), появляется уже знакомое окно Table of Contents Entry. Вводим название заголовка и связываем с ним страницу frmmain.htm. Добавляем под ним еще один обычный заголовок "Полный листинг главной формы" (связанный со страницей FullCodefrmmain.htm), и он автоматически устанавливается с отступом от края окна. Расположение заголовка можно изменять, выделив его и нажимая на кнопки
(Move selection right) и
(Move selection left) (рис. 8.7).


Рис. 8.7.  Заголовки с отступом (слева) превращаются во вложенные заголовки в готовой справке (справа)

Заголовки-папки могут быть связанными с HTML-страницей или просто быть контейнером для других страниц (рис. 8.8).


Рис. 8.8.  Папка-заголовок "Главная форма frmmain" связана со страницей frmmain.htm, папка-заголовок "Меню File" представляет собой просто контейнер для других страниц

В результате должна получиться следующая иерархическая структура содержания (рис. 8.9):


увеличить изображение
Рис. 8.9.  Иерархическая структура содержания

Скомпилируем готовый файл справки — нажимаем на кнопку

(Compile HTML file) на панели инструментов Toolbar или выбираем пункт меню File/Compile… . Появляется диалоговое окно Create a compiled file, в котором дополнительно ставим галочку Save all files before compiling (сохранить все файлы перед компиляцией). После компиляции выводится отладочная информация в окне HTML Help Workshop, а в указанной директории появляется файл notepadhelp.chm (рис. 8.10).


Рис. 8.10.  Скомпилированный файл справки



Содержание раздела