diff options
Diffstat (limited to 'pt_BR.ISO8859-1/books/fdp-primer/structure/chapter.xml')
-rw-r--r-- | pt_BR.ISO8859-1/books/fdp-primer/structure/chapter.xml | 46 |
1 files changed, 22 insertions, 24 deletions
diff --git a/pt_BR.ISO8859-1/books/fdp-primer/structure/chapter.xml b/pt_BR.ISO8859-1/books/fdp-primer/structure/chapter.xml index 3fa3afbfc5..ddd56c189a 100644 --- a/pt_BR.ISO8859-1/books/fdp-primer/structure/chapter.xml +++ b/pt_BR.ISO8859-1/books/fdp-primer/structure/chapter.xml @@ -36,8 +36,7 @@ Original revision: r38868 --> - -<chapter id="structure"> +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="structure"> <title>Estruturando Documentos Sob <filename>doc/</filename></title> @@ -75,7 +74,7 @@ documentação não force nenhum padrão particular ou preferência cultural.</para> - <sect1 id="structure-top"> + <sect1 xml:id="structure-top"> <title>O Nível Superior, <filename>doc/</filename></title> <para>Existem dois tipos de diretórios sob @@ -108,7 +107,7 @@ <seglistitem> - <seg><filename><replaceable>idioma</replaceable>.<replaceable>codificação</replaceable>/</filename></seg> + <seg><filename>idioma.codificação/</filename></seg> <seg>Existe um diretório para cada tradução e codificação da @@ -127,9 +126,9 @@ </segmentedlist> </sect1> - <sect1 id="structure-locale"> + <sect1 xml:id="structure-locale"> - <title>Os Diretórios de <filename><replaceable>idioma</replaceable>.<replaceable>codificação</replaceable></filename></title> + <title>Os Diretórios de <filename>idioma.codificação</filename></title> <para>Estes diretórios contêm os documentos propriamente ditos. A documentação é @@ -147,7 +146,7 @@ <seg><filename>articles</filename></seg> <seg>Documentação codificada como DocBook - <sgmltag>article</sgmltag> (ou equivalente). + <tag>article</tag> (ou equivalente). Razoavelmente pequena, e separada em seções. Normalmente disponível apenas como um arquivo HTML.</seg> @@ -157,7 +156,7 @@ <seg><filename>books</filename></seg> <seg>Documentação codificada como DocBook - <sgmltag>book</sgmltag> (ou equivalente). + <tag>book</tag> (ou equivalente). Com o tamanho de um livro, e separada em capítulos. Normalmente disponível tanto como um grande arquivo HTML (para pessoas com conexões @@ -173,20 +172,20 @@ <seg>Para traduções das páginas de manual do sistema. Este diretório conterá um ou mais diretórios - <filename>man<replaceable>n</replaceable></filename>, + <filename>mann</filename>, correspondendo as seções que foram traduzidas.</seg> </seglistitem> </segmentedlist> <para>Nem todo diretório - <filename><replaceable>idioma</replaceable>.<replaceable>codificação</replaceable></filename> + <filename>idioma.codificação</filename> conterá todos estes diretórios. Isto depende de quantos documentos já foram traduzidos pelo time de tradução.</para> </sect1> - <sect1 id="structure-document"> + <sect1 xml:id="structure-document"> <title>Informação Específica do Documento</title> @@ -204,13 +203,13 @@ projeto FreeBSD.</para> <para>O Handbook é organizado como um - <sgmltag>book</sgmltag> Docbook. Ele está dividido - em <sgmltag>part</sgmltag>es, e cada uma delas pode conter - diversos <sgmltag>chapter</sgmltag>s (Capítulos). Os - <sgmltag>chapter</sgmltag>s estão subdivididos - em seções (<sgmltag>sect1</sgmltag>) e - subseções (<sgmltag>sect2</sgmltag>, - <sgmltag>sect3</sgmltag>) e assim por diante.</para> + <tag>book</tag> Docbook. Ele está dividido + em <tag>part</tag>es, e cada uma delas pode conter + diversos <tag>chapter</tag>s (Capítulos). Os + <tag>chapter</tag>s estão subdivididos + em seções (<tag>sect1</tag>) e + subseções (<tag>sect2</tag>, + <tag>sect3</tag>) e assim por diante.</para> <sect3> <title>Organização Fisíca</title> @@ -251,8 +250,7 @@ assim como os elementos que descrevem a estrutura do Handbook.</para> - <para>O <filename>book.xml</filename> utiliza <link - linkend="sgml-primer-parameter-entities">entidades de + <para>O <filename>book.xml</filename> utiliza <link linkend="sgml-primer-parameter-entities">entidades de parâmetro</link> para carregar os arquivos com extensão <filename>.ent</filename>. Estes arquivos (descritos abaixo) definem as @@ -262,14 +260,14 @@ </sect4> <sect4> - <title><filename><replaceable>directory</replaceable>/chapter.xml</filename></title> + <title><filename>directory/chapter.xml</filename></title> <para>Cada capítulo do Handbook é armazenado em um arquivo chamado <filename>chapter.xml</filename> localizado em um diretório separado dos outros capítulos. Cada diretório é nomeado depois do valor do atributo <literal>id</literal> no - elemento <sgmltag>chapter</sgmltag>.</para> + elemento <tag>chapter</tag>.</para> <para>Por exemplo, se um dos arquivos de capítulos contiver:</para> @@ -296,12 +294,12 @@ arquivos eram armazenados no mesmo diretório que o <filename>book.xml</filename>, e depois nomeados a partir do valor do atributo <literal>id</literal> - presente no elemento <sgmltag>chapter</sgmltag> do + presente no elemento <tag>chapter</tag> do arquivo. Agora, é possível incluir imagens em cada capítulo. As imagens de cada capítulo do Handbook são armazenadas dentro de - <filename class="directory">share/images/books/handbook</filename>. + <filename>share/images/books/handbook</filename>. Observe que as versões localizadas destas imagens devem ser colocadas no mesmo diretório com o código fonte SGML de cada capítulo. |