Навигация:  Дополнительные процедуры > Работа с модульными системами справки >

Множественные броузерные проекты

Печать этого раздела Предыдущая страницаВернуться к краткому обзору главыСледующая страница

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

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

Однако, иногда Вы можете хотеть сделать больший проект Броузерной справки с модульной структурой, используя отдельный каталог и индексный файл для каждого модуля. Когда Вы делаете это, проекты в отдельных каталогах упоминаются как "коллекции".

Ограничения с "модульными" проектами Броузерной справки:

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

· Вы не можете использовать главный проект для проектов Броузерной справки этого типа. Если Вы будете включать "дочерние" модули в главный модуль, то все модули будут автоматически объединены в единственной папке вывода. Отдельные "модули" должны быть открыты и компилироваться как отдельные коллекции.
· Вы можете связаться между коллекциями, но Вы не можете слить их Содержания.
· Вы не можете создать ссылки к целевым разделам в проектных файлах других проектов, потому что Help & Manual не может управлять ссылками между коллекциями через каталоги. Вы должны использовать интернет-ссылки, вставляя правильные URL и/или пути между вашими запланированными местоположениями каталога самостоятельно.

Компилирование проектов в отдельные каталоги HTML:

· Откройте каждый проект и компилируйте это отдельно, в отдельный каталог. Проект Броузерной справки в собственном каталоге называется "коллекция".
· Если ваши файлы проекта Help & Manual сохранены в том же каталоге, удостоверьтесь, что Вы вручную вводите другой каталог вывода для каждого проекта в области Страница индексов: диалога Компиляция файла справки, иначе все проекты будут компилироваться в подкаталог \HTML в вашем проектном каталоге, переписывая файлы друг друга и вообще перемешиваясь. (Вы должны сделать это только однажды для каждого проекта, после этого они будут помнить свои установки каталога вывода.)

Создание ссылок между проектами Броузерной справки:

Не пробуйте использовать методы, описанные в Создании ссылок между модулями для ссылок между выводами проектов Броузерной справки в разных каталогак. Это не будет работать! Используйте интернет-ссылки (см. ниже для синтаксиса).

· В области Целевое окно: диалога Гиперссылки выберите:

Тот же как относящийся раздел:

открыть целевой раздел в текущем окне. Содержание текущей коллекции продолжит быть отображенным.

Верхний фрейм:

открыть целевой раздел в текущем окне с Содержанием целевой коллекции. Содержание текущей коллекции больше не будет отображено.

Новое окно:

открыть целевой раздел в новом окне вместе с его собственным Содержанием. Текущее окно остается открытым.

Синтаксис для ссылок между коллекциями:

Стандартный синтаксис для ссылок между коллекциями следующий:

index.html?topic_id.htm#anchor

Используйте строчные буквы:

Имена и расширения всех файлов, сгенерированных для Броузерной справки, должны быть в нижнем регистре, даже если ID разделов, используемые, чтобы генерировать имена файла, содержат символы верхнего регистра (все имена файла автоматически "понижают регистр", когда Вы компилируете). Это очень важно – если Вы будете использовать символы верхнего регистра, то ваши ссылки не будут работать на всех серверах Unix и Linux и многих других системах!

index.html

Это - индексный файл целевого проекта, и он должен всегда включаться в ссылки. Даже при том, что ссылка на файл раздела, может казаться, работает, хронология броузера не может быть сохранена должным образом, лишая пользователя возможности возвращаться к оригинальному разделу при использовании кнопки броузера Назад.

По умолчанию индексный файл Броузерной справки имеет расширение .htm, если Вы не вводите другое расширение в область Страница индексов: диалога Компиляция файла справки.

?topic_id.htm

Символ ? необходим между индексным файлом и именем файла раздела. Каждый раздел сохранен в отдельном файле, и имя файла сгенерировано, добавляя .htm к ID раздела. Например, если ID раздела - HM_Intro, тогда имя файла раздела было бы hm_intro.htm. Всегда пишите все имя файла строчными буквами!

#anchor

Это не обязательно и ссылается на якорь в целевом разделе. Заметьте, что стандартный символ # теперь используется как разделитель вместо запятой, требуемой в Help & Manual 3!

См. также:

Броузерная справка