4.10 Inclusão de arquivos

Comando Descrição IN <IN [atributos]> Atributo Descrição Tipo Default FN File Name Nome do arquivo (em branco) FT File Name To Nome do arquivo (em branco)

Inclui um arquivo para processamento.

Em manuais extensos (como este que você está lendo, por exemplo) pode ser conveniente, ou desejável, que o arquivo "fonte" seja "quebrado" em vários arquivos para uma melhor organização e manutenção dos dados nos mesmos.

Este comando permite isso. Deste modo você pode incluir capítulos (com uma ou mais páginas) em arquivos separados.

Uma aplicação interessante é quando você tem observações longas (com vários parágrafos) a ser incluída em mais de um ponto no seu documento. Assim ao invés do tradicional "copy" "paste" você cria um arquivo com tais observações e utiliza este comando nos pontos que desejar. Se você precisar modificar tais observações basta modificar o arquivo que é incluído e converter novamente o documento que todos os pontos onde o mesmo for incluído serão modificados.

Este comando pode ser aplicado em qualquer ponto de seu documento, mesmo dentro de células de tabelas, por exemplo.

São permitidos cascateamentos sem limites de inclusões, ou seja um arquivo inlui outro, que inclui outro, etc.

Especial atenção deve ser tomada para se evitar inclusões cíclicas, ou seja, em casos onde, por exemplo, um arquivo incui outro que incui outro que, por sua vez inclui o primeiro; ou ainda: um arquivo que inclui a si mesmo. Nesses casos, o programa DMHelp fica "em loop" e somente encerra por Timeout (vide Form 5.4.3 Conversion Options) ou quando você pressionar a tecla Esc (escape).

Atributo "FN" : File Name

Define o nome de arquivo que especifica o arquivo a ser inserido.

Atributo "FT" : File Name To

Define o nome de arquivo que especifica o nome a ser renomeado para o arquivo original.

Consulte 6.2.7 Nome de Arquivo para mais informações.

Importante

Este comando não é afetado pelo comando DOC (<DOC [atributos]>), ou seja, todas as declarações de includes resultarão na inclusão dos arquivos correspondentes, independentemente do atributo Language ou dos atributos AP... no comando DOC.

Exemplo

Consulte:

...\DMHelp\Examples\Include

para um exemplo completo da utilização deste comando.