|
Выходные файлы и папки XML |
    |
|
Выходные файлы и папки XML |
|
|
В этом разделе: |
Когда Вы экспортируете в XML, компилируя ваш проект в XML, Вы можете хотеть генерировать или единственный большой файл XML, содержащий ваш весь проект, или систему папок, содержащую отдельный файл XML для каждого раздела. В дополнение к этому Вы можете также генерировать ваш вывод в zip архиве так, чтобы Вы могли отправить его по почте для дальнейшей обработки.
Этот раздел описывает сгенерированные файлы и папки, когда Вы компилируете вывод XML с каждой из этих опций. Больше деталей относительно формата файлов XML смотрите в формат выходного файла XML.
Все выведенные файлы, когда Вы компилируете в XML, имеют оригинальную метку времени, насколько это уместно и применимо. Файлы XML для отдельных разделов имеют метку времени последнего редактирования раздела, а не последнего компилирования в XML. То же относится к файлам рисунков и файлам Багажа, каждый из которых сохранен с их оригинальной меткой времени.
Имена файлов и папок вывода XML:
Структура папки вывода XML фиксирована и не должна быть изменена. Большинство файлов содержит внутренние относительные ссылки в пределах этой структуры папок, и изменение позиций и имен папок испортят эти ссылки и сделают невозможным переимпортирование проекта.
То же относится к именам всех выходных файлов. Они являются основными для структуры системы XML и не должны быть изменены, иначе и чтение, и переимпортирование файлов XML будет вероятно терпеть неудачу.
Если Вы непременно должны редактировать имена папки и файла и структуру, Help & Manual будет в состоянии повторно импортировать ваш измененный проект, если Вы правильно измените все уместные ссылки всюду по всей системе проекта XML. Это не рекомендуется, как бы то ни было. Намного проще оставить оригинальную структуру неповрежденной.
Вывод единственного файла XML:
Когда Вы компилируете ваш проект, как единственный XML файл, сгенерированы следующие файлы и папки:
|
projectname.xml |
Этот файл содержит все данные XML. Он имеет то же содержание, как ваш файл проекта .HMX. Все, что обычно сохраняется в вашем проектном файле, находится также в этом файле, кроме файлов Багажа (см. ниже). |
|
helpproject.xsd |
Это - файл Языковой схемы XML Help & Manual, который автоматически экспортируется с каждым проектом, когда Вы сохраняете в XML. Между прочим, он позволяет редакторам XML, которые поддерживают проверку синтаксиса, проверять ваши изменения редактирования на согласие со схемой. |
|
projectname.xsl |
Это - файл таблицы стилей XSL с форматирующими правилами. Он не является основным – он предоставлен, только чтобы редакторы XML и web броузеры, которые поддерживают таблицы стилей XSL, могли генерировать приблизительный WYSIWYG предпросмотр так, чтобы Вы могли получить основную идею относительно того, на что будут похожи размещение раздела и форматирование, когда это компилируется Help & Manual. |
|
.\Images\*.* |
Эта папка содержит все изображения, на которые ссылаются в ваших разделах. В отличие от других форматов справки, изображения здесь выводятся в их родных форматах – то есть изображения .BMP экспортируются как .BMP, и изображения Impict .IPP экспортируются как .IPP. Это необходимо, потому что иначе ссылка изображения в коде XML была бы неправильной, когда Вы повторно импортируете ваши изображения. Редакторы XML вообще будут в состоянии обработать все форматы изображения, поддержанные Help & Manual, кроме Impict .IPP, который является частным форматом Software EC. Если изображения важны для понимания текста (например для переводчика), лучше использовать другой формат изображений. Вы можете использовать тэги условного текста, чтобы создать альтернативные версии ваших изображений .IPP для экспорта XML, если Вы желаете. Файлы рисунка экспортируются с их оригинальной меткой времени, а не меткой времени операции экспорта XML. |
|
.\Baggage\*.* |
Эта папка содержит все файлы из секции Багажа вашего проекта, которые обычно внедряются в ваш файл проекта .HMX. Файлы багажа экспортируются с их оригинальными форматами и с их оригинальной меткой времени. |
Когда Вы компилируете ваш проект, как несколько файлов XML, отдельный файл XML создается для каждого раздела в вашем проекте. Следующие файлы и папки будут сгенерированы:
|
projectname.xml |
Когда Вы генерируете многократные файлы XML, этот файл содержит всю вашу проектную информацию кроме содержимого отдельных разделов, которые сохранены в отдельных файлах. |
|
helpproject.xsd |
Это - файл Языковой схемы XML Help & Manual, который автоматически экспортируется с каждым проектом, когда Вы сохраняете в XML. Между прочим, он позволяет редакторам XML, которые поддерживают проверку синтаксиса, проверять ваши изменения редактирования на согласие со схемой. |
|
.\Topics\*.xml |
Эта папка содержит все файлы XML для ваших отдельных разделов, с одним файлом для каждого раздела. Файлы названы, комбинируя ID раздела в строчных буквах с расширением .xml. Файлы раздела экспортируются с меткой времени последнего редактирования раздела в Help & Manual. |
|
projectname.xsl |
Это - файл таблицы стилей XSL с форматирующими правилами, чтобы предварительно просмотреть файл проекта XML projectname.xml в редакторах XML и web броузерах с поддержкой XSL. Это необходимо только для предпросмотра и не очень важно. |
|
projectname_topics.xsl |
Это - дополнительная таблица стилей XSL с форматирующими правилами, чтобы рассмотреть файлы XML отдельных разделов. Как основная таблица стилей XSL, она необходима только для предпросмотра и не очень важна. |
|
.\Images\*.* |
Эта папка содержит все изображения, на которые ссылаются в ваших разделах. В отличие от других форматов справки, изображения здесь выводятся в их родных форматах – то есть изображения .BMP экспортируются как .BMP, и изображения Impict .IPP экспортируются как .IPP. Это необходимо, потому что иначе ссылка изображения в коде XML была бы неправильной, когда Вы повторно импортируете ваши изображения. Редакторы XML вообще будут в состоянии обработать все форматы изображения, поддержанные Help & Manual, кроме Impict .IPP, который является частным форматом Software EC. Если изображения важны для понимания текста (например для переводчика), лучше использовать другой формат изображений. Вы можете использовать тэги условного текста, чтобы создать альтернативные версии ваших изображений .IPP для экспорта XML, если Вы желаете. Файлы рисунка экспортируются с их оригинальной меткой времени, а не меткой времени операции экспорта XML. |
|
.\Baggage\*.* |
Эта папка содержит все файлы из секции Багажа вашего проекта, которые обычно внедряются в ваш файл проекта .HMX. Файлы багажа экспортируются с их оригинальными форматами и с их оригинальной меткой времени. |
См. также:
Новый проект из файла проекта XML
Импортирование проектов XML H&M