Компилирование модульных проектов

В этом разделе:

Процедура для компиляции модульных проектов зависит от метода слияния, который Вы используете для вашего вывода. В Справке HTML и Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. Вы имеете выбор двух методов слияния, таким образом Вы должны не забыть использовать правильную процедуру компиляции для метода слияния, который Вы выбрали. Все другие выходные форматы используют только слияние при компиляции.

Компилирование модульных проектов со слиянием при компиляции:

Когда Вы используете слияние при компиляции, все дочерние модули главного модуля компилируются в единственный выходной файл. Вы должны только компилировать основной файл, все дочерние модули включаются автоматически. В Winhelp и Справке HTML слияние при компиляции - опция. Все другие выходные форматы всегда используют слияние при компиляции.

1.	Если Вы выводите в Winhelp или Справку HTML, Вы должны выбрать метод слияния перед компилированием.

2.	Потом компилируйте главный проект модуля. Все дочерние проекты будут включены автоматически.

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

Компилирование модульных проектов со слиянием при запуске:

Слияние при запуске возможно только для Winhelp и Справки HTML. Когда Вы используете слияние при запуске, Вы должны компилировать все модули, включенные в систему справки, индивидуально. Дочерние модули не компилируются автоматически, когда Вы компилируете главный модуль!

1.	Выберите метод слияния для Справки HTML или Winhelp перед компилированием. Сделайте это во всех ваших проектных модулях, и главном, и дочерних.

2.	Откройте проектные файлы всех дочерних модулей вашей модульной системы справки один за другим и компилируйте их. Если любой из ваших дочерних модулей содержит собственные дочерние модули, их проектные файлы должны также быть открыты и компилироваться индивидуально.

3.	Откройте проектный файл главного модуля и компилируйте его.

Каждый раз, когда Вы компилируете проек, проверяйте файла экран сообщения о компиляции и обращаете внимание на все выходные файлы, которые Вы должны получить. Помните, что файлы Winhelp всегда имеют отдельный .CNT файл для содержания и что файлы двойного режима Справки HTML всегда имеют дополнительный .HLP файл, содержащий всплывание.

4.	Скопируйте все компилируемые файлы справки в один каталог, удостоверяясь, что ни один из них не имеет двойные имена.

Установки, которыми управляет главный проект в слиянии при компиляции:

Когда Вы используете слияние при компиляции, почти всем управляет главный проект. Установки дочерних проектов игнорируются и заменяются установками главного проекта. Единственные исключения - следующие элементы, где используются установки дочерних проектов, если они уникальны:

Пути папки изображений:	Пути папки рисунков, определенные в дочерних проектах, которые не определены в главном проекте, добавляются в конец списка путей главного проекта. Вставляя графику, Help & Manual перерывает все пути и вставляет первый файл рисунка с соответствующим именем, который находит. Это означает, что Вы должны бояться использовать графику с двойными именами в ваших дочерних проектах.
Определяемые пользователем переменные:	То же относится к определениям переменных. Если дочерние проекты содержат определяемые пользователем переменные с именами, которые не используются в главном проекте, будут использоваться определения дочерних проектов. Однако, если главный проект будет содержать переменные с идентичными именами, то будут использоваться определения из главного проекта.
Заказные включенные опции:	Если дочерний проект содержит определяемые пользователем включенные опции, не определенные в главном проекте, они доступны в слиянии при компиляции.
Шаблоны раздела HTML:	Шаблоны страницы раздела HTML главного проекта заменит все дочерние шаблоны, которые имеют те же имена. Например, это означает, что главный проектный шаблон для Main всегда используется во всех дочерних модулях, заменяя любые изменения шаблона, которые, возможно, были сделаны в дочерних проектах. Если дочерние проекты будут содержать определения типов окна с именами, не используемыми для типов окна в главном проекте, то шаблоны HTML этих типов окна будут использоваться в дочерних проектах. Например, если Вы определили справочное окно по имени SecWin в вашем дочернем модуле, шаблон HTML этого типа окна будет использоваться в дочернем модуле, если не будет никакого типа окна по имени SecWin в главном модуле. Однако, если главный модуль будет содержать тип окна по имени SecWin, то шаблон HTML версии главного модуля будет использоваться в дочернем модуле также. (См. Окна справки для основной информации.)
Файлы багажа:	Файлы Багажа в главном проекте имеют приоритет над файлами Багажа с тем же именем в дочерних проектах. См. Обработка багажа для дальнейших деталей.

См. также:

Слияние невидимых разделов

Компилирование вашего проекта

Модульные проекты (Справочная информация)

Обработка файлов багажа