source.xml

XML tutorial

<!-- generated by run.py  -->
<!DOCTYPE allExamples [
 <!ENTITY eacute '&#233;'>
 <!ENTITY ugrave '&#249;'>
 <!ENTITY agrave '&#224;'>
 <!ENTITY egrave '&#232;'>
 <!ENTITY ograve '&#242;'>
 <!ENTITY icirc  '&#238;'>
 <!ENTITY ecirc  '&#234;'>
 <!ENTITY ccedil '&#231;'>
]>
<allExamples>


<XTutorial id="1" next="2" previous="13">
<description lang='por'>Um documento XML deve conter um ou mais elementos.</description>
<demo type="wf">
<doc>
{texto}Este 茅 um documento XML{/texto}
</doc>
<description lang='por'>Documento bem formado com um elemento</description>
</demo>
<demo type="wf">
<doc>
{texto}Este 茅 um
{tipodoc}documento XML{/tipodoc}
{/texto}
</doc>
<description lang='por'>Documento bem formado com v谩rios elementos</description>
</demo>
<demo type="notwf">
<doc>
<error>???</error> Este 茅 um documento XML <error>???</error>
</doc>
<description lang='por'>Um documento XML deve conter ao menos um elemento</description>
</demo>
</XTutorial>




<XTutorial id="10" next="11" previous="9">
<description lang='por'>Coment谩rios podem aparecer em qualquer lugar do documento fora de outra marca莽茫o. Um processador de XML pode, mas n茫o necessariamente, tornar poss铆vel a leitura desses coment谩rios por uma aplica莽茫o. A string "--" (dois h铆fens) n茫o pode ocorrer nos coment谩rios. </description>

<demo type="wf">
<description lang='por'>Nos coment谩rios podem ocorrer quaisquer caracteres, exceto o "--"</description>
<doc>
{!-- doc A --}
{exemplo}
{!-- &lt;HEAD>  --}
{!-- Caracteres &lt;&amp;&lt;  --}
{/exemplo}
</doc>

</demo>

<demo type="notwf">
<description lang='por'>Um coment谩rio n茫o pode incluir "--"</description>

<doc>
{exemplo}
	{!-- A <error>--</error> B --}
{/exemplo}
</doc>

</demo>

</XTutorial>

<XTutorial id="11" next="12" previous="10">
<description lang='por'>Instru莽玫es de processamento(PIs) permitem aos documentos conter instru莽玫es para aplica莽玫es. </description>
<demo type="wf">
<description lang='por'>Instru莽玫es de processamento</description>
<doc>
{exemplo}
{?perl lower-to-upper-case  ?}
{?web-server add-header = "universidade" ?}
{texto}vscht{/texto}
{/exemplo}
</doc>
</demo>

<demo type="notwf">
<description lang='por'>Instru莽玫es de processamento devem terminar com ?></description>
<doc>
{exemplo}
{?perl run <error>_</error>}
{/exemplo}
</doc>

</demo>

</XTutorial>

<XTutorial id="12" next="13" previous="11">
<description lang='por'>Se莽玫es CDATA s茫o usadas para preservar blocos de texto com caracteres que seriam interpretados como marca莽茫o. As se莽玫es CDATA come莽am com a string "{![CDATA[" e terminam com
a string "]]}". A string ']]}' n茫o pode ocorrer dentro da se莽茫o CDATA. </description>

<demo type="wf">
<description lang='por'>Se莽茫o CDATA </description>
<doc>
{exemplo}
	{![CDATA[ {aaa}bb&amp;cc&lt;&lt;&lt;]]}
{/exemplo}
</doc>

</demo>

<demo type="notwf">
<description lang='por'>A se莽茫o CDATA n茫o pode conter ']]}' </description>
<doc>
{exemplo}
	{![CDATA[ {aaa}bb ]]}<error>cc&lt;&lt;&lt;]]}</error>
{/exemplo}
</doc>

</demo>

</XTutorial>

<XTutorial id="13" next="1" previous="12">
<description lang='por'>Documentos XML podem, e deveriam, come莽ar com uma declara莽茫o XML que especifica a vers茫o do XML que est谩 sendo usada. </description>
<description></description>
<demo type="wf">
<description lang='por'>Especifica莽茫o da vers茫o do XML</description>
<doc>
{?xml version="1.0"?}
 {texto}Este documento est谩 em conformidade com a especifica莽茫o do XML 1.0.{/texto}
</doc>
</demo>

<demo type="wf">
<description lang='por'>Especifica莽茫o da codifica莽茫o(Encoding)</description>
<doc>
{?xml version="1.0" encoding="ISO-8859-2"?}
 {texto}Quando uma codifica莽茫o n茫o 茅 especificada, a UTF-8 茅 utilizada como padr茫o{/texto}
</doc>

</demo>

</XTutorial>

<XTutorial id="2" next="3" previous="1">
<description lang='por'>Existe um 煤nico elemento, o elemento ra铆z, que n茫o pode fazer parte do conte煤do de nenhum outro elemento.</description>
<demo type="wf">
<doc>
{livro}Isto 茅 um livro{/livro}
</doc>
<description lang='por'>{livro} 茅 o elemento ra铆z</description>
</demo>
<demo type="wf">
<doc>
{lista}
{item}Item 1{/item}
{item}Item 2{/item}
{item}Item 3{/item}
{/lista}
</doc>
<description lang='por'>{lista} 茅 o elemento ra铆z</description>
</demo>
<demo type="notwf">
<doc>
<error>???</error>
{item}Item 1{/item}
{item}Item 2{/item}
{item}Item 3{/item} 
<error>???</error>
</doc>
<description lang='por'>Apenas um elemento ra铆z 茅 permitido</description>
</demo>
</XTutorial>

<XTutorial id="3" next="4" previous="2">
<description lang='por'>O nome de um elemento deve ser igual na marca莽茫o (tag) inicial e na marca莽茫o final. 
H谩 diferencia莽茫o entre letras mai煤sculas e letras min煤sculas.</description>

<demo type="wf">
<doc>
{livro}Isto 茅 um livro{/livro}
</doc>
<description lang='por'>A marca莽茫o final {/livro} coincide com a marca莽茫o inicial {livro} </description>
</demo>
<demo type="wf">
<doc>
{lista}
{item}Carro{/item}
{ITEM}Avi茫o{/ITEM}
{Item}Trem{/Item}
{/lista}
</doc>
<description lang='por'>Este documento bem formado cont茅m 4 elementos diferentes {lista}, {item}, {ITEM} e {Item}</description>
</demo>
<demo type="notwf">
<doc>
{lista}
{item}Carro<error>{/itm}</error>
{item}Avi茫o<error>{/ITEM}</error>
{item}Trem{/item} 
{/lista}
</doc>
<description>{item} - {/itm} e {item} - {/ITEM} n茫o coincidem</description>
</demo>
</XTutorial>

<XTutorial id="4" next="5" previous="3">
<description lang='por'>Se a marca莽茫o inicial est谩 dentro de um elemento, a marca莽茫o final tamb茅m deve estar dentro do mesmo elemento. Simplificando: os elementos, delimitados pela marca莽茫o inicial e pela marca莽茫o final devem estar aninhados. </description>
<demo type="wf">
<description lang='por'>Elementos aninhados corretamente</description>
<doc>
{Peso}
	{n煤mero}12{/n煤mero}
	{unidade}gramas{/unidade}
{/Peso}
</doc>

</demo>
<demo type="wf">
<description lang='por'>Outro documento bem formado</description>
<doc>
{livro}
	{cap铆tulo}
		{t铆tulo}Introdu莽茫o{/t铆tulo}
	{/cap铆tulo}
	{cap铆tulo}
		{t铆tulo}Hist贸ria{/t铆tulo}
		{se莽茫o}
			{t铆tulo}Parte 1{/t铆tulo}
		{/se莽茫o}
		{se莽茫o}
			{t铆tulo}Parte 2{/t铆tulo}
		{/se莽茫o}
	{/cap铆tulo}
	{cap铆tulo}
		{t铆tulo}脥ndice{/t铆tulo}
	{/cap铆tulo}
{/livro}
</doc>
</demo>
<demo type="notwf">
<description lang='por'>O elemento {it谩lico} n茫o est谩 aninhado corretamente</description>
<doc>
{texto}
	{negrito}{it谩lico}XML<error>{/negrito}</error>{/it谩lico}
{/texto}
</doc>

</demo>
</XTutorial>




<XTutorial id="5" next="6" previous="4">
<description lang='por'>Todo elemento deve manter o mesmo nome na marca莽茫o inicial e na marca莽茫o final. O texto entre a marca莽茫o inicial e a marca莽茫o final 茅 chamado conte煤do do elemento. Um elemento sem conte煤do pode tomar uma forma especial {nome/}. A barra antes do } substitui a marca莽茫o final.</description>
<demo type="wf">
<description lang='por'>Cada elemento ou tem a marca莽茫o final ou toma uma forma especial. N茫o h谩 diferen莽a entre {AAA}{/AAA} e {AAA/} em XML.</description>
<doc>
{listaDeMarca莽玫es}
	{AAA}{/AAA}
	{BBB}{/BBB}
	{CCC/}
	{DDD/}
{/listaDeMarca莽玫es}
</doc>

</demo>

<demo type="notwf">
<description lang='por'>A aus锚ncia da barra 茅 um erro muito comum</description>
<doc>
{descri莽茫o}
Existem ma莽茫s {cor}amarelas<error>{cor}</error> e {cor}vermelhas{/cor}.
{/descri莽茫o}
</doc>

</demo>
</XTutorial>

<XTutorial id="6" next="7" previous="5">
<description lang='por'>O nome dos elementos podem conter letras, d铆gitos, h铆fens, underscores, dois pontos, ou pontos. Dois pontos podem ser usados somente em um caso especial, quando separam, o que chamamos namespace. Os nomes dos elementos que come莽am com xml, XML ou outra combina莽茫o dessa string s茫o reservados por padr茫o.</description>
<demo type="wf">
<description lang='por'>Documento com caracteres permitidos</description>
<doc>
{nomesPermitidos}
	{nome/}
	{xsl:copy-of/}
	{Um_nome_de_elemento_longo/}
	{Um.nome.separado.com.pontos/}
	{a123323123-231-231/}
	{_12/}
{/nomesPermitidos}
</doc>

</demo>

<demo type="notwf">
<description lang='por'>Este documento cont茅m v谩rios erros</description>
<doc>
{nomesProibidos}
	{A<error>;</error>nome/}
	{煤ltimo<error>@</error>nome}
	{<error>@#$%^()%+?=</error>/}
	{A<error>*</error>2/}
	{<error>1</error>ex/}
{/nomesProibidos}
</doc>
</demo>

<demo type="notwf">
<description lang='por'>Os nomes n茫o podem come莽ar com xml</description>
<doc>
{nomesProibidos}
	{<error>xml</error>Tag/}
	{<error>XML</error>Tag/}
	{<error>XmL</error>Tag/}
	{<error>xMl</error>Tag/}
	{<error>xmL</error>Tag/}
{/nomesProibidos}
</doc>
</demo>
</XTutorial>

<XTutorial id="7" next="8" previous="6">
<description lang='por'>Um elemento pode conter v谩rios, um ou nenhum atributo. Os caracteres permitidos s茫o os mesmos dos nomes de elementos. O nome do atributo 茅 separado de seu valor por =. O valor do atributo deve estar entre ap贸strofes '...' ou aspas duplas  "..." . Se um ap贸strofe ou aspas duplas s茫o usadas no valor do atributo o delimitador contr谩rio deve ser usado.</description>
<demo type="wf">
<description lang='por'>Documento com atributos bem formados</description>
<doc>
{elementos-com-atributos}
	{el _ok = "sim" /}
	{um attr = "um valor"/}
	{v谩rios primeiro="1" segundo = '2' terceiro= "333"/}
	{apos_citacao caso1="John's" caso2='Ele disse: "Ol谩, mundo!"  '/}
{/elementos-com-atributos}
</doc>

</demo>

<demo type="notwf">
<description lang='por'>Documento com atributos incorretos</description>
<doc>
{erros}
	{char_errado a<error>*</error>b = "23432"/}
	{separador_mal_combinado value = <error>"</error>12<error>'</error>/}
	{tipo_de_separador_errado  value="aa<error>"</error>aa"/}
	{outro_tipo_de_separador_errado  value='bb<error>'</error>bb'/}
	{come莽o_errado <error>XML</error>-ID = "xml234"/}
{/erros}
</doc>
</demo>

</XTutorial>

<XTutorial id="8" next="9" previous="7">
<description lang='por'>Caracteres &lt; e &amp; n茫o podem ser usados no texto como s茫o usados nas marca莽玫es. Se esses caracteres s茫o necess谩rios utiliza-se &amp;lt; ao inv茅s de &lt; e &amp;amp; ao inv茅s de &amp; </description>
<demo type="wf">
<description lang='por'>Substitui莽茫o do &amp; e do &lt; </description>
<doc>
{exemplo}
	{ehmenor}
		23 &amp;lt; 46
	{/ehmenor}
	{ecomercial}
		Willey &amp;amp; filhos
	{/ecomercial}
{/exemplo}
</doc>

</demo>

<demo type="notwf">
<description lang='por'>Caracteres &amp; e &lt; n茫o podem ser usados no texto</description>
<doc>
{exemplo}
	{ehmenor}
		23 <error>&lt;</error> 46
	{/ehmenor}
	{ecomercial}
		Willey <error>&amp;</error> filhos
	{/ecomercial}
{/exemplo}
</doc>
</demo>

</XTutorial>

<XTutorial id="9" next="10" previous="8">
<description lang='por'>Caracteres >, " , e ' podem ser substitu铆dos por &amp;gt; , &amp;quot; e &amp;apos; , respectivamente</description>
<demo type="wf">
<description lang='por'>Substitui莽玫es poss铆veis</description>
<doc>
{exemplo}
	{maior que} > e &amp;gt; s茫o permitidos{/maior que}
	{aspas-duplas} " e &amp;quot; s茫o permitidos{/aspas-duplas}
	{ap贸strofe} ' e &amp;apos; s茫o permitidos{/ap贸strofe}
	脷til: {o valor=" &amp;apos; &amp;quot; &amp;apos; "/}
{/exemplo}
</doc>

</demo>


</XTutorial>

</allExamples>