5. Templates

5.1. Livro

A seguir temos um exemplo de marcação para um livro.

    <!doctype book public '-//Conectiva SA//DTD DocBook Conectiva variant
V2.0//EN' [

<!-- Exemplo de inclusão de um arquivo externo -->
<!entity indice system "index.sgml">
]>

<book id="apenas-um-livro" lang="pt-br">
  <bookinfo>
    <title>Este é apenas um livro, nada mais...</title>
    <subtitle>Talvez algo mais...</subtitle>
    <author>
      <firstname>Jorge</firstname>
      <surname>Godoy</surname>
      <affiliation>
        <orgname>&conectivasa;</orgname>
        <orgdiv>&deppubinternet;</orgdiv>
        <address role="email">godoy@conectiva.com.br</address>
      </affiliation>
    </author>
    <editor>
      <firstname>Jorge</firstname>
      <surname>Godoy</surname>
      <affiliation>
        <orgname>Sociedade dos Editores sem Editar</orgname>
      </affiliation>
    </editor>
    <copyright>
      <year>2000</year>
      <holder>&conectiva;</holder>
    </copyright>
    <legalnotice>
      <para>O conteúdo deste livro pode ser livremente utilizado e distribuído
      desde que seja citada a fonte de origem, ou seja, as referências
      bibliográficas deste.</para>
    </legalnotice>
    <edition>Edição para demonstração</edition>
    <publisher>
      <publishername>Conectiva S.A.</publishername>
      <address><city>Curitiba</city><country>Brasil</country></address>
    </publisher>
    <revhistory>
      <revision>
        <revnumber>1.0</revnumber>
        <date>Julho de 2000</date>
        <revremark>Primeira Edição</revremark>
      </revision>
    </revhistory>
    <isbn>888.888.888.888.88</isbn>
    <pubdate>Julho de 2000</pubdate>
  </bookinfo>

  <dedication>
    <para>Dedico este livro a minha mãe, que me aguentou e aturou por
    tantos anos.</para>
    <para>Dedico este livro à comunidade de software livre, que tem me
    aguentado e aturado por tantos anos.</para>
    <para>Dedico este livro a você, que está tendo a paciência de
    lê-lo.</para> 
  </dedication>


  <toc>
  </toc>

  <preface id="prefacio">
    <title>Prefácio</title>

    <para>Este é apenas um exemplo de livro. A idéia é usá-lo como um
    esqueleto para novos livros escritos na &conectiva;. Se quiser
    saber como ele se parecerá, dê uma olhada na <ulink
    url="http://publicacoes.conectiva/utilidades/publicacoes/templates/livro/livro.html">versão
    html</ulink> ou baixe a <ulink
    url="http://publicacoes.conectiva/utilidades/publicacoes/templates/livro/livro.ps">versão
    em <application moreinfo="none">PostScript</application></ulink>
    deste.</para>

    <para>Boa sorte e <quote>Que a força esteja com você, jovem
    Skywalker</quote>.</para> 
  </preface>

  <part id="parte-1">
    <title>Enrolando um pouco</title>

    <partintro>
      <para>É permitido escrever uma pequena introdução para cada
      parte de um livro, porém não me é obrigatório. Eu poderia ter
      iniciado direto com um capítulo.</para>
    </partintro>

    <chapter id="capitulo-1">
      <title>Capítulo 1</title>
      <indexterm significance="normal">
        <primary>Exemplo de índice</primary>
      </indexterm>

      <epigraph>
        <attribution><author>
            <firstname>João</firstname>
            <surname>Ninguém</surname>
          </author>
        </attribution>
        <para>Esta é uma epígrafe para este capítulo.</para>
      </epigraph>


      <para>Os nomes dos capítulos serão numerados, para que você
      tenha uma noção de como eles são colocados no sumário e no
      índice.</para> 

      <section id="secao-1.1">
        <title>Seção 1.1</title>
        <indexterm significance="normal">
          <primary>Exemplo de índice</primary>
          <secondary>com termo secundário</secondary>
        </indexterm>

        <para>Um capítulo pode conter diversas seções. Eis aqui uma
        seção dentro de um capítulo.</para>
      </section>

      <section id="secao-1.2">
        <title>Seção 1.2</title>

        <para>Eis aqui outra seção dentro de um capítulo.</para>
      </section>
    </chapter>

    <chapter id="capitulo-2">
      <title>Capítulo 2</title>
      <indexterm significance="normal">
        <primary>Exemplo de índice</primary>
      </indexterm>
      <indexterm significance="normal">
        <primary>Indexando de outra maneira</primary>
      </indexterm>

      <para>Como uma parte pode conter vários capítulos, eis aqui um
      outro exemplo.</para>

      <section id="secao-2.1">
        <title>Seção 2.1</title>

        <para>Um capítulo pode conter diversas seções. Eis aqui uma
        seção dentro de um capítulo.</para>
      </section>

      <section id="secao-2.2">
        <title>Seção 2.2</title>

        <para>Eis aqui outra seção dentro de um capítulo.</para>
      </section>
    </chapter>
  </part>

  <part id="parte-2">
    <title>Enrolando mais um pouco</title>
    <indexterm significance="normal" class="startofrange" id="inicio">
      <primary>Enrolação na parte 2</primary>
    </indexterm>

    <chapter id="parte-2-capitulo-1">
      <title>Capítulo 1</title>

      <para>Esta parte não teve o texto introdutório, mas poderia sem
      nenhum problema.</para>

      <para>Um livro pode ter várias partes, essa é a segunda delas,
      com a mesma estrutura que a parte anterior.</para>

      <para>Repare, entretanto, que os IDs desta seção são diferentes
      dos anteriores. Não podemos <emphasis>nunca</emphasis> repetir
      IDs.</para>

      <section id="parte-2-secao-1.1">
        <title>Seção 1.1</title>

        <para>Um capítulo pode conter diversas seções. Eis aqui uma
        seção dentro de um capítulo.</para>
      </section>

      <section id="parte-2-secao-1.2">
        <title>Seção 1.2</title>

        <para>Eis aqui outra seção dentro de um capítulo.</para>
      </section>
    </chapter>

    <chapter id="parte-2-capitulo-2">
      <title>Capítulo 2</title>

      <para>Como uma parte pode conter vários capítulos, eis aqui um
      outro exemplo.</para>

      <section id="parte-2-secao-2.1">
        <title>Seção 2.1</title>

        <para>Um capítulo pode conter diversas seções. Eis aqui uma
        seção dentro de um capítulo.</para>
      </section>

      <section id="parte-2-secao-2.2">
        <title>Seção 2.2</title>

        <para>Eis aqui outra seção dentro de um capítulo.</para>
      </section>
    </chapter>
  </part>

  <part id="apendices">
    <title>Apêndices</title>

    <partintro>
      <para>Como dividimos nosso livro em partes, é elegante termos
      uma parte específica para os apêndices. Mesmo que tivéssemos
      apenas um apêndice, o texto ficaria melhor dividido desta
      forma.</para> 
    </partintro>

    <appendix id="apendice-a">
      <title>Apêndice A</title>

      <section id="ap-a-secao-1">
        <title>Seção 1</title>

        <para>Esta é uma seção como qualquer outra.</para>
      </section>
      <section id="ap-a-secao-2">
        <title>Seção 2</title>

        <para>Esta é uma seção como qualquer outra.</para>
      </section>
    </appendix>
    <appendix id="apendice-b">
      <title>Apêndice B</title>

      <section id="ap-b-secao-1">
        <title>Seção 1</title>

        <para>Esta é uma seção como qualquer outra.</para>
      </section>
      <section id="ap-b-secao-2">
        <title>Seção 2</title>

        <para>Esta é uma seção como qualquer outra.</para>
      </section>
    </appendix>
    <indexterm significance="normal" class="endofrange"
    startref="inicio">
  </part>

  <glossary id="glossario">
    <glossentry>
      <glossterm>SGML</glossterm>
      <glossdef>
        <para>Aqui está a definição de SGML.</para>
      </glossdef>
    </glossentry>
    <glossentry>
      <glossterm>XML</glossterm>
      <glossdef>
        <para>Aqui está a definição de XML.</para>
      </glossdef>
    </glossentry>
    <glossentry>
      <glossterm>HTML</glossterm>
      <glossdef>
        <para>Aqui está a definição de HTML.</para>
      </glossdef>
    </glossentry>
  </glossary>

  <bibliography>
    <biblioentry>
      <author>
        <firstname>Jorge</firstname>
        <surname>Godoy</surname>
      </author>
      <copyright>
        <year>2000</year>
        <holder>Jorge Godoy</holder>
      </copyright>
      <isbn>888.888.888.888.88</isbn>
      <publisher>
        <publishername>&conectiva;</publishername>
      </publisher>
      <title>Este é só um artigo</title>
      <subtitle>E é um bom exemplo!</subtitle>
      <pagenums>3-5</pagenums>
    </biblioentry>
  </bibliography>

<!-- Aqui incluímos o arquivo que declaramos no início do documento -->
&indice;
  
</book>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-default-dtd-file:"/home/ldp/SGML/emacs/book-cnc-2.0.ced"
End:
-->

5.2. Artigo

A seguir temos um exemplo de marcação para um artigo.

    <!doctype article public '-//Conectiva SA//DTD DocBook Conectiva variant V2.0//EN'>

<article id="exemplo-artigo" lang="pt-br">

  <articleinfo>
    <title>Este é só um artigo</title>
    <subtitle>E é um bom exemplo!</subtitle>
    <author>
      <firstname>Jorge</firstname>
      <othername>Luiz</othername>
      <surname>Godoy</surname>
      <othername>Filho</othername>
      <affiliation>
        <orgname>&conectivasa;</orgname>
        <orgdiv>&deppubinternet;</orgdiv>
        <address><email>godoy@conectiva.com</email></address>
      </affiliation>
    </author>
    <revhistory>
      <revision>
        <revnumber>1.0</revnumber>
        <date>Julho de 2000</date>
        <authorinitials>godoy</authorinitials>
        <revremark>Versão inicial.</revremark>
      </revision>
    </revhistory>

    <legalnotice>
      <para>Este documento pode ser livremente distribuído e traduzido. Ele está
      liberado sob a GPL.</para>
    </legalnotice>

    <keywordset>
      <keyword>SGML</keyword>
      <keyword>DocBook</keyword>
      <keyword>DTD</keyword>
      <keyword>XML</keyword>
      <keyword>catálogos</keyword>
      <keyword>documentos</keyword>
      <keyword>Publicações</keyword>
      <keyword>Conectiva</keyword>
      <keyword>configuração</keyword>
      <keyword>uso</keyword>
      <keyword>ferramentas</keyword>
      <keyword>HOWTO</keyword>
    </keywordset>

  </articleinfo>

  <abstract>
    <para>Todo artigo começa com um resuminho bobo...</para>
    <para>Pois é, esse também.</para>
    <para>Esse documento possui uma versão em <ulink
    url="http://publicacoes.conectiva/utilidades/templates/artigo/artigo.ps">PostScript</ulink>
    e uma versão em <ulink
    url="http://publicacoes.conectiva/utilidades/templates/atigo/artigo.html">HTML</ulink>.</para>
  </abstract>

  <section id="ex-secao">
    <title>Exemplo de seção</title>

    <para>Artigos são documentos curtos e voltados a um único
    assunto.</para> 

    <para>Esta é uma seção em um artigo.</para>
  </section>

  <section id="outra-secao">
    <title>Outra seção</title>

    <para>Como um artigo é composto de diversas seções, nada mais
    justo do que colocar outra seção aqui.</para>
  </section>


  <appendix id="apendice-a">
    <title>Apêndice A</title>

    <para>Este é um apêndice em um artigo.</para>
    <para>Apêndices são interessantes para comentar alguma informação
    que se faz necessária mas que foge um pouco do escopo do
    documento.</para> 
  </appendix>


  <glossary id="glossario">
    <glossentry>
      <glossterm>SGML</glossterm>
      <glossdef>
        <para>Aqui está a definição de SGML.</para>
      </glossdef>
    </glossentry>
    <glossentry>
      <glossterm>XML</glossterm>
      <glossdef>
        <para>Aqui está a definição de XML.</para>
      </glossdef>
    </glossentry>
    <glossentry>
      <glossterm>HTML</glossterm>
      <glossdef>
        <para>Aqui está a definição de HTML.</para>
      </glossdef>
    </glossentry>
  </glossary>


  <bibliography>
    <biblioentry>
      <author>
        <firstname>Jorge</firstname>
        <surname>Godoy</surname>
      </author>
      <copyright>
        <year>2000</year>
        <holder>Jorge Godoy</holder>
      </copyright>
      <isbn>888.888.888.888.88</isbn>
      <publisher>
        <publishername>&conectiva;</publishername>
      </publisher>
      <title>Este é apenas um livro, nada mais...</title>
      <subtitle>Talvez algo mais...</subtitle>
      <pagenums>10-15</pagenums>
    </biblioentry>
  </bibliography>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-default-dtd-file:"/home/ldp/SGML/emacs/article-cnc-2.0.ced"
End:
-->

5.3. Tabela

A seguir temos um exemplo de marcação para um tabela.

    <table frame="all">
  <title>Tabela de exemplo</title>
  <tgroup cols="5">
    <colspec colname="coluna1">
    <colspec colname="coluna2">
    <colspec colname="coluna3">
    <colspec colnum="5" colname="coluna5">
    <spanspec namest="coluna1" nameend="coluna2" spanname="span-horiz" align="center">
    <spanspec namest="coluna2" nameend="coluna3" spanname="span-horiz-vert" align="center">
    <thead>
      <row>
        <entry spanname="span-horiz">
           <foreignphrase>Span</foreignphrase> horizontal
        </entry>
        <entry>Cabeçalho 2</entry>
        <entry>Cabeçalho 3</entry>
        <entry>Cabeçalho 4</entry>
      </row>
    </thead>
    <tfoot>
      <row>
        <entry>Rodapé 1</entry>
        <entry>Rodapé 2</entry>
        <entry>Rodapé 3</entry>
        <entry>Rodapé 4</entry>
        <entry>Rodapé 5</entry>
      </row>
    </tfoot>
    <tbody>
      <row>
        <entry>Dado11</entry>
        <entry>Dado12</entry>
        <entry>Dado13</entry>
        <entry>Dado14</entry>
        <entry>Dado15</entry>
      </row>
      <row>
        <entry>Dado21</entry>
        <entry>Dado22</entry>
        <entry>Dado23</entry>
        <entry>Dado24</entry>
        <entry morerows="1" valign="middle">
           <foreignphrase>Span</foreignphrase> vertical
        </entry>
      </row>
      <row>
        <entry>Dado31</entry>
        <entry spanname="span-horiz-vert" morerows="1" valign="bottom">
           <foreignphrase>Span</foreignphrase> duplo
        </entry>
        <entry>Dado34</entry>
      </row>
      <row>
        <entry>Dado41</entry>
        <entry>Dado44</entry>
        <entry>Dado45</entry>
      </row>
    </tbody>
  </tgroup>
</table>

5.4. Imagem

A seguir temos um exemplo de marcação para a inserção de imagens.

    <figure id="img-identificacao">
   <title>Título</title>
   <mediaobject>
      <imageobject>
         <imagedata fileref="imagens/arquivo.eps" format="eps">
      </imageobject>
      <imageobject>
         <imagedata fileref="imagens/arquivo.jpg" format="jpg">
      </imageobject>
      <textobject>
         <phrase>Aqui há uma imagem de exemplo</phrase>
      </textobject>
      <caption><para>Descrição da imagem. Opcional.</para></caption>
   </mediaobject>
</figure>