Новый проект из проектного файла XML H&M

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

Вы можете также импортировать пакетные файлы XML, созданные с Help & Manual, в существующие проекты. Это - обычно опция, которую Вы должны выбрать, когда повторно импортируете версию XML вашего проекта, который был отредактирован внешне. См. Импортирование проектов XML H&M для деталей.

Вы не можете импортировать отдельные файлы разделов XML с этим методом. См. Экспорт и импорт разделов для инструкций о том, как импортировать отдельные файлы разделов XML.

ВАЖНО: Help & Manual может обработать только свои собственные файлы XML!

Help & Manual может обработать только файлы XML, созданные в Help & Manual. Сейчас Вы не можете экспортировать или импортировать никакие другие форматы XML. Help & Manual использует свою собственную схему XML, известную как Язык XML Help & Manual. Эта схема спроектирована для того, чтобы экспортировать проекты Help & Manual для внешней обработки и затем переимпортировать их, и это - единственная схема XML, с которой это является возможным.

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

Как создать новый проект из пакетного файла XML:

Чрезвычайно важно понять, что Вы можете импортировать только пакетные файлы XML, созданные в Help & Manual. Сейчас, Вы не можете импортировать файлы XML, сгенерированные другими приложениями или с использованием других схем XML, как DocBook или Darwin

1.	Выберите Файл > Новый, чтобы отобразить мастер Создание нового проекта справки:

·	Потом выберите опцию Импорт существующий документации из ... и щелкните флажок для Файла XML.

В поле Определите исходный файл / папку: щелкните

, чтобы определить местонахождение каталога, содержащего главный файл проекта .XML в пакетном файле XML, сгенерированном Help & Manual. Этот файл расположен в основном каталое пакета XML и имеет то же имя, как проект, из которого это экспортировалось.

·	Выберите основной файл проекта XML. Не пробуйте выбрать любые отдельные файлы разделов XML в каталоге \Topics, если ваш пакет будет содержать их - они не будут работать. (См. Экспорт и импорт разделов для деталей относительно импортирования отдельных файлов разделов XML.)

·	Потом нажмите Дальше для перемещения к следующему экрану.

2.	В следующем экране введите путь и имя файла нового проекта Help & Manual .HMX , который Вы хотите создать:

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

·	Потом введите имя файла для вашего проекта и нажмите Дальше.

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

3.	В следующем экране Вы можете выбрать некоторые опции для процесса импорта XML:

Перезаписать существующие разделы:

Если будут разделы в текущем проекте с теми же ID раздела? как разделы в пакете XML, то они будут переписаны, когда Вы импортируете. Это вообще используется чтобы модифицировать проект с новой, отредактированной версией.

Эта установка неважна, когда Вы создаете новый проект.

Импорт свойств проекта:

Импортирует проектные свойства из проекта, сохраненного в пакетном файле XML, переписывая установки в текущем проекте.

Импорт файлов багажа:

Импортирует любые файлы Багажа из проекта, сохраненного в пакетном файле XML.

4.	Потом только нажмите , чтобы импортировать файл XML и создать новый проект .HMX Help & Manual. После импортирования Help & Manual автоматически откроет новый проект для редактирования.

См. также:

Импортирование данных в существующие проекты

Экспорт и импорт XML (Справочная информация)