[RFR] ddp://manuals.sgml/debiandoc-sgml-doc-pt-br/listexamp.sgml
Olá colegas,
Segue em anexo a tradução para revisão, juntamente com o original em inglês.
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="listexamp">
<heading>Listas e exemplos</heading>
<sect id="lists">
<heading>Listas</heading>
<p>
Há três tipos de listas:
<list compact="compact">
<item>
<p>
<tt><list></tt> - lista comum (com marcadores)
</p>
</item>
<item>
<p>
<tt><enumlist></tt> - lista numerada
</p>
</item>
<item>
<p>
<tt><taglist></tt> - lista com tags
</p>
</item>
</list>
</p>
<p>
Cada entrada em uma lista comum ou numerada é um item
introduzido por <tt><item></tt>. Cada entrada em uma
lista com tags é uma ou mais <tt><tag></tt>s seguida de um
<tt><item></tt>.
</p>
<p>
Não é necessário marcar o final de elementos <tt><tag></tt> ou
<tt><item></tt>.
</p>
<p>
Todos os três tipos de lista vem em dois tipos, dependendo se
você especificar o atributo <tt>compact</tt> (ex.,
<tt><taglist compact></tt>) ou não (ex.,
<tt><enumlist></tt>). A <tt><tag></tt> pode conter
apenas texto marcado incorporado.
</p>
<p>
As versões compactas são destinados ao uso dentro de parágrafos.
O formatador não irá pôr lacunas em torno da lista ou entre as
entradas.<footnote><p>Existe um problema com isso em HTML. O
formatador HTML tenta não pôr, pelo uso do atributo <tt>compact</tt>
de lista HTML nas lista que ele gera, mas não são muitos os navegadores
que entendem corretamente.</p></footnote> As entradas em uma lista
compacta devem cada uma cada ser um parágrafo simples (não é necessário
marcar o início do parágrafo). Quaisquer listas dentro de uma lista
compacta devem si marcar como compactas (embora os formatadores de
fato concluirão por si que elas deveriam ser compactas).
</p>
<p>
As versões não compactas são destinados a permanecerem-se com parágrafos
Cada entrada na tal lista pode conter mais de um parágrafo (mais uma vez,
o início do primeiro parágrafo não precisa ser marcado). A lista
é separada do texto ao redor, e as entradas de cada uma das outras
por linhas em branco, como seria esperado em quebra de parágrafo.
</p>
</sect>
<sect id="examples">
<heading>Exemplos</heading>
<p>
Exemplos - fragmentos de código multi linha, scripts, e peças
semelhantes de texto de computador - são incluídos com
<tt><example></tt> e finalizados com
<tt></example></tt>.
</p>
<p>
O exemplo será formatado exatamente como ele é digitado, com
espaços e novas linhas reproduzidas. Ele será exibido com uma
fonte de largura fixa, normalmente a usada pelo estilo de caracter
<tt><tt></tt>, mesmo se o formatador normalmente usar uma
fonte proporcional. Qualquer identação que seja apropriada será
incluída pelo formatador; o exemplo deve ser incluído
iniciando na coluna do lado esquerdo.
</p>
<p>
Exemplos podem conter texto com caracteres marcados mas não podem
conter referências cruzadas ou elementos de estilo de caracter
<tt><em></tt>, <tt><strong></tt>,
<tt><package></tt>, <tt><prgn></tt>,
<tt><file></tt>, e <tt><tt></tt>. Veja <ref
id="inline">.
</p>
<p>
Um exemplo não produz uma quebra de parágrafo; exemplos são
considerados partes do parágrafo. Se um exemplo é para ser
um parágrafo por si próprio então tags de início de parágrafo
devem ser adicionadas como apropriadas.
</p>
<p>
Qualquer caracter de marcação SGML no exemplo deve ser escapado como
de costume - veja <ref id="markup">. <tt><example></tt> não
funciona como o ambiente TeX <tt>verbatim</tt>.
</p>
</sect>
</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:
-->
<chapt id="listexamp">
<heading>Lists and examples</heading>
<sect id="lists">
<heading>Lists</heading>
<p>
There are three kinds of lists:
<list compact="compact">
<item>
<p>
<tt><list></tt> - ordinary (bulleted) list
</p>
</item>
<item>
<p>
<tt><enumlist></tt> - numbered list
</p>
</item>
<item>
<p>
<tt><taglist></tt> - tagged list
</p>
</item>
</list>
</p>
<p>
Each entry in an ordinary or numbered list is an item introduced
by <tt><item></tt>. Each entry in a tagged list is one or
more <tt><tag></tt>s followed by an
<tt><item></tt>.
</p>
<p>
It is not necessary to mark the end of <tt><tag></tt> or
<tt><item></tt> elements.
</p>
<p>
All three types of list come in two flavours, depending on
whether you specify the <tt>compact</tt> attribute (eg,
<tt><taglist compact></tt>) or not (eg,
<tt><enumlist></tt>). The <tt><tag></tt> may
contain only marked-up inline text.
</p>
<p>
The compact versions are intended for use within paragraphs. The
formatter will not put gaps around the list or between
entries.<footnote><p>There is a problem with this in HTML. The
HTML formatter tries not to, by using HTML lists'
<tt>compact</tt> attribute on the lists it generates, but not
many browsers understand it properly.</p></footnote> The entries
in a compact list should each be a single paragraph (it is not
necessary to mark the start of the paragraph). Any lists inside
a compact list should themselves be marked compact (though the
formatters will in fact infer for themselves that they ought to
be compact).
</p>
<p>
The non-compact versions are intended to stand as paragraphs
themselves. Each entry in such a list may contain more than one
paragraph (once again, the start of the first paragraph need not
be marked). The list is separated from the surrounding text,
and the entries from each other, by blank lines as would be
expected for paragraph breaks.
</p>
</sect>
<sect id="examples">
<heading>Examples</heading>
<p>
Examples - multi-line code fragments, scripts, and similar
pieces of computer text - are introduced with
<tt><example></tt> and finish with
<tt></example></tt>.
</p>
<p>
The example will be formatted exactly as it is typed in, with
spacing and newlines reproduced. It will be displayed in a
fixed-width font, usually the one used for the
<tt><tt></tt> character style, even if the formatter
usually uses a proportional font. Any indentation which is
appropriate will be added by the formatter; the example should
be entered starting in the left hand column.
</p>
<p>
Examples may contain marked up character text but may not
contain cross-references or the character style elements
<tt><em></tt>, <tt><strong></tt>,
<tt><package></tt>, <tt><prgn></tt>,
<tt><file></tt>, and <tt><tt></tt>. See <ref
id="inline">.
</p>
<p>
An example does not produce a paragraph break; examples are
considered parts of paragraphs. If an example is to be a
paragraph on its own then paragraph start tags should be added
as appropriate.
</p>
<p>
Any SGML markup characters in the example must be escaped as
usual - see <ref id="markup">. <tt><example></tt> does not
work like TeX's <tt>verbatim</tt> environment.
</p>
</sect>
</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:
-->
Reply to: