Новые выходные форматы

Была добавлена поддержка экспорта и импорта XML для перевода (в версии 4.1 Help & Manual) и для формата MS Help 2.0 (также известного как Справка Visual Studio).

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

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

XML:

Версия 4.1 Help & Manual также поддерживает XML. Функция Экспорт/Импорт XML позволяет Вам экспортировать ваш весь проект в формат XML, который может быть отредактирован в редакторах XML, например, для перевода. Впоследствии Вы можете повторно импортировать весь отредактированный проект назад в Help & Manual со всем его размещением, форматированием, свойствами и неповрежденными установками.

В дополнение к экспорту XML Вы можете также рассмотреть и редактировать код XML ваших разделов непосредственно в Help & Manual с новым Редактором кода XML, который интегрирован в основную панель редактора. Поправки автоматически обновляются в вашем разделе, когда Вы возвращаетесь к нормальной вкладке Редактора страницы.

Отметьте, что Редактор кода XML доступен только в Профессиональной версии Help & Manual.

Функция экспорт/импорт XML использует собственную схему XML Help & Manual. Она предоставлена, чтобы Вы экспортировали ваши проекты справки в формат XML, обработали их внешне и затем повторно импортировали их со всем вашим размещением, форматированием и установками проекта.

Эта функция не проектирована для того, чтобы импортировать данные XML из других источников! Схема XML Help & Manual полностью документирована в отдельном файле справки, включенном с программой (Helpman_XML_ref.chm в каталоге программы Help & Manual).

·	Это - особенность Профессиональной версии: Пожалуйста отметьте, что поддержка экспорта/импорта XML включена только в Профессиональную версию Help & Manual 4.

Новая Броузерная справка с поиском по всей справке:

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

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

Старая версия имела или JavaScript или простой HTML, и Вы должны были решить, что Вы хотели использовать, когда компилировали. Новая версия объединена в одном выводе и работает надежно со всеми броузерами от MSIE 6 назад к ранним версиям Netscape. Это было также проверено на броузерах Linux (включая Konqueror, который не мог обработать старую версию вообще), и броузерах Mac.

·	Особенности Профессиональной версии: Пожалуйста отметьте, что поддержка поиска по всей Справке в Броузерной справке включена только в Профессиональную версию Help & Manual 4.

Изменения и усовершенствования Броузерной справки:

Мощный механизм поиска по всей Справке включен. Параметры поиска полностью конфигурируемы, и поиск индексирован. Как только пользователь загрузил компактный индексный файл - поиск работает быстро и включает подсвечивание найденных слов. Поиск по всей Справке действительно требует JavaScript на броузере пользователя, как бы то ни было. Он не допускается, если броузер пользователя не имеет поддержки JavaScript.

Есть теперь две основных опции вывода: "Простой" и "Динамический". Динамический - стандарт, объединяющий функциональные возможности и JavaScript, и простого HTML с автоматическим переключением в ответ на возможности броузера. Простая версия генерирует простой HTML без любых фреймов и без JavaScript. Это - фактически только для очень специальных требований, например если Вы должны сделать некоторую постобработку на выводе HTML. Иначе это почти никогда не будет необходимо.

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

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

Всплывание теперь поддерживается. Новое всплывание JavaScript (также доступное в Справке HTML), предоставляют подлинные всплывающие разделы в Броузерной справке. Оно может включать ссылки, графику, форматированный текст и даже видео и анимацию. Они действительно требуют JavaScript на броузере пользователя, как бы то ни было.

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

·	Синхронизация между Содержанием и отображенными разделами также улучшена.

Усовершенствования указателя ключевых слов: Нажатие на ключевое слово с единственной ссылкой ведет пользователя непосредственно к связанному разделу, ключевые слова с мультиссылками (то есть ключевые слова, содержащиеся в больше чем одном разделе) отображают всплывающее окно для выбора. Всплывающее окно остается открытым, и не исчезает, когда Вы отодвигаете мышь.

Оптимизация кода для HTML: Help & Manual 4 автоматически генерирует разный код HTML для Броузерной справки и Справки HTML. Файлы .CHM Справки HTML оптимизированы для MS Internet Explorer (который используется, чтобы отобразить Справку HTML), и код Броузерной справки принимает во внимание причуды и требования доступных Интернет-броузеров.

·	UTF-8- и XHTML 1.1- послушные выводы: Вы можете активизировать и кодирование UTF-8 для языков Unicode, и XHTML 1.1-послушный вывод. И эти особенности могут быть включены или выключены (UTF-8 не всегда требуется, и не все броузеры полностью совместимы с XHTML – это - ваш выбор.)

Поддержка Справки Visual Studio (MS Help 2.0):

Это было введено для программистов, которые должны документировать компоненты, созданные для интеграции в Visual Studio .Net. Microsoft решил не выпускать Help 2.0 в других целях, но много программистов просили эти функциональные возможности, и теперь мы предоставили их.

·	Это - особенность профессиональной версии: Пожалуйста отметьте, что поддержка Справки Visual Studio\ MS Help 2.0 включена только в Профессиональную версию Help & Manual 4.

См. также:

Броузерная справка (Форматы справки)

Справка Visual Studio (Форматы справки)