|
Создание контекстно-зависимых разделов |
    |
|
Создание контекстно-зависимых разделов |
|
|
В этом разделе: |
|
Как создать нормальный контекстно-зависимый раздел |
Контекстно-зависимая справка может использовать и нормальные разделы, и всплывающие разделы. "Нормальный" контекстно-зависимый раздел - просто любой раздел в вашем Содержании, вызванный непосредственно вашим приложением, и он всегда отображается вместе со всей справкой. Контекстно-зависимые всплывающие разделы вызываются непосредственно и отображаются самостоятельно в небольшом окне, которое закрывается после того, как пользователь прочитал текст.
Как автор справки, Вы фактически не должны делать что-нибудь специальное, чтобы создать контекстно-зависимые разделы. Они - просто нормальные разделы Содержания и нормальные всплывающие разделы. Они становятся "контекстно-зависимыми", когда вызываются непосредственно из приложения.
То, что делает контекстно-зависимые всплывающие разделы немного другими, - факт, что они могут быть вызваны самостоятельно, без справки, но в пределах справки они - идентичны любому другому всплывающему разделу.
Для получения более фундаментальной информации смотритеглаву Контекстно-зависимая справка и всплывание в разделе Справочной информации.
Как создать нормальный контекстно-зависимый раздел:
Нормальные контекстно-зависимые разделы - просто нормальные разделы в Содержании. Только следуйте за инструкциями в Создании новых разделов, чтобы создать новый раздел в Содержании.
| · | Эти разделы становятся контекстно-зависимыми разделами, когда они вызваны непосредственно из приложения. То, как это сделано, зависит от языка программирования и вашего выходного формата. |
| · | Разделы Справки HTML всегда вызываются API HTML Help, разделы Winhelp - API Winhelp. Путь обращения к этим API изменяется в зависимости от языка программирования, который Вы используете. Пдробности смотрите в Запросы приложений к контекстно-зависимым разделам. |
| · | Вы можете также сделать контекстные запросы в разделы броузерной справки. Для подробностей смотрите Контекстные запросы к броузерной справке. |
Как создать контекстно-зависимый всплывающий раздел:
Контекстно-зависимые всплывающие разделы - нормальные всплывающие разделы в секции Невидимые разделы. Просто следуйте инструкциям в Создании всплывающих разделов, чтобы создать и редактировать всплывающие разделы в секции Невидимые разделы.
|
Помните, что контекстно-зависимые всплывающие разделы поддерживаются только в Winhelp и Справке HTML. (Всплывание в пределах вашей справки также поддерживается в eBooks.) |
| · | Здесь также, всплывающие разделы Справки HTML вызваны API HTML Help, разделы Winhelp - API Winhelp. Путь обращения к этим API изменяется в зависимости от языка программирования, который Вы используете. Подробности смотрите в Запросы приложений к контекстно-зависимым разделам. |
| · | Вы не можете сделать контекстные запросы к всплывающим разделам в броузерной справке. |
| · | Если программисты предоставляют Вам "файл карты" ID разделов и контекстных чисел для элементов в программе, которая должна быть документирована, Вы можете также генерировать ваши контекстно-зависимые всплывающие разделы автоматически! См. Автогенерация контекстно-зависимых разделов для подробностей. |
|
|
Не используйте ссылки в контекстно-зависимых всплывающих разделах: Даже в Winhelp и справке двойного режима (см. ниже), где ссылки поддерживаются, это - плохая практика, чтобы использовать ссылки в контекстно-зависимых всплывании. Эти разделы проектированы, чтобы быть быстро прочитанными и затем закрытыми снова. Если Вы должны использовать ссылки, лучше использовать нормальный раздел вместо всплывающего раздела. Тогда программист может сделать контекстный запрос в нормальный раздел, который будет обращаться ко всей справке так, чтобы пользователь мог просмотреть ее. |
Создание "двойного режима" всплывания в Справке HTML:
Исходное всплывание Справки HTML - только простой текст, оно не поддерживает графику или форматированный текст, как всплывание в Winhelp. Если Вы хотите форматировать всплывание для использования в вашей справке или в контекстно-зависимой справке, Help & Manual может решить эту проблему для Вас, создавая справку "двойного режима" для Справки HTML, с .CHM файлом для основной справки и .HLP файлом Winhelp для всплывания. (Microsoft также использует этот метод в справке множества собственных приложений.)
| · | Для подробностей смотрите Форматированное всплывание со справкой двойного режима в разделе Дополнительные процедуры. |
| · | Help & Manual 4 также вводит всплывающий JavaScript, который может использоваться для создания отформатированных всплывающих разделов в Справке HTML. Однако, всплывающий JavaScript не может использоваться для контекстно-зависимой справки в приложениях. |
См. также:
Автогенерация контекстно-зависимого всплывания
