[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] ddp://manuals.sgml/debiandoc-sgml-doc-pt-br/structure.sgml

Olá colegas,

Segue em anexo a tradução para revisão, juntamente com o original em inglês.

Este é o último arquivo.

Para quem não sabe de que se trata o Debiandoc-SGML, é um manual de explica de
forma simplificada quais as principais tags utilizadas em documentos Debian,
feitos  com a utilização de marcação SGML. Além da versão em Inglês, o
português brasileiro foi o único idioma para o qual foi traduzido, inicialmente
pelo Gleydson, e agora estou terminando a atualização para a última versão
(1.1.20).  Espero que sirva de ajuda para quem estiver começando a mexer com
essa linguagem de marcação.
  
Antecipadamente grato,

-- 
Marcelo G. Santana(darkstar)      GNU/Linux User number #208778
JID:marcelo.santana@jabber.org   GNU Privacy Guard ID: 5BECD54C
Blog:Tempestade de Idéias - http://marcelosantana.wordpress.com
      Projeto Debian Brasil - http://www.debianbrasil.org      

<chapt id="structure">

  <heading>Overall structure</heading>

  <p>
    The first line of the document should be
<example>
&lt!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN"&gt
</example>
    or
<example>
&lt!doctype debiandoc system&gt
</example>
    to indicate that the document is a Debiandoc-SGML file.
  </p>

  <p>
    The document should start with the <tt>&lt;book&gt;</tt> tag and
    end with <tt>&lt;/book&gt;</tt>.  This may optionally be enclosed
    between <tt>&lt;debiandoc&gt;</tt> tag and  
    <tt>&lt;/debiandoc&gt;</tt>.
  </p>

  <p>
    This should be followed by the <tt>&lt;title&gt;</tt>, one or more
    <tt>&lt;author&gt;</tt>s or <tt>&lt;translator&gt;</tt>s 
    (each consisting of a
    <tt>&lt;name&gt;</tt> and an optional<tt>&lt;email&gt;</tt>), and
    optionally a <tt>&lt;version&gt;</tt>.  Each of these is a piece
    of marked-up inline text - see <ref id="inline">.  The
    <tt>&lt;version&gt;</tt> may also contain a <tt>&lt;date&gt;</tt>
    which stands for the date at the time the document is formatted.
  </p>

  <p>
    Then may come an <tt>&lt;abstract&gt;</tt>, a
    <tt>&lt;copyright&gt;</tt> notice, and a <tt>&lt;toc&gt;</tt>
    marker.
  </p>

  <p>
    The <tt>&lt;abstract&gt;</tt> contains a single paragraph.
  </p>

  <p>
    The <tt>&lt;copyright&gt;</tt> notice contains one or more
    copyright summaries marked with 
    <tt>&lt;copyrightsummary&gt;</tt> and 
    <tt>&lt;/copyrightsummary&gt;</tt>
    followed by one or more paragraphs, the first
    of which must be indicated by a <tt>&lt;p&gt;</tt> tag to
    distinguish it from the summaries.
  </p>

  <p>
    The <tt>&lt;toc&gt;</tt> marker specifies that a table of contents
    is to be produced.  The <tt>&lt;toc&gt;</tt> doesn't contain
    anything in the SGML source - its contents are generated by the
    processing systems.  The <tt>&lt;toc&gt;</tt> can have an
    attribute saying how detailed it should be; for example,
    <tt>&lt;toc sect1&gt;</tt> says that subsections should be
    included, whereas <tt>&lt;toc chapt&gt;</tt> says that only
    chapters and appendices should be included.  The values allowed
    are <tt>chapt</tt>, <tt>sect</tt>, <tt>sect1</tt> and
    <tt>sect2</tt>.
  </p>

  <p>
    Following these parts comes the body of the document - one or more
    chapters <tt>&lt;chapt&gt;</tt>, optionally followed by one or
    more appendices <tt>&lt;appendix&gt;</tt>.
  </p>

  <p>
    It is not necessary to mark the end of the <tt>&lt;title&gt;</tt>,
    <tt>&lt;author&gt;</tt>, <tt>&lt;version&gt;</tt>,
    <tt>&lt;abstract&gt;</tt> and <tt>&lt;copyright&gt;</tt> elements
    - they are implicitly ended by the start of the next element.
  </p>
  
  <p>
  Here is an example of simple Debiandoc SGML file.
  <example>
&lt;!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN" [

&lt;-- Next line is an example to include external definition --&gt;
&lt;!ENTITY % default  SYSTEM "default.ent"&gt;  %default;
&lt;-- Next line is an example of common definition --&gt;
&lt;!ENTITY common-definition "Foo Bar" &gt;

]&gt;

&lt;debiandoc&gt;

&lt;book&gt;

&lt;title&gt;Book Title Here&lt;/title&gt;
&lt;author&gt;
 &lt;name&gt;Osamu Aoki&lt;/name&gt;
 &lt;email&gt;debian@aokiconsulting.com&lt;/email&gt;
&lt;/author&gt;

&lt;version&gt;Version 1.00&lt;/version&gt;

&lt;abstract&gt;
This provides a simple skeleton example of a debiandoc-sgml document.
You cannot place "p" or "ref" tags in here.
&lt;/abstract&gt;

&lt;copyright&gt;
  &lt;copyrightsummary&gt;
    Copyright &copy; 2006 by Osamu Aoki &lt;email&gt;debian@aokiconsulting.com&lt;/&gt;
  &lt;/copyrightsummary&gt;
  &lt;p&gt;
  &lt;url id="http://www.gnu.org/copyleft/gpl.html";
        name="This document may used under the terms of the GNU General Public License version 2 or higher."&gt;
&lt;/copyright&gt;

&lt;toc sect1&gt;  &lt;!-- list section to sect1 in table of content--&gt;

&lt;chapt id="chapter-one"&gt;&lt;heading&gt;Chapter title&lt;/heading&gt;

&lt;!-- This is comment.  Heading tags above can be skipped --&gt;

&lt;p&gt;
... 
&lt;sect id="ch-1-sect-1"&gt;Section title here
&lt;p&gt;
...contents. "&amp;common-definition;" becomes "Foo Bar".

&lt;sect1 id="ch-1-sect1-1"&gt;Sect-1-level title
&lt;p&gt;
...contents

&lt;sect2 id="ch-1-sect2-1"&gt;Sect-2-level title
&lt;p&gt;
...contents

&lt;/sect2&gt;
&lt;/sect1&gt;
&lt;/sect&gt;

&lt;/book&gt;

&lt;/debiandoc&gt;


  </example>

</chapt>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("../debiandoc-sgml.en.sgml" "book" "chapt")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

<chapt id="structure">
  <heading>Estrutura Global</heading>

  <p>
    A primeira linha do documento deve ser
<example>
&lt!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN"&gt
</example>
    ou
<example>
&lt!doctype debiandoc system&gt
</example>
    para indicar que o documento é um arquivo Debiandoc-SGML.
  </p>

  <p>
    O documento deve iniciar com a tag <tt>&lt;book&gt;</tt> e
    terminar com <tt>&lt;/book&gt;</tt>. Este pode ser opcionalmente
    colocado entre tags <tt>&lt;debiandoc&gt;</tt> e  
    <tt>&lt;/debiandoc&gt;</tt>.
  </p>

  <p>
    Este pode ser seguido por <tt>&lt;title&gt;</tt>, uma ou mais
    <tt>&lt;author&gt;</tt>s ou <tt>&lt;translator&gt;</tt>s
    (Cada uma constituída de um
    <tt>&lt;name&gt;</tt> e um <tt>&lt;email&gt;</tt> opcional), e
    opcionalmente uma <tt>&lt;version&gt;</tt>. Cada uma destas é uma
    parte do texto incorporado com marcação - veja <ref id="inline">.
    A <tt>&lt;version&gt;</tt> pode também conter <tt>&lt;date&gt;</tt>
    que representa a data no momento em que o documento foi formatado.
  </p>

  <p>
    Depois pode vir um <tt>&lt;abstract&gt;</tt>, um aviso de
    <tt>&lt;copyright&gt;</tt>, e um marcador <tt>&lt;toc&gt;</tt>.
  </p>

  <p>
    O <tt>&lt;abstract&gt;</tt> contém um parágrafo simples.
  </p>

  <p>
    O aviso de <tt>&lt;copyright&gt;</tt> contém um ou mais resumos
    de copyright marcados com <tt>&lt;copyrightsummary&gt;</tt> e
    <tt>&lt;/copyrightsummary&gt;</tt> acompanhado por um ou mais
    parágrafos, o primeiro dos quais deve ser indicado por uma tag
    <tt>&lt;p&gt;</tt> para distingui-lo do sumário.
  </p>

  <p>
    O marcador <tt>&lt;toc&gt;</tt> especifica que uma tabela de
    conteúdo será produzida.  A tag <tt>&lt;toc&gt;</tt> não contém
    nada no fonte SGML - seu conteúdo é gerado pelo sistema de
    processamento.  A tag <tt>&lt;toc&gt;</tt> pode conter um
    atributo dizendo como ele deve ser detalhado; por exemplo,
    <tt>&lt;toc sect1&gt;</tt> diz que as subseções devem ser incluídas,
    considerando que <tt>&lt;toc chapt&gt;</tt> diz que somente
    capítulos e apêndices devem ser incluídos.  Os valores permitidos
    são <tt>chapt</tt>, <tt>sect</tt>, <tt>sect1</tt> e
    <tt>sect2</tt>.
  </p>

  <p>
    Após essas partes vem o corpo do documento - um ou mais
    capítulos <tt>&lt;chapt&gt;</tt>, opcionalmente seguido de um ou
    mais apêndices <tt>&lt;appendix&gt;</tt>.
  </p>

  <p>
    Não é necessário marcar o final dos elementos
    <tt>&lt;title&gt;</tt>, <tt>&lt;author&gt;</tt>,
    <tt>&lt;version&gt;</tt>, <tt>&lt;abstract&gt;</tt> e
    <tt>&lt;copyright&gt;</tt> - eles são implicitamente terminados 
    pelo início do próximo elemento.
  </p>

  <p>
  Aqui está um exemplo de um arquivo Debiandoc SGML simples.
  <example>
&lt;!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN" [

&lt;-- Next line is an example to include external definition --&gt;
&lt;!ENTITY % default  SYSTEM "default.ent"&gt;  %default;
&lt;-- Next line is an example of common definition --&gt;
&lt;!ENTITY common-definition "Foo Bar" &gt;

]&gt;

&lt;debiandoc&gt;

&lt;book&gt;

&lt;title&gt;Book Title Here&lt;/title&gt;
&lt;author&gt;
 &lt;name&gt;Osamu Aoki&lt;/name&gt;
 &lt;email&gt;debian@aokiconsulting.com&lt;/email&gt;
&lt;/author&gt;

&lt;version&gt;Version 1.00&lt;/version&gt;

&lt;abstract&gt;
This provides a simple skeleton example of a debiandoc-sgml document.
You cannot place "p" or "ref" tags in here.
&lt;/abstract&gt;

&lt;copyright&gt;
  &lt;copyrightsummary&gt;
    Copyright &copy; 2006 by Osamu Aoki &lt;email&gt;debian@aokiconsulting.com&lt;/&gt;
  &lt;/copyrightsummary&gt;
  &lt;p&gt;
  &lt;url id="http://www.gnu.org/copyleft/gpl.html";
        name="This document may used under the terms of the GNU General Public License version 2 or higher."&gt;
&lt;/copyright&gt;

&lt;toc sect1&gt;  &lt;!-- list section to sect1 in table of content--&gt;

&lt;chapt id="chapter-one"&gt;&lt;heading&gt;Chapter title&lt;/heading&gt;

&lt;!-- This is comment.  Heading tags above can be skipped --&gt;

&lt;p&gt;
... 
&lt;sect id="ch-1-sect-1"&gt;Section title here
&lt;p&gt;
...contents. "&amp;common-definition;" becomes "Foo Bar".

&lt;sect1 id="ch-1-sect1-1"&gt;Sect-1-level title
&lt;p&gt;
...contents

&lt;sect2 id="ch-1-sect2-1"&gt;Sect-2-level title
&lt;p&gt;
...contents

&lt;/sect2&gt;
&lt;/sect1&gt;
&lt;/sect&gt;

&lt;/book&gt;

&lt;/debiandoc&gt;


  </example>

</chapt>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("../debiandoc-sgml.pt_BR.sgml" "book" "chapt")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Reply to: