При создании справочной системы программы необходимо определить со-
став входящих в нее файлов По мере необходимости можно также опреде-
лить параметры, которые используются при отображении и использовании
справочной информации. Все эти настройки устанавливаются в файле опи-
сания проекта, который необходим для компиляции справочного файла.
Файл описания проекта является текстовым файлом в формате ASCII.
Информация в нем содержится в нескольких секциях, и по оформлению он
похож на файлы настройки конфигурации программ (с расширением .ini)
ОС Windows. Этот файл можно создать в любом текстовом редакторе, например
в Word for ОС Windows, сохранив его в соответствующем формате.
На практике рекомендуется использовать редактор файла описания проекта утилиты Microsoft Help Workshop, что дает возможность быстро и безошибочно сформировать этот файл.
Не рекомендуется таким образом созданный файл изменять затем в другом текстовом редакторе.
Для создания файла описания проекта требуется выполнить следующие
действия. После запуска утилиты Microsoft Help Workshop нужно задать
команду меню File|New. Затем в появившемся окне New нужно выбрать
из списка действий значение Help Project (Описание проекта справочной
системы) и нажать кнопку ОК. В результате появится стандартное окно для
сохранения файла. В нем требуется определить папку, в которой будет со-
хранен файл описания проекта, и ввести его имя, причем расширение .hpj
к имени будет добавлено автоматически. После этого будет открыто главное
окно редактора файла описания проекта. Основное место в нем занимает
формируемый текст файла описания проекта. Непосредственно в этот текст
никаких изменений внести нельзя, а все действия по его модификации де-
лаются с помощью кнопок в правой части окна редактора. Каждая из этих
кнопок предназначена для формирования определенных параметров, которые
будут описаны ниже
Окно редактора содержит строку ввода Help File (Файл описания)
с именем создаваемого файла, которое можно изменять. Допускается
менять это имя файла проекта при внесении в работающий вариант изменений, чтобы получать различные версии справочной системы
Если файл описания проекта существует, то его можно открыть с помощью команды меню File|0pen. В этом случае появится стандартное окно
выбора имени файла, в котором требуется определить нужный файл.
При работе с редактором файла проекта справочной системы многие
действия похожи друг на друга. Так, при определении многих параметров справочной системы в файле описания проекта создается список их однотинных значений. Непосредственно исправлять этот список нельзя - он
предназначен для просмотра. Чтобы изменить содержимое списка значений,
нужно воспользоваться следующими кнопками, находящимися в правой
части окна определения параметра: Add - предназначена для добавления нового элемента в список. В ре-
зультате ее нажатия появляется дополнительное окно для ввода информации.
Это диалоговое окно содержит, как правило, несколько строк ввода (неко-
торые - комбинированные), в которых задаются характеристики соот-
ветствующего параметра. Remove - удаление выбранного параметра из списка. Include - включение в список файла, в котором содержится подготов-
ленный соответствующим образом список значений параметров. Он должен
быть оформлен таким же образом, каким был бы оформлен список при до-
бавлении параметров с помощью кнопки Add. Edit - редактирование выбранного элемента из списка в таком же до-
полнительном окне, которое появляется в результате нажатия кнопки Add
(на добавленные файлы не действует). OK - закрыть форму и добавить внесенные изменения в текст файла
описания проекта. Cancel - закрыть форму без добавления внесенных изменений в текст
файла описания проекта.
В качестве значений параметров могут быть файлы или папки. В этом
случае в описании пути к ним в редакторе файла описания проекта используются следующие обозначения:
• . - текущая папка, где находится компилятор справочной системы;
• .. – папка, которая включает текущую;
• ..\.. - папка, которая вложена в папку - владелец текущей и т.д.,
для каждого следующего владельца добавляет префикс ..\;
• если определяемая папка не является прямым предком текущей, то сначала определяется путь до их общего предка с помощью символов ..\, а потом указывается путь до заданной папки;
• путь до заданной папки отображается традиционным образом от корня структуры каталогов, если он находится на другом логическом диске.
Эта форма для определения соответствующего параметра считается
стандартной, все отличия от перечисленных выше элементов должны особо
оговариваться.
Опубликовал Kest
December 23 2009 11:31:59 ·
0 Комментариев ·
7937 Прочтений ·
• Не нашли ответ на свой вопрос? Тогда задайте вопрос в комментариях или на форуме! •
Комментарии
Нет комментариев.
Добавить комментарий
Рейтинги
Рейтинг доступен только для пользователей.
Пожалуйста, залогиньтесь или зарегистрируйтесь для голосования.
Нет данных для оценки.
Гость
Вы не зарегистрированны? Нажмите здесь для регистрации.
Главная
Каталог файлов
