O FDP utiliza diferentes ferramentas como auxílio no gerenciamento da documentação do FreeBSD, e na conversão para diferentes formatos, e assim por diante. Você irá precisar utilizar estas ferramentas se for trabalhar com a documentação do FreeBSD.
Todas estas ferramentas estão disponíveis como
Ports e Packages do FreeBSD,
simplificando enormemente o seu trabalho para
instalá-las.
Você precisará instalar estas ferramentas antes de trabalhar com qualquer exemplo dos próximos capítulos. O uso real destas ferramentas será abordado nos próximos capítulos.
textproc/docproj: Você pode economizar bastante tempo se instalar o
port textproc/docproj. Este é um
meta-port que por si só não
contém nenhum programa. Ao invés disto, ele
depende que já estejam instalados corretamente
vários outros ports. O processo de
instalação irá
baixar e instalar automaticamente todos os pacotes
listados como necessários neste capítulo.
Um dos pacotes que você pode precisar é o conjunto de macros JadeTeX. No entanto, esse conjunto de macros requer que o TeX esteja instalado. O TeX é um pacote grande, e ele somente será necessário se você quiser gerar documentos nos formatos Postscript ou PDF.
Para economizar seu tempo e espaço em disco
você deve especificar se quer, ou não, a
instalação do JadeTeX
(e por consequência do TeX) quando o
port for instalado. Conforme
necessário, faça:
# make JADETEX=yes installou
# make JADETEX=no installAlternativamente você pode instalar o
textproc/docproj-jadetex ou o
textproc/docproj-nojadetex.
Estes ports secundários irão
definir a variável JADETEX para
você, consequentemente eles irão instalar o mesmo
conjunto de aplicativos na sua máquina. Observe que
você poderá produzir apenas documentos em HTML e
ASCII se você não instalar o
JadeTeX. Para produzir documentos
em PostScript e PDF você irá precisar do TeX.
Estes programas são necessários para
você trabalhar com a documentação do
FreeBSD, e permitirão a conversão
da mesma para os formatos HTML, texto puro e RTF. Eles
estão todos incluídos em
textproc/docproj.
textproc/jade)Uma implementação DSSSL. Utilizado para a conversão de documentos escritos com linguagem de marcas para outros formatos, incluindo HTML e TeX.
www/tidy)Um HTML “pretty printer” , utilizado para reformatar alguns dos HTMLs gerados automaticamente ficando mais fácil de entendê-los.
www/links)Um navegador WWW em modo texto que também converte arquivos HTML para texto puro.
graphics/peps)Parte da documentação inclui imagens,
algumas delas estão armazenadas como arquivos EPS.
Estas imagens precisam ser convertidas para o formato
PNG antes de serem exibidas em um navegador
web.
Estes são os conjuntos de DTDs e de entidades usados pelo FDP. Eles precisam estar instalados para que você possa trabalhar com qualquer parte da documentação.
textproc/html)HTML é a linguagem de marcas escolhida para a
World Wide Web, e é usada no
web site do FreeBSD.
textproc/docbook)
DocBook é uma linguagem de marcas projetada para documentação técnica. Toda a documentação do FreeBSD está escrita em DocBook.
textproc/iso8879)
19 dos conjuntos de entidade de caracter ISO 8879:1986 utilizados por muitos DTDs. Inclui símbolos matemáticos nomeados, caracteres do conjunto de caracter Latin (acentos, diacríticos e assim por diante), e símbolos gregos.
As Stylesheets são usadas na
conversão e formatação de documentos
para serem apresentados na tela, impressos, e assim por
diante.
textproc/dsssl-docbook-modular
)As Modular DocBook Stylesheets
são usadas na conversão da
documentação escrita em DocBook para
outros formatos, tais como HTML ou RTF.
Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Para perguntas sobre FreeBSD, leia a
documentação antes de contatar
<questions@FreeBSD.org>.
Para perguntas sobre esta documentação, envie e-mail para
<doc@FreeBSD.org>.