Este capítulo aborda a organização do processo de compilação da documentação e como o make(1) é utilizado para isso.
Diferentes tipos de saída podem ser produzidos a partir de um único arquivo fonte DocBook. O tipo de saída desejado é definido com a variável FORMATS
. Uma lista de formatos de saída conhecidos é armazenada em KNOWN_FORMATS
:
%
cd ~/doc/en_US.ISO8859-1/books/handbook
%
make -V KNOWN_FORMATS
Valor FORMATS | Tipo de Arquivo | Descrição |
---|---|---|
html | HTML, arquivo único | Um único book.html ou article.html . |
html-split | HTML, vários arquivos | Vários arquivos HTML, um para cada capítulo ou seção, para uso em um site comum. |
pdf | Portable Document Format |
O formato de saída padrão pode variar de acordo com o documento, mas geralmente é html-split
. Outros formatos são escolhidos definindo FORMATS
para um valor específico. Múltiplos formatos de saída podem ser criados de uma só vez definindo FORMATS
para uma lista de formatos.
%
cd ~/doc/en_US.ISO8859-1/books/handbook
%
make FORMATS=html
%
cd ~/doc/en_US.ISO8859-1/books/handbook
%
make FORMATS="html-split pdf"
All FreeBSD documents are available for download at https://download.freebsd.org/ftp/doc/
Questions that are not answered by the
documentation may be
sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.