5.6 Command Execution
O DMHelp pode ser executado via linha de comandos.
Para isso você deve executar o programa DMHelp via linha de comando como, por exemplo, na linha abaixo:
...\DMHelp MyManual.dmh OPATH=C:\ PRE=1 RTF=1 HTMLS=1 HTMLM=1 LANG=1 CONV=1 EXIT=1
Executável
...\DMHelp deve ser substituído pelo Path de onde o DMHelp estiver instalado, por exemplo:
C:\Program Files\DMHelp.exe (.exe é opcional).
Primeiro parâmetro: Arquivo fonte
O primeiro parâmetro é obrigatório e deve sempre especificar o arquivo "fonte" do seu documento (com Path).
Utilize aspas ( " ) se for necessário (caso hajam espaços no meio), por exemplo:
"C:\My Path\Source\MyManual.dmh"
Demais parâmetros
Os demais parâmetros abaixo especificam os valores a serem aplicados no Form 5.3 Jobs.
Esses parâmetros são opcionais e podem ser fornecidos em qualquer sequência.
Se um parâmetro não for fornecido será assumido o seu valor default (se o DMHelp estiver sendo executado pela primeira vez), ou o valor da última vez que o programa DMHelp foi fechado (pois é aí que os parâmetros são salvos).
Caso um parâmetro seja repetido, somente o último será considerado.
Qualquer dos parâmetros deve ser fornecido com seu nome (em maiúsculas ou minúsculas), o sinal igual ( = ) e seu valor sem espaços, senão erros serão indicados.
OPATH
Especifica o Output Path.
Utilize aspas ( " ) se for necessário (caso hajam espaços no meio), por exemplo:
OPATH="C:\My OutputPath\" (o \ final deve ser fornecido).
Valor default: em função do nome do arquivo de entrada (no exemplo acima será C:\My Path\Converted\).
PRE
Especifica se o Preview será gerado.
Valores possíveis:
0 - não será gerado.
1 - será gerado.
Valor default: 0 (zero).
RTF
Especifica se o RTF será gerado.
Valores possíveis:
0 - não será gerado.
1 - será gerado .RTF.
2 - será gerado .DOC.
Valor default: 0 (zero).
HTMLS
Especifica se o HTML Single page será gerado.
Valores possíveis:
0 - não será gerado.
1 - será gerado .HTM.
2 - será gerado _.ASP.
Valor default: 0 (zero).
HTMLM
Especifica se o HTML Multi page será gerado.
Valores possíveis:
0 - não será gerado.
1 - será gerado .HTML.
2 - será gerado .ASP.
Valor default: 0 (zero).
LANG
Especifica o Language.
Valores possíveis:
1, 2, 3, etc.
Valor default: 1 (um).
CONV
Especifica se, após a carga dos parâmetros, será executada a conversão.
Valores possíveis:
0 - A conversão não será executada.
1 - A conversão será executada.
Em caso de erros de parâmetros este parâmetro não é aplicado.
Valor default: 0 (zero).
EXIT
Especifica se, após a carga dos parâmetros, e eventual conversão, o programa será fechado.
Valores possíveis:
0 - O programa não será fechado.
1 - O programa será fechado.
Em caso de erros de parâmetros este parâmetro não é aplicado.
Valor default: 0 (zero).
Observações
No caso do exemplo acima, os parâmetros serão carregados, a conversão será feita e o programa será fechado. Isso é útil no caso de conversões automáticas, porém, em casos de erros de sintaxe dos comandos DMHelp, o usuário não terá tempo de visualizá-los pois o programa se fechará logo após a conversão. Utilize, portanto, o parâmetro EXIT=1 de acordo com sua conveniência.