[RFR] ddp://manuals.sgml/debiandoc-sgml-doc-pt-br/markup.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="markup">
<heading>SGML markup and metacharacters</heading>
<p>
As entered in a text editor SGML document consists of text
interspersed with tags denoting the start and end of elements.
</p>
<p>
Tags take the form <tt><<var>element</var>></tt> to start
the element <var>element</var> and
<tt><<var>/element</var>></tt> to finish it.
</p>
<p>
There are some shorthands you can use:
<tt><<var>element/</var><var>contents/</var></tt> specifies an
element <var>element</var> with contents <var>contents</var> - but
the <var>contents</var> may not contain a slash
<tt>/</tt>. <tt></></tt> closes the innermost currently open
element.
</p>
<p>
Some types of element start tag can have attributes; these appear
inside the closing angle bracket, and are separated from the
element name by whitespace. The attributes allowed in a
particular element's start tag are described along with the
element.
</p>
<p>
If you want to include SGML's markup characters (angle brackets
<tt><</tt> <tt>></tt> and ampersands <tt>&</tt>) as text
you must refer to them by name (this is called an entity reference
in SGML-speak). <tt>&<var>name</var>;</tt> produces the
character whose name is <var>name</var>.
</p>
<p>
Some useful character names are:
<taglist compact="compact">
<tag>
<tt>lt</tt>
</tag>
<item>
<p>
less than sign (left angle bracket) <tt><</tt>
</p>
</item>
<tag>
<tt>gt</tt>
</tag>
<item>
<p>
greater than sign (right angle bracket) <tt>></tt>
</p>
</item>
<tag>
<tt>amp</tt>
</tag>
<item>
<p>
ampersand <tt>&</tt>
</p>
</item>
<tag>
<tt>copy</tt>
</tag>
<item>
<p>
copyright symbol <tt>©</tt>
</p>
</item>
</taglist>
</p>
<p>
DebianDoc-SGML supports the full set of ISO entities as defined
in the files <file>/usr/lib/sgml/entities/ISO*</file>.
</p>
<p>
You can also use <tt>&#<var>number</var>;</tt> to refer to the
character whose number is <var>number</var> (in
ISO-LATIN-1). <var>number</var> should be in decimal.
</p>
</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="markup">
<heading>Marcação SGML e meta-caracteres</heading>
<p>
Como digitado em um editor de texto o documento SGML consiste de
texto intercalado com tags marcando o início e o fim dos elementos.
</p>
<p>
Tags têm a forma <tt><<var>elemento</var>></tt> para iniciar
o <var>elemento</var> e <tt><<var>/elemento</var>></tt> para
finalizá-lo.
</p>
<p>
Existem alguns atalhos que você pode usar:
<tt><<var>elemento/</var><var>conteúdo/</var></tt> especifica
um elemento <var>elemento</var> com conteúdo <var>conteúdo</var>,
mas o <var>conteúdo</var> não pode conter uma barra <tt>/</tt>.
<tt></></tt> fecha o elemento mais próximo atualmente aberto.
</p>
<p>
Alguns tipos de tag de início de elemento podem conter atributos;
estes aparecem dentro do sinais menor e maior, e são separados do
nome do elemento por um espaço em branco. Os atributos permitidos
em uma determinada tag de início de elemento são descritos
juntamente com o elemento.
</p>
<p>
Se você quiser incluir caracteres de marcação de SGML (sinais menor
e maior <tt><</tt>, <tt>></tt> e comercial <tt>&</tt>) como
texto você deve se referir a eles pelo nome (isso é o que chamamos uma
referência de entidade na linguagem SGML). <tt>&<var>nome</var>;</tt>
produz o caracter cujo nome é <var>nome</var>.
</p>
<p>
Alguns nomes de caracteres úteis são:
<taglist compact="compact">
<tag>
<tt>lt</tt>
</tag>
<item>
<p>
sinal de menor que (esquerdo) <tt><</tt>
</p>
</item>
<tag>
<tt>gt</tt>
</tag>
<item>
<p>
sinal de maior que (direito) <tt>></tt>
</p>
</item>
<tag>
<tt>amp</tt>
</tag>
<item>
<p>
e comercial <tt>&</tt>
</p>
</item>
<tag>
<tt>copy</tt>
</tag>
<item>
<p>
símbolo de copyright <tt>©</tt>
</p>
</item>
</taglist>
</p>
<p>
Deiandoc-SGML suporta o conjunto inteiro de entidades ISO como
definido no arquivo <file>/usr/lib/sgml/entities/ISO*</file>.
</p>
<p>
Você também pode usar <tt>&#<var>número</var>;</tt> para se
referir ao caracter cujo número é <var>número</var> (em
ISO-Latin-1). <var>número</var> deve ser em decimal.
</p>
</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:
-->
<!-- LocalWords: tags tag SGML caracter lt gt amp copy copyright Deiandoc ISO
-->
<!-- LocalWords: Latin
-->
Reply to: