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>


<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="10" next="11" previous="9">
	<description lang='spa'>Pueden aparecer comentarios en cualquier parte de un documento, fuera de las etiquetas. Un procesador de Xml puede hacer que un programa lea el texto de los comentarios, pero no necesariamente. No puede incluirse la cadena "--" (dos guiones) dentro de un comentario.</description>
	<demo type="wf">
		<description lang='spa'>Puede ponerse cualquier caracter dentro de un comentario, excepto --</description>
<doc>
{!-- doc A --}
{ejemplo}
{!-- &lt;HEAD>  --}
{!-- Characters &lt;&amp;&lt;  --}
{/ejemplo}</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>Un comentario no debe incluir --</description>
		<doc>
{ejemplo}
	{!-- A <error>--</error> B --}
{/ejemplo}</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="11" next="12" previous="10">
	<description lang='spa'>La instrucciones de procesamiento (PIs) permiten que los documentos incluyan instrucciones para programas</description>
	<demo type="wf">
		<description lang='spa'>Instrucciones de procesamiento</description>
		<doc>
{ejemplo}
{?perl lower-to-upper-case  ?}
{?web-server add-header = "universidad" ?}
{texto}vscht{/texto}
{/ejemplo}</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>Una instruccion de procesamiento tiene que acabar con ?></description>
		<doc>
{ejemplo}
{?perl run <error>_</error>}
{/ejemplo}
</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="12" next="13" previous="11">
	<description lang='spa'>Las secciones de CDATA se usan para citar  textos con caracteres que en otras circunstancias ser铆an interpretados como signos de marca. Las secciones de CDATA comienzan con la cadena "{![CDATA[" y acaban con  "]]}". No puede incluirse la cadena  "]]}" dentro de una secci贸n de CDATA  </description>
	<demo type="wf">
		<description lang='spa'>Secci贸n de CDATA</description>
<doc>
{ejemplo}
	{![CDATA[ {aaa}bb&amp;cc&lt;&lt;&lt;]]}
{/ejemplo}
</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>Una secci贸n de CDATA no puede incluir ']]&gt;'</description>
<doc>
{ejemplo}
	{![CDATA[ {aaa}bb ]]}<error>cc&lt;&lt;&lt;]]}</error>
{/ejemplo}
</doc>
</demo>
</XTutorial>
<XTutorial id="13" next="1" previous="12">
	<description lang='spa'>
	Los documentos XML pueden, y deber铆an, comenzar con una declaraci贸n XML que indique qu茅 versi贸n de XML se est谩 usando
 </description>
	<demo type="wf">
		<description lang='spa'>Indicaci贸n de la versi贸n del standard XML</description>
		<doc>
{?xml version="1.0"?}
 {texto}Este documento se adecua a la Especificaci贸n XML 1.0.{/texto}
		</doc>
	</demo>
	<demo type="wf">
		<description lang='spa'>
Indicaci贸n del juego de caracteres utilizados (encoding)
		</description>
		<doc>
{?xml version="1.0" encoding="ISO-8859-2"?}
 {texto}Si no se especifica un juego de caracteres, se 
sobreentiende que se est谩 utilizando UTF-8{/texto}
		</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="1" next="2" previous="13">
	<description lang='spa'>
		Un documeto XML debe incluir uno o m谩s elementos.
	</description>
	<demo type="wf">
<doc>
{texto}脡ste es un documento XML{/texto}
</doc>
		<description lang='spa'>
		Un documento bien formado con un elemento
		</description>
	</demo>
	<demo type="wf">
<doc>
{texto}脡ste es un
{doctipo}documento XML{/doctipo}
{/texto}
</doc>
		<description lang='spa'>
		Un documento bien formado con varios elementos
		</description>
	</demo>
	<demo type="notwf">
		<doc>
<error>???</error>脡ste es un documento XML<error>???</error>
		</doc>

<description lang='spa'>
Un documento XML debe incluir al menos un elemento		
</description>
	</demo>
</XTutorial>



<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="2" next="3" previous="1">
	<description lang='spa'>El elemento, al que llamamos elemento ra铆z o  documento, no puede formar parte del contenido de ning煤n otro elemento
		</description>
	<demo type="wf">
		<doc>
{libro}脡sto es un libro{/libro}
		</doc>
		<description lang='spa'>
{libro} es el 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='spa'>
		{lista} es el 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='spa'>
S贸lo se permite un elemento ra铆z		</description>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="3" next="4" previous="2">
	<description lang='spa'>El nombre de un elemento debe ser igual en las etiquetas inicial y final. En los nombres se distinguen may煤sculas y min煤sculas.</description>
	<demo type="wf">
		<doc>{libro}脡ste es un libro{/libro}</doc>
		<description lang='spa'>La etiqueta final  {/libro} coincide perfectamente con la etiqueta inicial {libro} </description>
	</demo>
	<demo type="wf">
		<doc>
{lista}
{item}Coche{/item}
{ITEM}Avi贸n{/ITEM}
{Item}Tren{/Item}
{/lista}
		</doc>
		<description lang='spa'>脡ste documento bien formado contiene 4 elementos distintos  {lista}, {item}, {ITEM} e {Item}</description>
	</demo>
	<demo type="notwf">
		<doc>
{lista}
{item}Coche<error>{/itm}</error>
{item}Avi贸n<error>{/ITEM}</error>
{item}Tren{/item} 
{/lista}
		</doc>
		<description lang='spa'>
{item} - {/itm} y {item} - {/ITEM} no coinciden</description>
	</demo>
</XTutorial>


<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="4" next="5" previous="3">
	<description lang='spa'>Si la etiqueta inicial est谩 dentro de un elemento, la etiqueta final tambi茅n debe estar dentro del mismo elemento. Para decirlo m谩s facil, los elementos, enmarcados por una etiqueta inicial y otra final, deben anidarse adecuadamente unos en otros</description>
	<demo type="wf">
		<description lang='spa'>Elementos anidados correctamente</description>
<doc>
{Peso}
 {numero}12{/numero}
 {unidad}gramos{/unidad}
{/Peso}
</doc>
	</demo>
	<demo type="wf">
		<description lang='spa'>Otro documento bien formado
		
		</description>
		<doc>
{libro}
	{capitulo}
		{titulo}Introducci贸n{/titulo}
	{/capitulo}
	{capitulo}
		{titulo}Historia{/titulo}
		{seccion}
			{titulo}Parte 1{/titulo}
		{/seccion}
		{seccion}
			{titulo}Parte 2{/titulo}
		{/seccion}
	{/capitulo}
	{capitulo}
		{title}Indice{/title}
	{/capitulo}
{/libro}
</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>El elemento {cursiva} no est谩 anidado correctamente
					</description>
		<doc>
{texto}
	{negrilla}{cursiva}XML<error>{/negrita}</error>{/cursiva}
{/texto}

		</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="5" next="6" previous="4">
	<description lang='spa'>Todo elemento cuyo principio se marca con una etiqueta inicial, debe marcarse con una etiqueta final que repita el nombre del elemento, expresado igual que en la etiqueta inicial. El texto contenido entre la etiqueta inicial y la etiqueta final se llama contenido del elemento. Un elemento sin contenido puede tomar una forma especial {nombre/}. La barra situada antes de } sustituye la etiqueta final</description>
	<demo type="wf">
		<description lang='spa'>Cada elemento o bien tiene una etiqueta final o bien toma esta forma especial. No hay diferencia entre {AAA}{/AAA} y {AAA/} en XML</description>
		<doc>
{listaDeEtiquetas}
	{AAA}{/AAA}
	{BBB}{/BBB}
	{CCC/}
	{DDD/}
{/listaDeEtiquetas}
		</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>No poner la barra es un error muy corriente</description>
		<doc>
{descripcion}
Hay manzanas {color}amarillas<error>{color}</error> y {color}rojas{/color}.
{/descripcion}

		</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="6" next="7" previous="5">
	<description lang='spa'>Los nombres de los elementos pueden incluir letras, n煤meros, guiones, guiones bajos, comas y puntos. La coma se puede usar s贸lo en un caso especial, cuando separa lo que llamamos namespace. Los nombres de elemento que comienzan con xml, XML u otras combinaciones de esta clase de cadena est谩n reservadas para el standard.</description>
	<demo type="wf">
		<description lang='spa'>Documento con caracteres permitidos</description>
		<doc>
{nombresPermitidos}
	{nombre/}
	{xsl:copy-of/}
       	{Un_nombre_de_elemento_largo/}
       	{Un.nombre.separado.con.puntos/}
	{a123323123-231-231/}
	{_12/}
{/nombresPermitidos}
		</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>Este documento contiene varios errores</description>
		<doc>
{nombresProhibidos}
{A<error>;</error>nombre/}{ultimo<error>@</error>nombre}{<error>@#$%^()%+?=</error>/}
{A<error>*</error>2/}
{<error>1</error>ex/}
{/nombresProhibidos}
	</doc>
	</demo>
	<demo type="notwf">
<description lang='spa'>Los nombres no pueden empezar con xml</description>
		<doc>
{nombresProhibidos}
{<error>xml</error>Tag/}
{<error>XML</error>Tag/}
{<error>XmL</error>Tag/}
{<error>xMl</error>Tag/}
{<error>xmL</error>Tag/}
{/nombresProhibidos}
	</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="7" next="8" previous="6">
	<description lang='spa'>Un elemento puede tener varios, uno o ning煤n atributo. En los nombres de atributo pueden utilizarse los mismos caracteres permitidos que en los nombres de elemento. El nombre del atributo y su valor se separan con =. El valor del atributo debe darse entre apostrofes '...' o comillas dobles "..." . Si se usan  comillas o  apostrofes en el contenido del atributo, se utilizar谩 el contrario como marcador.</description>
	<demo type="wf">
		<description lang='spa'>Un documento con atributos bien formados<!--Notice I did not translate the case1 because  apostrofe is not used in standard spanish, but the english use is well known, even for not english speakers-->
		</description>
		<doc>
{elementos-con-atributos}
	{el _ok = "si" /}
	{un attr = "un valor"/}
	{varios primero="1" segundo = '2' tercero= "333"/}
	{apos_cita caso1="John's" caso2='脡l dijo: "隆Hola, mundo!"  '/}
{/elementos-con-atributos}</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>Un documento con atributos equivocados
		</description>
		<doc>		
{errores}
	{Un Caracter_equivocado <error>*</error>b = "23432"/}
	{separador_mal_emparejado =<error>"</error>12<error>'</error>/}
	{un tipo_de_separador_equivocado ="aa <error>"</error>aa"/}
	{otro tipo_de_separador_equivocado ='bb	<error>'</error>bb'/}
	{principio_equivocado <error>XML</error>-ID = "xml234"/}
{/errors}		</doc>
	</demo>
</XTutorial>

<XTutorial id="8" next="9" previous="7">
	<description lang='spa'>Los caracteres &lt; y &amp; no pueden usarse en el texto, puesto que se usan como marcas. Si se necesitan, debe usarse &amp;lt; en vez de &lt; y &amp;amp; en lugar de &amp;</description>
	<demo type="wf">
		<description lang='spa'>sustituci贸n de &amp; y &lt;</description>
		<doc>
{ejemplo}
	{esMenor}
		23 &amp;lt; 46
	{/esMenor}
	{ampersand}
		Willey &amp;amp; hijos
	{/ampersand}
{/ejemplo}

		</doc>
	</demo>
	<demo type="notwf">
		<description lang='spa'>
			No se pueden usar los caracteres &amp; and &lt; de un texto
		</description>
		<doc>

{ejemplo}
	{esMenor}
		23 <error>&lt;</error> 46
	{/esMenor}
	{ampersand}
		Willey <error>&amp;</error> hijos
	{/ampersand}
{/ejemplo}

		</doc>
	</demo>
</XTutorial>

<!-- edited with XML Spy v4.0.1 (http://www.xmlspy.com) by Ana Gonzalez (private) -->
<XTutorial id="9" next="10" previous="8">
	<description lang='spa'>Tambi茅n pueden sustituirse los caracteres >, ", ' , respectivamente con &amp;gt; , &amp;quot; y &amp;apos;
	</description>
	<demo type="wf">
<description lang='spa'>Sustituciones posibles</description>
		<doc>

{ejemplo}
	{mayor-que} Puede usarse tanto  >  como  &amp;gt; {/mayor-que}
	{comillas-dobles} Puede usarse tanto " como &amp;quot; {/comillas-dobles}
	{apostrofe} Puede usarse indistintamente  tanto ' como &amp;apos;{/apostrofe}
	Esto es 煤til: {el valor=" &amp;apos; &amp;quot; &amp;apos; "/}
{/ejemplo}

		</doc>
	</demo>
</XTutorial>

</allExamples>