[ anterior ] [ Nota de Copyright ] [ Conteúdo ] [ próximo ]

Manual Debiandoc-SGML - Capítulo 2
Estrutura Global


A primeira linha do documento deve ser

     <!doctype debiandoc public "-//DebianDoc//DTD DebianDoc//EN">

ou

     <!doctype debiandoc system>

para indicar que o documento é um arquivo Debiandoc-SGML.

O documento deve iniciar com a tag <book> tag e finalizar com </book>.

Isto pode se seguido de <title>, um ou mais tags <author>-<email>, e opcionalmente <version>. Cada uma destas é uma peça da marcação de texto inline - veja Texto marcado inline e marcação do estilo de caracteres, Capítulo 4. A <version> pode também conter <date> que mostra a data e hora em que o documento foi gerado.

Então pode vir uma <abstract>, um aviso de <copyright>, e um marcador <toc>.

<abstract> contém um parágrafo simples que contém um resumo do documento.

A tag <copyright> contém um aviso de copyright (isto é usado, por exemplo, no rodapé de cada página HTML) seguida de um ou mais parágrafos, o primeiro deve ser indicado pela tag <p> para distinguir ela do sumário.

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

Seguinte a estas partes vem o corpo do documento - um ou mais capítulos <chapt>, opcionalmente seguido de um ou mais apêndices <appendix>.

Não é necessário marcar o final dos elementos <title>, <author>, <version>, <abstract> e <copyright> - eles são automáticamente fechados no inicio do próximo elemento.


[ anterior ] [ Nota de Copyright ] [ Conteúdo ] [ próximo ]
Manual Debiandoc-SGML
22 November 1999
Ian Jackson ijackson@gnu.ai.mit.edu
Ardo van Rangelrooij ardo@debian.org