Вывод в множественных форматах

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

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

Основной синтаксис:

helpman.exe <путь>\projectfile.hmx /<формат1> /<переключатели> /<формат2> /<переключатели> ... /<форматX> /переключатели

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

Локальные и глобальные переключатели для множественного вывода

Локальные переключатели:

Следующие переключатели являются "локальными". Они должны быть применены к каждому выходному формату индивидуально, вставляя их после переключателя формата, для которого они должны примениться, и перед следующим переключателем формата.

/I=<включенные опции>

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

/Template=<шаблон PDF >

Шаблон PDF, который используется для вывода PDF (только для вывода PDF).

/V = <имя файла>

Этот переключатель определяет внешний файл, чтобы переопределить значения переменных в вашем проектном файле.

Глобальные переключатели:

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

/noclose

Оставляет Help & Manual открытым после окончания компилирования.

/keeptemp

Не удаляет временные каталоги и исходные файлы, сгенерированные для вывода Winhelp и Справки HTML. (Относится только к Winhelp и Справке HTML.)

/L=<журнал компилятора>

Выводит журнал компилятора в указанный файл.

/debug

Показывает информацию отладки для каждого выходного формата перед компилированием.

См. Синтаксис для получения дополнительной информации об отдельных переключателях и параметрах.

Примеры:

Пример 1:

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

helpman.exe D:\Projects\widget.hmx /CHM=widgethelp.chm /I=CHM,DEMO /PDF=manual.pdf /Template=manual.mnl

Пример 2:

Следующий пример компилирует в Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. и Броузерную справку с использованием включенных опций. Переключатель /noclose в конце командной строки оставляет программу открытой, когда компилирование закончено.

helpman.exe D:\Projects\widget.hmx /HLP /I=HLP,FINAL /HTML=D:\HTML\index.html /I=HLP,FINAL /noclose

См. также:

.INI и пакетные файлы