Primer do Projeto de Documentação do FreeBSD para novos colaboradores

Primer

Você tem email.
% su
Password:
# cd /usr/ports/textproc/docproj
# make JADETEX=no install
% mkdir -p head/share
% mkdir -p head/en_US.ISO8859-1/share
% svn checkout svn://svn.FreeBSD.org/doc/head/share head/share
% svn checkout svn://svn.FreeBSD.org/doc/head/en_US.ISO8859-1/share head/en_US.ISO8859-1/share
% svn checkout svn://svn.FreeBSD.org/doc/head head
% svn checkout svn://svn.FreeBSD.org/doc/head/en_US.ISO8859-1/articles
% cd head/en_US.ISO8859-1/articles
% svn export committers-guide vpn-w2k
% svn checkout svn://svn.FreeBSD.org/doc/head/en_US.ISO8859-1/books/faq
% make lint
% make FORMATS=html
% make FORMATS=html
% make FORMATS=txt
% make FORMATS="html txt"
# make JADETEX=yes install
# make JADETEX=no install
% rm /tmp/foo
<para>Para remover <filename>/tmp/foo</filename> utilize &man.rm.1;.</para>

<screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>
Este é um parágrafo. Ele inicia com a tag de inicio do 
 elemento 'p', e irá terminar com a tag de fim para o 
 elemento 'p'.

Este é um outro parágrafo. Mas este é muito menor.
Este é um parágrafo.

<hr>

Este é outro parágrafo. Uma linha horizontal o separa do 
 parágrafo anterior.
Este é um parágrafo simples no qual 
 algumas das palavras foram enfatizadas.
A inclusão de um atributo de alinhamento neste 
 parágrafo foi supérfluo, uma vez que o alinhamento 
 padrão é left (esquerda).

<p align="center">Isto pode aparecer no centro.</p>
<p align='right'>Eu estou a direita!</p>
SGML_ROOT=/usr/local/share/xml	    
SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/doc/share/xml/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES
export SGML_CATALOG_FILES
setenv SGML_ROOT /usr/local/share/xml
setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES /usr/doc/share/xml/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
  <head>	     
    <title>Um exemplo de arquivo HTML</title>
  </head>

  <body>	    
    <p>Este é um parágrafo contendo algum texto.</p>

    <p>Este parágrafo contém mais algum texto.</p>

    <p align="right">Este parágrafo pode estar alinhado a direita.</p>
  </body>	    
</html>
% onsgmls -s example.xml
% onsgmls -s example.xml
onsgmls:example.xml:5:4:E: character data is not allowed here
onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN">
"Proprietário//Palavra-Chave Descrição//Idioma"
PUBLIC "-//W3C//DTD HTML 4.0//EN" "4.0/strict.dtd"
<!DOCTYPE html SYSTEM "/path/to/file.dtd">
<!-- Teste de comentário -->
<!-- Este é o interior do comentário -->

<!-- Este é outro comentário    -->

<!-- Esta é uma forma 
     de fazer comentários de várias linhas -->

<!-- Esta é outra forma  --
  -- de fazer comentários de várias linhas -->
<!-- Este é o comentário --

     Isto está fora do comentário!

  -- de volta para dentro do comentário -->
<!Isto está fora do comentário>
<!----- Isto é uma idéia muito ruim ----->
<!--===================================================-->
<para>A versão atual do nosso produto é &amp;current.version;.</para>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY current.version    "3.0-RELEASE">
<!ENTITY last.version       "2.2.7-RELEASE">
]>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % param.some "some">
<!ENTITY % param.text "text">
<!ENTITY % param.new  "%param.some more %param.text">
]>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY version "1.1">
]>	  

<html>
  <head>	     
    <title>Um exemplo de arquivo HTML</title>
  </head>

  <body>	    
    <p>Este é um parágrafo contendo algum texto.</p>

    <p>Este parágrafo contém mais algum texto.</p>

    <p align="right">Este parágrafo pode estar alinhado a direita.</p>

    <p>A versão atual deste documento é: &amp;version;</p>	  
  </body>	    
</html>
% osgmlnorm example.xml > example.html
% osgmlnorm -d example.xml > example.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY chapter.1 SYSTEM "chapter1.xml">
<!ENTITY chapter.2 SYSTEM "chapter2.xml">
<!ENTITY chapter.3 SYSTEM "chapter3.xml">
]>

<html>

  &chapter.1;
  &chapter.2;
  &chapter.3;
</html>
<!ENTITY chapter.1 SYSTEM "chapter1.xml">
<!ENTITY chapter.2 SYSTEM "chapter2.xml">
<!ENTITY chapter.3 SYSTEM "chapter3.xml">
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % chapters SYSTEM "chapters.ent">
%chapters;
]>

<html>
  &amp;chapter.1;
  &amp;chapter.2;
  &amp;chapter.3;
</html>
<p>Este é o primeiro parágrafo.</p>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY version "1.1">
<!ENTITY para1 SYSTEM "para1.xml">
<!ENTITY para2 SYSTEM "para2.xml">
<!ENTITY para3 SYSTEM "para3.xml">
]>

<html>
  <head>
    <title>Um exemplo de arquivo HTML</title>
  </head>

  <body>
    <p>A versão atual deste documento é: &amp;version;</p>

    &amp;para1;
    &amp;para2;
    &amp;para3;
  </body>
</html>
% osgmlnorm -d example.xml > example.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % entities SYSTEM "entities.xml"> %entities;
]>

<html>
  <head>
    <title>Um exemplo de arquivo HTML</title>
  </head>

  <body>
    <p>A versão atual deste documento é: &amp;version;</p>

    &amp;para1;
    &amp;para2;
    &amp;para3;
  </body>
</html>
<!ENTITY version "1.1">
<!ENTITY para1 SYSTEM "para1.xml">
<!ENTITY para2 SYSTEM "para2.xml">
<!ENTITY para3 SYSTEM "para3.xml">
% osgmlnorm -d example.xml > example.html
<![ Palavra-chave [
  Conteúdo da sessão marcada
]]>
<para>Aqui está um exemplo de como você incluiria algum texto que contenha muitos 
  símbolos <literal><</literal> e <literal>></literal>.
  O texto de exemplo é um fragmento de HTML.  
  O texto circunvizinho (<para> e <programlisting>) é do
  DocBook.</para>

<programlisting>
  <![CDATA[>![RCDATA[
    <p>Esta é uma amostra que apresenta alguns elementos de HTML.
       Uma vez que os símbolos de < e > são utilizados muitas vezes, é
       mais fácil dizer que o exemplo todo é uma sessão marcada do
       tipo CDATA, do que utilizar nomes de entidades para representar
       estes símbolos ao longo de todo o texto.</p>

    <ul>
      <li>Este é um item de lista</li>
      <li>Este é um segundo item de lista</li>
      <li>Este é um terceiro item de lista</li>
    </ul>

    <p>Este é o final do exemplo.</p>]]>
  ]]>
</programlisting>
<![ INCLUDE [
  Este texto será processado e incluído.
]]>

<![ IGNORE [
  Este texto não será processado nem incluído.
]]>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % electronic.copy "INCLUDE">	     
]]>

...

<![ %electronic.copy [
 Este conteúdo deve aparecer apenas na versão eletrônica do
 documento.
]]>
<!ENTITY % electronic.copy "IGNORE">
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % text.output "INCLUDE">
]>

<html>
  <head>
    <title>Um exemplo utilizando uma sessão marcada.</title>
  </head>

  <body>	    
    <p>Este parágrafo <![CDATA[contêm muitos caracteres <
      (< < < < <) de forma que é mais simples utilizar
      uma sessão marcada do tipo CDATA.]]></p>

    <![ IGNORE [
    <p>Este parágrafo definitivamente não será incluído
      no output.</p>
    ]]>

    <![ %text.output [
    <p>Este parágrafo pode ou não aparecer no output.</p>

    <p>A sua ocorrência é controlada pela entidade de parâmetro %text.output
      .</p>	    
    ]]>
  </body>
</html>
PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
<html>
  <head>
	  <title>Título do Documento</title>
  </head>

  <body>

    …

  </body>
</html>
<h1>Primeira seção</h1>

<!-- a introdução do documento entra aqui -->

<h2>Este é o cabeçalho da primeira seção</h2>

<!-- O conteúdo da primeira seção entra aqui -->

<h3>Este é o cabeçalho da primeira subseção</h3>

<!-- O conteúdo da primeira subseção entra aqui -->

<h2>Este é o heading para a segunda seção</h2>

<!-- O conteúdo da segunda seção entra aqui -->
<h1>Primeira seção</h1>

<!-- Introdução do documento -->

<h3>Subseção</h3>

Isto é um parágrafo. Pode conter qualquer outro elemento
Um pequeno trecho da constituição dos Estados Unidos:

<blockquote>
Nós, povo dos Estados Unidos, com o objetivo de fazer uma 
união mais perfeita, estabelecer justiça, garantir 
tranquilidade doméstica, promover uma defesa comum, promover 
bem estar geral, assegurar as benções da liberdade para
nós mesmos e nossa posteridade, organizamos e estabelecemos 
essa constituição para os estados Unidos da América.
</blockquote>
Uma lista não ordenada. Os itens serão provavelmente 
precedidos por uma esfera sólida.

<ul>
  <li>Primeiro item</li>

  <li>Segundo item</li>

  <li>Terceiro item</li>
</ul>

Uma lista ordenada, com itens de lista com vários
parágrafos. Cada item (nota: não cada parágrafo)
será numerado.

<ol>
 <li>Este é o primeiro item. Tem apenas um parágrafo.</li>

  <li><p>Este é o primeiro parágrafo do segundo item.</p>

    <p>Este é o segundo parágrafo do segundo item.</p></li>

  <li><p>Este é o primeiro e único parágrafo do terceiro item.</p></li>
</ol>
<dl>
  <dt>Termo 1</dt>

  <dd><p>Parágrafo 1 da definição 1.</p>

    <p>Parágrafo 2 da definição 1.</p></dd>

  <dt>Termo 2</dt>

  <dd><p>Parágrafo 1 da definição 2.</p></dd>

  <dt>Termo 3</dt>

  <dd><p>Parágrafo 1 da definição 3.</p></dd>
</dl>
<pre>  
  From: nik@FreeBSD.org
  To: freebsd-doc@FreeBSD.org
  Subject: New documentation available

  There is a new copy of my primer for contributors to the FreeBSD
  Documentation Project available at

	&lt;URL:http://people.FreeBSD.org/~nik/primer/index.html&gt;

  Comments appreciated.

  N
</pre>
<p>Esta é uma simples tabela 2x2.</p>

<table>
  <tr>
    <td>Célula esquerda superior</td>

    <td>Célula direita superior</td>
  </tr>

  <tr>
    <td>Célula esquerda inferior</td>

    <td>Célula direita inferior</td>
  </tr>
</table>
<p>Uma célula comprida e estreita na esquerda e duas 
células pequenas à direita.</p>

<table>
  <tr>
    <td rowspan="2">Comprida e estreita</td>
  </tr>

  <tr>
    <td>Célula superior</td>

    <td>Célula inferior</td>
  </tr>
</table>
<p>Uma célula longa em cima, duas células abaixo.</p>

<table>
  <tr>
    <td colspan="2">Célula superior</td>
  </tr>

  <tr>
    <td>Célula inferior esquerda</td>

    <td>Célula inferior direita</td>
  </tr>
</table>
<p>Numa tabela 3x3, o bloco superior esquerdo é um conjunto 
2x2 fundidos em um.  As outras células são normais.</p>

<table>
  <tr>
    <td colspan="2" rowspan="2">Célula esquerda superior grande</td>

    <td>Célula direita superior</td>
  </tr>

  <tr>
    <td>Célula do meio a direita</td>
  </tr>

  <tr>
    <td>Célula inferior esquerda</td>

    <td>Célula inferior central</td>

    <td>Célula inferior direita</td>
  </tr>
</table>
<p><em>Este</em> foi enfatizado
enquanto <strong>este</strong> foi fortemente enfatizado.</p>

<p><b>Este</b> esta em negrito, 
enquanto <i>este</i> está em itálico.</p>

Este documento foi originalmente por
Nik Clayton, que pode ser encontrado por email em
<tt>nik@FreeBSD.org</tt>.
Este texto é ligeiramente menor. 
Mas este texto é <big>ligeiramente maior</big>.

Este texto é ligeiramente menor. 
Mas este texto é ligeiramente maior.

Este texto é ligeiramente menor. 
Mas este texto é ligeiramente maior.
Maiores informações estão disponíveis no 
<a href="http://www.FreeBSD.org/">web site do FreeBSD</a>.
<a name="para1">Este</a> parágrafo pode ser referenciado
em outros links com o nome<tt>para1</tt>.
Mais informação no <a href="foo.html#para1">primeiro 
parágrafo</a> de <tt>foo.html</tt>.

<p>Mais informação no <a href="#para1">primeiro 
parágrafo</a> deste documento.</p>
PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN"
<book>
  <bookinfo>
    <title>Seu título aqui</title>

    <author>
      <firstname>Seu primeiro nome aqui</firstname>
      <surname>Seu sobrenome</surname>
      <affiliation>
        <address><email>Seu endereço de correio eletrônico aqui</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>1998</year>
      <holder role="mailto:seu endereço de email">Seu nome</holder>
    </copyright>

    <releaseinfo>$FreeBSD$</releaseinfo>

    <abstract>
      <para>Inclua um resumo do conteúdo do seu livro aqui.</para>
    </abstract>
  </bookinfo>

  …

</book>
<article>
  <articleinfo>
    <title>Seu título aqui</title>

    <author>
      <firstname>Seu primeiro nome</firstname>
      <surname>Seu sobrenome</surname>
      <affiliation>
        <address><email>Seu endereço de email</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>1998</year>
      <holder role="mailto:seu endereço de email">Seu nome</holder>
    </copyright>

    <releaseinfo>$FreeBSD$</releaseinfo>

    <abstract>
      <para>Inclua um resumo do conteúdo do artigo aqui.</para>
    </abstract>
  </articleinfo>

  …

</article>
<chapter>
  <title>Título do capítulo</title>

...
</chapter>
<chapter>
 <title>Isto é um capítulo vazio</title>

  <para></para>
</chapter>
<chapter>
  <title>Um exemplo de capítulo</title>

  <para>Algum texto dentro do capítulo</para>

  <sect1>
    <title>Primeira seção (1.1)</title>

    &hellip;
  </sect1>

  <sect1>
    <title>Segunda seção (1.2)</title>

    <sect2>
      <title>Primeira subseção (1.2.1)</title>

      <sect3>
        <title>Primeira sub-subseção (1.2.1.1)</title>

        &hellip;
      </sect3>
    </sect2>

    <sect2>
      <title>Segunda subseção (1.2.2)</title>

      &hellip;
    </sect2>
  </sect1>
</chapter>
<part>
  <title>Introdução</title>

  <chapter>
    <title>Visão Geral</title>

    ...
  </chapter>

  <chapter>
    <title>O que é FreeBSD?</title>

    ...
  </chapter>

  <chapter>
    <title>História</title>

    ...
  </chapter>
</part>
<para>Isso é um parágrafo.  E pode conter quase 
  qualquer outro elemento.</para> 
<para>Um pequeno pedaço da Constituição dos Estados Unidos:</para>

<blockquote>
  <title>Preâmbulo da constituição dos Estados Unidos.</title>

  <attribution>Copiado de um site qualquer</attribution>

  <para>Nós, povo dos Estados Unidos, com o objetivo de
  fazer uma união mais perfeita, estabelecer justiça,
  garantir tranquilidade doméstica, promover uma defesa comum, promover 
  bem estar geral, assegurar as benções da
  liberdade para nós mesmos e nossa posteridade, organizamos e
  estabelecemos essa constituição para os estados Unidos
  da América.</para>
</blockquote>
<warning>
<para>Instalar o FreeBSD talvez faça com que você queira
desinstalar o Windows do seu Hard disk.</para>
</warning>
<itemizedlist>
  <listitem>
    <para>Esse é o primeiro item enumerado.</para>
  </listitem>

  <listitem>
    <para>Esse é o segundo item enumerado.</para>
  </listitem>
</itemizedlist>

<orderedlist>
  <listitem>
    <para>Esse é o primeiro item ordenado.</para>
  </listitem>

  <listitem>
    <para>Esse é o segundo item ordenado.</para>
  </listitem>
</orderedlist>

<procedure>
  <step>
    <para>Faça isto.</para>
  </step>

  <step>
    <para>Depois faça isto.</para>
  </step>

  <step>
    <para>E agora faça isto.</para>
  </step>
</procedure>
<para>Quando você tiver terminado, seu programa deve estar assim:</para>

<programlisting>#include &lt;stdio.h&gt;

int
main(void)
{
    printf("hello, world\n");
}</programlisting>
#include <stdio.h>

int
main(void)
{
    printf("hello, world\n");
}
<para>Quando você tivert terminado, seu prograva deve estar assim;</para>

<programlisting>#include &lt;stdio.h&gt; <co id="co-ex-include"/>

int <co id="co-ex-return"/>
main(void)
{
    printf("hello, world\n"); <co id="co-ex-printf"/>
}</programlisting>

<calloutlist>
  <callout arearefs="co-ex-include">
    <para>Inclui o arquivo padrão de IO.</para>
  </callout>

  <callout arearefs="co-ex-return">
    <para>Especifica que <function>main()</function> retorna um inteiro.</para>
  </callout>

  <callout arearefs="co-ex-printf">
    <para>A chamada <function>printf()</function> que escreve <literal>hello,
      world</literal> na saída padrão.</para>
  </callout>
</calloutlist>
#include <stdio.h> 

int 
main(void)
{
    printf("hello, world\n"); 
}
<informaltable pgwide="1">
  <tgroup cols="2">
    <thead>
      <row>
        <entry>Este é o cabeçalho da coluna 1</entry>
        <entry>Este é o cabeçalho da coluna 2</entry>
      </row>
    </thead>

    <tbody>
      <row>
        <entry>Linha 1, coluna 1</entry>
        <entry>Linha 1, coluna 2</entry>
      </row>

      <row>
        <entry>Linha 2, coluna 1</entry>
        <entry>Linha 2, coluna 2</entry>
      </row>
    </tbody>
  </tgroup>
</informaltable>
<screen>&prompt.user; <userinput>ls -1</userinput>
foo1
foo2
foo3
&prompt.user; <userinput>ls -1 | grep foo2</userinput>
foo2
&prompt.user; <userinput>su</userinput>
<prompt>Password: </prompt>
&prompt.root; <userinput>cat foo2</userinput>
This is the file called 'foo2'</screen>
% ls -1
foo1
foo2
foo3
% ls -1 | grep foo2
foo2
% su
Password: 
# cat foo2
This is the file called 'foo2'
<para>O FreeBSD é sem dúvida <emphasis>o</emphasis> melhor sistema operacional tipo Unix
para a arquitetura Intel.</para>
<para>Entretanto, certifique-se que a busca não vá além do <quote>limite entre 
  a administração local e pública</quote> como diz o RFC 1535.</para>
<para>Para mudar para o segundo terminal virtual, digite 
  <keycombo action="simul"><keycap>Alt</keycap>
    <keycap>F1</keycap></keycombo>.</para>

<para>Sair do <command>vi</command> sem salvar o seu trabalho, digite
  <keycombo action="seq"> <keycap>Esc</keycap><keycap>:</keycap>
    <keycap>q</keycap><keycap>!</keycap></keycombo>.</para>

<para>Meu gerenciador de janela é configurado de forma que 
  <keycombo action="simul"><keycap>Alt</keycap>
    <mousebutton>botão direito</mousebutton>
  </keycombo> do mouse é usado para mover as janelas.</para>

PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"
<!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [

<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;

…

]>
<para>O <application>Sendmail</application> é a aplicação 
  de email mais utilizada em Unix.</para>

<para>O <application>Sendmail</application> inclui os programas 
  <citerefentry>
    <refentrytitle>Sendmail</refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>, &man.mailq.1;, e &man.newaliases.1;.</para>

<para>Um dos parâmetros de linha de comando para o <citerefentry>
    <refentrytitle>Sendmail</refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>, <option>-bp</option>, ira mostrar o atual estado da
  mensagem na fila de email. 
  Verifique isto na linha de comando usando <command>sendmail -bp</command>.</para>
<para>O fonte SGML do Handbook em Inglês pode ser encotrado em 
  <filename class="directory">/usr/doc/en_US.ISO8859-1/books/handbook/</filename>.  
  O primeiro arquivo neste diretório é chamado <filename>book.xml</filename>. 
  Você também deve ver o <filename>Makefile</filename> 
  e alguns arquivos com a extensão <filename>.ent</filename>.</para>
<para>Instale o port <filename role="package">net/ethereal</filename>
para ver o tráfego na rede.</para>
<para><devicename>sio</devicename> é usado para comunicação
  serial no FreeBSD. <devicename>sio</devicename> se manifesta 
  através de entradas em <filename>/dev</filename>, incluindo 
  <filename>/dev/ttyd0</filename> e <filename>/dev/cuaa0</filename>.
  </para>

<para>Por outro lado, dispositivos de rede, tais como <devicename>ed0</devicename> 
 não aparecem <filename>/dev</filename>.
 </para>

<para>No MS-DOS, o primeiro disco flexível é chamado de <devicename>a:</devicename>. 
 No FreeBSD é <filename>/dev/fd0</filename>.
 </para>
<para>A máquina local sempre pode ser referida pelo nome 
<hostid>localhost</hostid>, que terá o endereço IP
<hostid role="ipaddr">127.0.0.1</hostid>.</para>

<para>O domínio <hostid role="domainname">FreeBSD.org</hostid>
contém vários hosts diferentes, incluindo 
<hostid role="fqdn">freefall.FreeBSD.org</hostid> e 
<hostid role="fqdn">pointyhat.FreeBSD.org</hostid>.</para>

<para>Quando estiver adicionando um apelido para uma interface (usando 
<command>ifconfig</command>) <emphasis>sempre</emphasis> use a
máscara de rede <hostid role="netmask">255.255.255.255</hostid> (que
também pode ser expressa como <hostid role="netmask">0xffffffff</hostid>).
</para>

<para>O endereço MAC identifica unicamente cada placa de rede 
existente. Um endereço MAC típico se parece com <hostid
role="mac">08:00:20:87:ef:d0</hostid>).</para>

<para>Para executar a maioria das funções administrativas você precisará 
  ser <username>root</username>.</para>
<para>Dois alvos comuns em um <filename>Makefile</filename> são
<maketarget>all</maketarget> e <maketarget>clean</maketarget>.</para>

<para>Tipicamente, usar <maketarget>all</maketarget> irá refazer a
aplicação, usar <maketarget>clean</maketarget> irá remover os
arquivos temporários (<filename>.o</filename> por exemplo) criados
pelo processo de construção.</para>

<para><maketarget>clean</maketarget> pode ser controlado por
muitas variáveis, incluindo <makevar>CLOBBER</makevar> e
<makevar>RECURSE</makevar>.</para>

 <para>A linha <literal>maxusers 10</literal> no arquivo de 
configuração do kernel determina o tamanho de muitas tabelas 
do sistema, e diz aproximadamente quantos logins simultâneos
o sistema irá suportar.</para>

<screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput></screen>
% man comando
<para>A linha <literal>maxusers <replaceable>n</replaceable></literal> 
no arquivo de configuração do kernel determina o tamanho de muitas 
tabelas do sistema, e diz aproximadamente quantos logins simultâneos
o sistema irá suportar.
</para>

<para>Para uma estação de trabalho, <literal>32</literal> é um
bom valor para <replaceable>n</replaceable>.</para>

<screen><errorname>Panic: cannot mount root</errorname></screen> 

Panic: cannot mount root
<mediaobject>
  <imageobject>
    <imagedata fileref="fig1"> 
  </imageobject>

  <textobject>
    <literallayout class="monospaced">+---------------+ 
|       A       |
+---------------+</literallayout>
  </textobject>

  <textobject>
    <phrase>Uma figura</phrase> 
  </textobject>
</mediaobject>
…
IMAGES= fig1.eps fig2.png fig3.png
…
…
IMAGES=  fig1.eps
IMAGES+= fig2.png
IMAGES+= fig3.png
…
<mediaobject>
  <imageobject>
    <imagedata fileref="chapter1/fig1"> 
  </imageobject>

  …

</mediaobject>
…
IMAGES=  chapter1/fig1.png
…
<chapter id="chapter1">
  <title>Introdução</title>

  <para>Esta é a introdução.  Contém uma 
    subseção que também será identificada.
  </para>
  <sect1 id="chapter1-sect1">
    <title>Subseção 1</title>

    <para>Esta é a subseção.</para>
  </sect1>
</chapter>
<para>
Este parágrafo tem um <anchor id="para1">alvo dentro dele. 
O qual não irá aparecer no documento
</para>
<para>Maiores informações podem ser encontradas
  em <xref linkend="chapter1"/></para>

<para>Informações mais específicas podem ser 
  encontradas na <xref linkend="chapter1-sect1"/>.</para>

<para>Maiores informações podem ser encontradas
<link linkend="chapter1">no primeiro capítulo</link>.
</para>

<para>Informações mais específicas podem ser encontradas
<link linkend="chapter1-sect1">nesta</link> seção
</para>

<para>É claro que você pode parar de ler este documento e ir para a
<ulink url="&url.base;/index.html">Página principal do FreeBSD</ulink>
</para>

<chapter id="kernelconfig">
...
</chapter>
SUBDIR =articles
SUBDIR+=books

COMPAT_SYMLINK = en

DOC_PREFIX?= ${.CURDIR}/..
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
MAINTAINER=nik@FreeBSD.org

DOC?= book

FORMATS?= html-split html

INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=

# SGML content
SRCS=  book.xml

DOC_PREFIX?= ${.CURDIR}/../../..

.include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk"
DOCFORMAT?=	docbook
MAINTAINER?=	doc@FreeBSD.org

PREFIX?=	/usr/local
PRI_LANG?=	en_US.ISO8859-1

.if defined(DOC)
.if ${DOCFORMAT} == "docbook"
.include "doc.docbook.mk"
.endif
.endif

.include "doc.subdir.mk"
.include "doc.install.mk"
_SUBDIRUSE: .USE
.for entry in ${SUBDIR}
	@${ECHO} "===> ${DIRPRFX}${entry}"
	@(cd ${.CURDIR}/${entry} && \
	${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
.endfor
clean: _SUBDIRUSE
	rm -f ${CLEANFILES}
_SUBDIRUSE: .USE
.for entry in ${SUBDIR}
	@${ECHO} "===> ${DIRPRFX}${entry}"
	@(cd ${.CURDIR}/${entry} && \
	${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
.endfor
# pkg_delete jade-1.1
# cd /usr/ports/devel/subversion
# make install clean
# svn checkout svn://svn.FreeBSD.org/doc/head/ /usr/build
# cd /usr/build
# cd en_US.ISO8859-1/htdocs 
# make all
# cd /usr/build/en_US.ISO8859-1/htdocs
# env DESTDIR=/usr/local/www make install
# find /usr/local/www -ctime 3 -print0 | xargs -0 rm
# make ENGLISH_ONLY=YES all install
# make ENGLISH_ONLY="" all install clean
# make WEB_ONLY=YES all install
# make WEB_LANG="el_GR.ISO8859-7 es_ES.ISO8859-1 hu_HU.ISO8859-2 nl_NL.ISO8859-1" all install
% svn checkout svn://svn.FreeBSD.org/doc/head/ head
% svn diff -r33733:33734 en_US.ISO8859-1/books/fdp-primer/book.xml
head/
    sv_SE.ISO8859-1/
                     Makefile 
		     htdocs/
			    docproj
                     books/
                           faq/
                               Makefile
                               book.xml
% cd doc
% tar cf swedish-docs.tar sv_SE.ISO8859-1
% gzip -9 swedish-docs.tar
<!--
     The FreeBSD Documentation Project

     $FreeBSD: head/en_US.ISO8859-1/books/faq/book.xml 38674 2012-04-14 13:52:52Z $
-->
<!--
     The FreeBSD Spanish Documentation Project
     $FreeBSD: head/es_ES.ISO8859-1/books/faq/book.xml 38826 2012-05-17 19:12:14Z hrs $ 
     Original revision: r38674 
     -->
+--- This is column 0
V
<chapter>
  <title>...</title>

  <sect1>
    <title>...</title>

    <sect2>
      <title>Indentation</title>

      <para>Each file starts with indentation set at column 0,
	<emphasis>regardless</emphasis> of the indentation level of the file
	which might contain this one.</para>
      ...  
    </sect2>
  </sect1>
</chapter>
augroup sgmledit 
  autocmd FileType sgml set formatoptions=cq2l " Special formatting options 
  autocmd FileType sgml set textwidth=70       " Wrap lines at 70 spaces 
  autocmd FileType sgml set shiftwidth=2       " Automatically indent 
  autocmd FileType sgml set softtabstop=2      " Tab key indents 2 spaces 
  autocmd FileType sgml set tabstop=8          " Replace 8 spaces with a tab 
  autocmd FileType sgml set autoindent         " Automatic indentation 
augroup END
<article>
  <articleinfo>
    <title>NIS</title>

    <pubdate>October 1999</pubdate>

    <abstract>
      <para>...
  ...
  ...</para>
    </abstract>
  </articleinfo>

  <sect1>
    <title>...</title>

    <para>...</para>
  </sect1>

  <sect1>
    <title>...</title>

    <para>...</para>
  </sect1>
</article>
   Data capacity ranges from 40 MB to 15 
   GB.  Hardware compression …
57600&nbsp;bps
FreeBSD&nbsp;4.7
Sun&nbsp;Microsystems
    (defun local-sgml-mode-hook
      (setq fill-column 70
            indent-tabs-mode nil
            next-line-add-newlines nil
            standard-indent 4
            sgml-indent-data t)
      (auto-fill-mode t)
      (setq sgml-catalog-files '("/usr/local/share/xml/catalog")))
    (add-hook 'psgml-mode-hook
      '(lambda () (local-psgml-mode-hook)))
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<book>
  <bookinfo>
    <title>Um exemplo de Livro</title>

    <author>
      <firstname>Seu nome</firstname>
      <surname>Seu sobrenome</surname>
      <affiliation>
        <address><email>seuemail@example.com</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>2000</year>
      <holder>Texto de Copyright</holder>
    </copyright>

    <abstract>
      <para>Se seu livro possui um sumário ele deve ser colocado aqui.</para>
    </abstract>
  </bookinfo>

  <preface>
    <title>Prefácio</title>

    <para>Seu livro pode ter um prefácio, se este for o caso, ele deve
      ser colocado aqui.</para>
  </preface>

  <chapter>
    <title>Meu primeiro capítulo</title>

    <para>Este é o primeiro capítulo do meu livro.</para>

    <sect1>
      <title>Minha primeira seção</title>

      <para>Esta é a primeira seção do meu livro.</para>
    </sect1>
  </chapter>
</book>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<article>
  <articleinfo>
    <title>Um exemplo de Artigo</title>

    <author>
      <firstname>Seu nome</firstname>
      <surname>Seu sobrenome</surname>
      <affiliation>
        <address><email>seuemail@example.com</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>2000</year>
      <holder>Texto de Copyright</holder>
    </copyright>

    <abstract>
      <para>Se o seu artigo possuir um sumário ele deve ser colocado aqui.</para>
    </abstract>
  </articleinfo>

  <sect1>
    <title>Minha primeira seção</title>

    <para>Esta é a primeira seção do meu artigo.</para>

    <sect2>
      <title>Minha primeira subseção</title>

      <para>Esta é a primeira subseção do meu artigo.</para>
    </sect2>	
  </sect1>
</article>
% jade -V nochunks \  
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \
    -t sgml  file.xml > file.html 
% jade \
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \
    -t sgml  file.xml 
% jade -V tex-backend \ 
    -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ 
    -c /usr/local/share/xml/docbook/catalog \
    -c /usr/local/share/xml/jade/catalog \
    -d /usr/local/share/xml/docbook/dsssl/modular/print/docbook.dsl \
    -t tex  file.xml
% tex "&jadetex" file.tex
% dvips -o file.ps file.dvi
% pdftex "&pdfjadetex" file.tex

Usuário	Prompt
Usuário normal	`%`
`root`	`#`

Propósito	Exemplos
Nome de um comando.	Utilize `ls -a` para listar todos os arquivos.
Nome de um arquivo.	Edite o seu arquivo `.login` .
Saída (output) de um programa na tela do computador.	Você tem email.
O que você digita, quando contrastado com a saída (output) do programa na tela do computador.	`%` `su` Password:
Referência a uma página de manual.	Utilize o su(1) para assumir outro nome de usuário.
Nome de usuário e de grupos de usuários	Apenas o `root` pode fazer isso.
Ênfase	Você deve fazer isso.
Variáveis da linha de comando; Substitua com o nome real ou com a variável.	Para deletar um arquivo, digite `rm nome_do_arquivo`
Variáveis de ambiente	O `$HOME` é o seu diretório `home`.

Coluna	Propósito
1	O nome do programa que está gerando o erro. Ela será sempre `onsgmls`.
2	O nome do arquivo que contém o erro.
3	Número da linha na qual o erro aparece.
4	Número da coluna na qual o erro aparece.
5	Um código de uma letra indicando a natureza da mensagem. `I` indica uma mensagem informativa, `W` é para um aviso, e `E` é para um erro ^[a], e `X` é para uma referência cruzada. Como você pode ver, estas mensagens são erros.
6	O texto da mensagem.
^[a]Ele não está sempre na quinta coluna. O `onsgmls -sv` exibe `onsgmls:I: "OpenSP" version "1.5.2"` (depende da versão instalada). Como você pode ver, esta é uma mensagem informativa.

9.1.	Porque um `FAQ`?
	Mais e mais pessoas estão se juntando à lista de discussão FreeBSD-doc e estão se oferecendo para traduzir a documentação do FreeBSD para outras línguas. Este `FAQ` visa responder as suas perguntas, de forma que eles possam iniciar a tradução da documentação o quanto antes.
9.2.	O que significa i18n e l10n
	i18n significa internacionalização e l10n significa locallização. São apenas abreviações. i18n pode ser lido como “i” seguido por 18 letras, seguidas por “n”. Similarmente, l10n é “l” seguido por 10 letras, seguidas por “n”.
9.3.	Existe uma lista de discussão para tradutores?
	Sim. Os diferentes grupos de tradução possuem as suas próprias listas de discussão. A lista dos projetos de tradução possui maiores informações sobre as listas de discussão e sobre os web sites mantidos por cada um dos projetos de tradução.
9.4.	São necessários mais tradutores?
	Sim. Quanto maior o número de pessoas trabalhando na tradução, mais rapidamente ela será finalizada, e mais rapidamente as mudanças na documentação em Inglês serão refletidas nos documentos traduzidos. Você não precisa ser um tradutor profissional para poder ajudar.
9.5.	Quais idiomas eu preciso conhecer?
	Idealmente, você deverá possuir bons conhecimentos de Inglês escrito, e obviamente necessitará ser fluente na língua para a qual estiver traduzindo. O conhecimento do idioma Inglês não é estritamente necessário. Por exemplo, você poderia fazer uma tradução do FAQ para o idioma Húngaro a partir da versão em Espanhol do documento.
9.6.	Quais softwares eu preciso conhecer?
	É fortemente recomendado que você mantenha uma cópia local do repositório Subversion do FreeBSD (ao menos da parte referente a documentação). Isto pode ser feito executando o comando: `%` `svn checkout svn://svn.FreeBSD.org/doc/head/ head` Note: Você irá precisar ter o devel/subversion instalado. Você deverá ter conhecimentos básicos de svn. Ele permitirá que você veja o que mudou entre as diferentes versões dos arquivos que compõem a documentação. Por exemplo, para ver as diferenças entre as revisões `r33733` e `r33734` do `en_US.ISO8859-1/books/fdp-primer/book.xml`, execute: `%` `svn diff -r33733:33734 en_US.ISO8859-1/books/fdp-primer/book.xml`
9.7.	Como eu faço para descobrir se já existem outras pessoas traduzindo documentos para o meu idioma?
	A página do Projeto de Tradução da Documentação lista os trabalhos de tradução que são conhecidos atualmente. Se outros já estão trabalhando na tradução da documentação para o seu idioma, por favor, não duplique os esforços. Ao invés disso, faça contato com o grupo para ver como pode ajudá-los. Se não existir nenhum projeto de tradução para o seu idioma listado nesta página, envie uma mensagem para lista de discussão do projeto de documentação do FreeBSD para o caso de alguém estar pensando em fazer a tradução, mas ainda não tiver anunciado nada.
9.8.	Ninguém mais está traduzindo para o meu idioma. O que eu faço?
	Parabés, você acabou de começar o “FreeBSD `sua-língua-aqui` Documentation Translation Project”. Bem vindo a bordo. Primeiro, pense se você terá o tempo necessário. Uma vez que você é a única pessoa trabalhando no seu idioma no momento, será sua a responsabilidade de publicar o seu trabalho e coordenar qualquer voluntário que queira ajudá-lo. Escreva um email para a lista de discussão do Projeto de Documentação, anunciando que você irá traduzir a documentação, assim a página do Projeto de Traduções de Documentação poderá ser atualizada. Se já existir alguém em seu país provendo o espelhamento de serviços do FreeBSD, você deve contacta-lo e perguntar se você pode ter algum espaço web para seu projeto, e se possível um endereço de email ou mesmo um serviço de lista de discussão. Então escolha um documento e comece a traduzir. É melhor começar com algo razoavelmente pequeno como `FAQ` ou um dos tutoriais.
9.9.	Eu já tenho alguns documentos traduzidos, para onde eu devo enviá-los?
	Isso depende. Se você já está trabalhando com uma equipe de tradução (tal como a equipe japonesa, ou a equipe alemã) então ela terá seus próprios procedimentos para manipular a documentação submetida, e estes serão descritos em seus web sites. Se você for a única pessoa trabalhando em um determinado idioma (ou se você é o responsável pelo projeto de tradução e quer submeter suas mudanças de volta para o projeto FreeBSD) então você deve enviar sua tradução ao Projeto FreBSD (veja pergunta seguinte).
9.10.	Eu sou a única pessoa trabalhando na tradução para este idioma, como faço para enviar meus documentos? ou Nós somos uma equipe de tradução, e queremos submeter os documentos que nossos membros traduziram para nós.
	Primeiramente certifique-se que sua tradução está organizada corretamente. Isto significa que ela deve se encaixar na árvore de diretórios corrente e ser processada de maneira correta. Atualmente a documentação do FreeBSD é armazenada em um diretório de nível superior chamado `head/`. Os diretórios abaixo deste são nomeados de acordo com o código do idioma em que eles estão escritos, definidos na ISO639 (`/usr/share/misc/iso639` em uma versão do FreeBSD mais nova que 20 de janeiro de 1999). Se seu idioma puder ser codificado de maneiras diferentes (por exemplo, Chinês) então deverão existir outros diretórios abaixo deste, um para cada formato que você tenha forncecido. Finalmente você deve ter diretórios para cada original. Por exemplo, em uma hipotética tradução para o Sueco ficaria assim: head/ sv_SE.ISO8859-1/ Makefile htdocs/ docproj books/ faq/ Makefile book.xml `sv_SE.ISO8859-1` é o nome da tradução, na forma `lang.encoding`. Repare nos dois Makefiles que serão usados para construir a documentação. Use tar(1) e gzip(1) para compactar sua documentação, e envie para o projeto. `%` `cd doc` `%` `tar cf swedish-docs.tar sv_SE.ISO8859-1` `%` `gzip -9 swedish-docs.tar` Coloque o arquivo `swedish-docs.tar.gz` em algum lugar. Se você não tiver acesso ao seu próprio espaço web (talvez seu ISP não disponibilize um), então você pode enviar um email para Equipe de Engenharia de Documentação `<doceng@FreeBSD.org>`, e combinar de enviar os arquivos por email quando for conveniente. De qualquer forma, você deve usar o send-pr(1) para enviar um relatório indicando que você submeteu a documentação. Seria muito útil se você conseguisse outras pessoas para revisar a sua tradução antes de submetê-la, uma vez que é improvável que a pessoa que irá disponibilizá-la no repositório seja fluente no seu idoma. Alguém (provavelmente o gerente do projeto de documentação, atualmente Equipe de Engenharia de Documentação `<doceng@FreeBSD.org>`) irá examinar os seus arquivos e irá confirmar se eles compilam sem erros. Em especial, os seguintes items serão verificados: Todos os seus arquivos usam strings RCS (tais como "ID")? O `make all` no diretório `sv_SE.ISO8859-1` funciona corretamente? O `make install` funciona corretamente? Se houver algum problema, a pessoa que estiver examinando a sua submissão irá entrar em contato para que você faça as correções. Se não exitir nenhum problema, os seus documentos traduzidos serão disponibilizados no repositório o quanto antes.
9.11.	Posso incluir uma língua ou um texto específico do país em minha tradução?
	Nós preferimos que você não faça isso. Por exemplo, suponha que você esteja traduzindo o Manual do FreeBSD para o Coreano e queira incluir uma seção sobre varejistas na Coréia em seu Manual do FreeBSD. Não há razão pela qual esta informação não deva estar nas versões em Inglês (ou Alemão, ou Espanhol, ou Japonâs, ou …). É possível que uma pessoa que fale Inglês na Coréia possa tentar obter uma cópia do FreeBSD enquanto esteja ali. Isso também ajuda a aumentar a presença perceptível do FreeBSD ao redor do mundo, o que não é uma coisa ruim. Se você tem uma informação específica do seu país, por favor, submeta ela para alteração no Manual do FreeBSD em Inglês (usando send-pr(1)) e depois traduza novamente para sua língua no Manual do FreeBSD traduzido. Obrigado.
9.12.	Como os caracteres específicos do idioma podem ser incluídos?
	Caracteres não-ASCII devem ser incluídos na documentação usando entidades SGML. Resumidamente, eles são um ``e'' comercial (&), o nome da entidade e um ponto-e-vírgula (;). Os nomes de entidades estão definidos no ISO8879, que está na árvore do ports como textproc/iso8879. Alguns exemplos Incluem Entidade: é Aparência: é Descrição: “e” minúsculo com acento agudo Entidade: É Aparência: É Descrição: “E” maiúsculo com acento agudo Entidade: ü Aparência: ü Descrição: “u” minúsculo com trema Depois que você instalar o pacote iso8879, os arquivos em `/usr/local/share/xml/iso8879` conterão a lista completa.
9.13.	Dirigindo-se ao leitor
	Nos documentos em Inglês, o leitor é tratado por “você”, não há distinção entre formal/informal como existe em alguns idiomas. Se você estiver traduzindo para um idioma que tenha esta distinção, use qualquer forma que normalmente é usada em outras documentações técnicas. Na dúvida, use a forma mais polida.
9.14.	Eu preciso colocar alguma informação adicional nas minhas traduções?
	Sim. O cabeçalho da versão em Inglês de cada documento será parecido com o texto exibido abaixo: <!-- The FreeBSD Documentation Project $FreeBSD: head/en_US.ISO8859-1/books/faq/book.xml 38674 2012-04-14 13:52:52Z $ --> A forma exata pode mudar, mas ela sempre incluirá a linha $FreeBSD$ e a frase `The FreeBSD Documentation Project`. Note que o $FreeBSD é inserido pelo svn, portanto ele deve estar vazio (apenas $FreeBSD$ ) para novos documentos. O seu documento traduzido deve incluir sua própria linha $FreeBSD$, e você deve mudar a linha `FreeBSD Documentation Project` para `The FreeBSD language Documentation Project`. Você deve ainda adicionar uma terceira linha que indicará qual revisão do texto em inglês o texto é baseado. Assim, a versão em Espanhol deste arquivo pode começar com: <!-- The FreeBSD Spanish Documentation Project $FreeBSD: head/es_ES.ISO8859-1/books/faq/book.xml 38826 2012-05-17 19:12:14Z hrs $ Original revision: r38674 -->

	Especifique o parâmetro `nochunks` para as folhas de estilo, forçando que todos os outputs sejam escritos para a saída padrão (STDOUT) (utilizando as folhas de estilo do Norm Walsh).
	Especifique os catálogos que o Jade terá que processar. Três catálogos são requeridos. O primeiro é o catálogo que contém as informações sobre as folhas de estilo DSSSL. O segundo contém informações sobre o DTD DockBook. E o terceiro contém informações específicas para o Jade.
	Especifique o caminho completo das folhas de estilo DSSSL as quais o Jade irá utilizar quando estiver processando o documento.
	Instrua o Jade para realizar uma transformação de uma DTD para outra. Neste caso, a entrada será transformada de um DTD DocBook para um DTD HTML.
	Especifique o arquivo que o Jade deve processar, e redirecione a saída para o arquivo `.html` desejado.

	Preâmbulo da constituição dos Estados Unidos. Nós, povo dos Estados Unidos, com o objetivo de fazer uma união mais perfeita, estabelecer justiça, garantir tranquilidade doméstica, promover uma defesa comum, promover bem estar geral, assegurar as benções da liberdade para nós mesmos e nossa posteridade, organizamos e estabelecemos essa constituição para os estados Unidos da América.
	--Copiado de um site qualquer

	Inclui o arquivo padrão de IO.
	Especifica que `main()` retorna um inteiro.
	A chamada `printf()` escreve `hello, world` na saída padrão

Este é o cabeçalho da coluna 1	Este é o cabeçalho da coluna 2
Linha 1, coluna 1	Linha 1, coluna 2
Linha 2, coluna 1	Linha 2, coluna 2

	Especifique os catálogos os quais o Jade terá que processar. Três catálogos são requeridos. O primeiro é o catálogo o qual contém as informações sobre as folhas de estilo DSSSL. O segundo contém informações sobre o DTD DocBook. O terceiro contém informações específicas para o Jade.
	Especifique o caminho completo da folha de estilo DSSSL a qual o Jade irá utilizar quando estiver processando o documento.
	Instrua o Jade para realizar a transformação de uma DTD para outra. Neste caso, a entrada será transformada de um DTD DocBook para um DTD HTML.
	Especifique o arquivo que o Jade deve processar. A folha de estilo determina como os arquivos HTML individuais serão nomeados, inclusive o nome do arquivo “raiz” (é o arquivo que contém o inicio do documento).

	Customize as folhas de estilo para utilizar as várias opções existentes, específicas para a produção de saídas TeX.
	Especifique os catálogos os quais o Jade terá que processar. Três catálogos são requeridos. O primeiro é o catálogo o qual contém as informações sobre as folhas de estilo DSSSL. O segundo contém informações sobre o DTD DocBook. O terceiro contém informações específicas para o Jade.
	Especifique o caminho completo da folha de estilo DSSSL a qual o Jade irá utilizar quando estiver processando o documento.
	Instrua o Jade para converter o output para TeX.

Primer do Projeto de Documentação do FreeBSD para novos colaboradores

Projeto de documentação do FreeBSD

Important:

Important:

Prefácio

1. Prompt do interpretador de comandos (shell)

2. Convenções Tipográficas

3. Notas, dicas, informações importantes, avisos e exemplos

Note:

Tip:

Important:

Warning:

4. Agradecimentos

Chapter 1. Visão Geral

1.1. Conjunto de Documentação do FreeBSD

1.2. Antes de você iniciar

1.3. Início Rápido

Chapter 2. Ferramentas

Se possível use o textproc/docproj:

2.1. Ferramentas Obrigatórias

2.1.1. Software

2.1.2. Entidades e DTDs

2.1.3. Stylesheets

2.2. Ferramentas Opcionais

2.2.1. Software

Important:

Chapter 3. SGML Primer

3.1. Visão Geral

Note:

3.2. Elementos, tags, e atributos

Important:

3.2.1. Para você fazer…

3.3. A declaração DOCTYPE

3.3.1. Identificadores públicos formais (FPIs)

Note:

3.3.1.1. Arquivos de catálogo

3.3.1.2. SGML_CATALOG_FILES

3.3.2. Alternativas aos FPIs

3.4. Voltando para o SGML

3.5. Comentários

3.5.1. Para você fazer…

3.6. Entidades

3.6.1. Entidades gerais

3.6.2. Entidades de parâmetro

3.6.3. Para você fazer…

3.7. Utilizando entidades para incluir arquivos

3.7.1. Utilizando entidades gerais para incluir arquivos

Warning:

3.7.2. Utilizando entidades de parâmetro para incluir arquivos

3.7.3. Para você fazer…

3.7.3.1. Utilizando entidades gerais para incluir arquivos

3.7.3.2. Utilizando uma entidade de parâmetro para incluir arquivos.

Note:

3.8. Sessões marcadas

3.8.1. Palavras-Chave de sessões marcadas

3.8.1.1. CDATA, RCDATA

Note:

3.8.1.2. INCLUDE and IGNORE

3.8.2. Para você fazer…

3.9. Conclusão

Chapter 4. Marcação SGML

Inline Versus Block:

4.1. HTML

4.1.1. Identificador Público Formal (IPF)

4.1.2. Elementos de Seção

4.1.3. Bloco de Elementos

4.1.3.1. Cabeçalho

4.1.3.2. Parágrafos

4.1.3.3. Bloco de Citação

4.1.3.4. Listas

4.1.3.5. Texto Pré-Formatado

4.1.3.6. Tabelas

Note:

4.1.4. Elementos In-line

4.1.4.1. Enfatizando a Informação

4.1.4.2. Negrito e Itálico

4.1.4.3. Indicando Texto de Fonte Fixa

4.1.4.4. Tamanho do Conteúdo

4.1.5. Links

Note:

3.3.1.1. Arquivos de `catálogo`

3.3.1.2. `SGML_CATALOG_FILES`

3.8.1.1. `CDATA`, `RCDATA`

3.8.1.2. `INCLUDE` and `IGNORE`

4.2.3.5. Subdividindo Utilizando o Elemento `Part`

4.2.5.10. Descrevendo `Makefile`s

4.2.6.3. Entradas no `Makefile`

Chapter 6. Estruturando Documentos Sob `doc/`

6.1. O Nível Superior, `doc/`

6.2. Os Diretórios de `idioma.codificação`

`books/handbook/`