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="10" next="11" previous="9">
<description lang='ita'>I commenti possono essere posti ovunque nel documento, purch&#233; all'esterno dei tag. Un processore XML pu&#242;, ma non necessariamente, rendere possibile per una applicazione il recupero del testo dei commenti. La sequenza "--" (doppio trattino) non deve comparire all'interno dei commenti. </description>

<demo type="wf">
<description lang='ita'>I commenti possono contenere qualsiasi carattere eccettuata la sequenza "--"</description>
<doc>
{!-- doc A --}
{esempio}
{!-- &lt;HEAD>  --}
{!-- Caratteri &lt;&amp;&lt;  --}
{/esempio}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>I commenti non devono contenere la sequenza "--"</description>

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

</demo>

</XTutorial>

<XTutorial id="11" next="12" previous="10">
<description lang='ita'>Le istruzioni di processo (PI) permettono ad un documento di contenere istruzioni per applicazioni. </description>
<demo type="wf">
<description lang='ita'>Istruzioni di processo </description>
<doc>
{esempio}
{?perl lower-to-upper-case  ?}
{?web-server add-header = "university" ?}
{text}vscht{/text}
{/esempio}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>Le istruzioni di processo devono terminare con ?></description>
<doc>
{esempio}
{?perl run <error>_</error>}

{/esempio}
</doc>

</demo>

</XTutorial>

<XTutorial id="12" next="13" previous="11">

<description lang='ita'>Le sezioni CDATA sono usate per risolvere blocchi di testo contenenti caratteri che sarebbero altrimenti riconosciuti come marcatori. Le sezioni CDATA iniziano con la sequenza "{![CDATA[" e terminano con la sequenza "]]}". La sequenza ']]}' non deve essere presente all'interno della sezione CDATA . </description>    

<demo type="wf">
<description lang='ita'>La sezione CDATA</description>
<doc>
{esempio}
	{![CDATA[ {aaa}bb&amp;cc&lt;&lt;&lt;]]}
{/esempio}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>La sezione CDATA non deve contenere ']]}' </description>
<doc>
{esempio}
	{![CDATA[ {aaa}bb ]]}<error>cc&lt;&lt;&lt;]]}</error>
{/esempio}
</doc>

</demo>

</XTutorial>

<XTutorial id="13" next="1" previous="12">
<description lang='ita'>Un documento XML pu&#242;, e dovrebbe, iniziare con una dichiarazione XML che specifica la versione di XML utilizzata. </description>
<description></description>
<demo type="wf">
<description lang='ita'>Dichiarazione della versione di XML</description>
<doc>
{?xml version="1.0"?}
 {text}Questo documento &#232; conforme alla specifica XML 1.0.{/text}
</doc>
</demo>

<demo type="wf">
<description lang='ita'>Specifica di codifica </description>
<doc>
{?xml version="1.0" encoding="ISO-8859-2"?}
 {text}Se non &#232; specificata la codifica, si assume che sia UTF-8{/text}
</doc>

</demo>

</XTutorial>
<XTutorial id="1" next="2" previous="13">
<description lang='ita'>Un documento XML deve contenere uno o pi&#249; elementi.</description>

<demo type="wf">
<doc>
{text}Questo &#232; un documento XML{/text}
</doc>
<description lang='ita'>Un documento ben formato con un elemento</description>
</demo>
<demo type="wf">
<doc>
{text}Questo &#232; un
{doctype}documento XML{/doctype}
{/text}
</doc>
<description lang='ita'>Un documento ben formato con pi&#249; elementi</description>
</demo>
<demo type="notwf">
<doc>
<error>???</error> Questo &#232; un documento XML <error>???</error>
</doc>
<description lang='ita'>Un documento XML deve contenere almeno un elemento.</description>
</demo>
</XTutorial>

<XTutorial id="2" next="3" previous="1">
<description lang='ita'>C'&#232; esattamente un elemento, chiamato root (radice), od elemento documento, nessuna parte del quale &#232; contenuta in altri elementi.</description>
<demo type="wf">
<doc>
{libro}Questo &#232; un libro{/libro}
</doc>
<description lang='ita'>{libro} &#232; l'elemento root</description>
</demo>
<demo type="wf">
<doc>
{elenco}
{voce}Elemento 1{/voce}
{voce}Elemento 2{/voce}
{voce}Elemento 3{/voce}
{/elenco}
</doc>
<description lang='ita'>{elenco} &#232; l'elemento root</description>
</demo>
<demo type="notwf">
<doc>
<error>???</error>
{voce}Elemento 1{/voce}
{voce}Elemento 2{/voce}
{voce}Elemento 3{/voce} 
<error>???</error>
</doc>
<description lang='ita'>&#200; consentito un unico elemento root</description>
</demo>
</XTutorial>

<XTutorial id="3" next="4" previous="2">
<description lang='ita'>Nel tag di chiusura, il nome di un elemento deve corrispondere al nome del tag di apertura. I nomi distinguono fra maiuscole e minuscole.</description>
<demo type="wf">
<doc>
{libro}Questo &#232; un libro{/libro}
</doc>
<description lang='ita'>Il tag di chiusura {/libro} corrisponde al tag di apertura {libro}</description>
</demo>
<demo type="wf">
<doc>
{elenco}
{voce}Automobile{/voce}
{VOCE}Aereo{/VOCE}
{Voce}Treno{/Voce}
{/elenco}
</doc>
<description lang='ita'>Questo documento ben formato contiene 4 differenti elementi {elenco}, {voce}, {VOCE} e {Voce}</description>
</demo>
<demo type="notwf">
<doc>
{elenco}
{voce}Automobile<error>{/vce}</error>
{voce}Aereo<error>{/VOCE}</error>
{voce}Treno{/voce} 
{/elenco}
</doc>
<description>{item} - {itm/} and {item} - {/ITEM} does not match</description>
<description lang='ita'>{voce} - {/vce} e {voce} - {/VOCE} non sono corrispondenti</description>
</demo>
</XTutorial>

<XTutorial id="4" next="5" previous="3">
<description lang='ita'>Se il tag di apertura &#232; contenuto in un'altro elemento, anche il tag di chiusura deve essere contenuto nel medesimo elemento. Pi&#249; semplicemente ciascun elemento, delimitato dai tag di apertura e di chiusura deve essere correttamente annidato.</description>
<demo type="wf">
<description lang='ita'>Gli elementi sono annidati correttamente.</description>
<doc>
{Peso}
	{numero}12{/numero}
	{unita}grammi{/unita}
{/Peso}
</doc>

</demo>
<demo type="wf">
<description lang='ita'>Un altro documento ben formato</description>
<doc>
{libro}
	{capitolo}
		{titolo}Introduzione{/titolo}
	{/capitolo}
	{capitolo}
		{titolo}Storia{/titolo}
		{sottoCapitolo}
			{titolo}Parte 1{/titolo}
		{/sottoCapitolo}
		{sottoCapitolo}
			{titolo}Parte 2{/titolo}
		{/sottoCapitolo}
	{/capitolo}
	{capitolo}
		{titolo}Indice{/titolo}
	{/capitolo}
{/libro}
</doc>
</demo>
<demo type="notwf">
<description lang='ita'>L'elemento {italic} non &#232; correttamente annidato</description>
<doc>
{text}
	{bold}{italic}XML<error>{/bold}</error>{/italic}
{/text}
</doc>

</demo>
</XTutorial>




<XTutorial id="5" next="6" previous="4">
<description lang='ita'>La fine di ciascun elemento che inizia con un tag di apertura deve essere marcata con un tag di chiusura avente un nome corrispondente al nome dato al tag di apertura. Il testo compreso fra il tag di apertura ed il tag di chiusura &#232; il contenuto dell'elemento. Un elemento privo di contenuto pu&#242; prendere la forma speciale: {name/} . La barra prima del } sostituisce il tag di chiusura.</description>
<demo type="wf">
<description lang='ita'>Ciascun elemento deve avere il tag di chiusura oppure deve prendere la forma speciale. Non c'&egrave; differenza fra {AAA}{/AAA} e {AAA/} in XML.</description>
<doc>
{elencoDiTags}
	{AAA}{/AAA}
	{BBB}{/BBB}
	{CCC/}
	{DDD/}
{/elencoDiTags}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>Una barra dimenticata &#232; un errore molto comune.</description>
<doc>
{descrizione}
Ci sono mele di colore {colore}giallo<error>{colore}</error> e {colore}rosso{/colore}.
{/descrizione}
</doc>

</demo>
</XTutorial>

<XTutorial id="6" next="7" previous="5">
<description lang='ita'>Un elemento pu&#242; contenere lettere, cifre, trattini, segni di sottolineatura, due punti o punti. I due punti possono venir usati solamente nel caso speciale in cui separano i cosiddetti namespace. Gli elementi che iniziano con xml, XML od altre loro combinazioni di maiuscole e minuscole, sono riservati per lo standard.   </description>
 <demo type="wf">
<description lang='ita'>Un documento con caratteri consentiti</description>
<doc>
{nomiConsentiti}
	{nome/}
	{xsl:copy-of}
	{Un_lungo_nome_di_elemento/}
	{Un.nome.separato.da.punti/}
	{a123323123-231-231/}
	{_12/}
{/nomiConsentiti}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>Questo documento contiene parecchi errori. </description>
<doc>
{nomiProibiti}
	{Un<error>;</error>nome/}
	{ultimo<error>@</error>nome}
	{<error>@#$%^()%+?=</error>/}
	{A<error>*</error>2/}
	{<error>1</error>ex/}
{/nomiProibiti}
</doc>
</demo>

<demo type="notwf">
<description lang='ita'>I nomi non possono iniziare con xml</description>
<doc>
{nomiProibiti}
	{<error>xml</error>Tag/}
	{<error>XML</error>Tag/}
	{<error>XmL</error>Tag/}
	{<error>xMl</error>Tag/}
	{<error>xmL</error>Tag/}
{/nomiProibiti}
</doc>
</demo>
</XTutorial>

<XTutorial id="7" next="8" previous="6">
<description lang='ita'>Un elemento pu&#242; avere nessuno, uno o pi&#249; attributi. I caratteri consentiti sono i medesimi che per i nomi degli elementi. Il nome di un attributo &#232; separato dal proprio valore da =. Il valore dell'attributo deve essere fra apici '...' o doppie virgolette "..." . Se un apice o le doppie virgolette compaiono nel valore dell'attributo, allora occorre delimitare il valore con l'altro segno.  </description>
<demo type="wf">
<description lang='ita'>Documento con attributi formati correttamente</description>
<doc>
{elementi-con-attributi}
	{el _ok = "yes" /}
	{un attributo = "a value"/}
	{numerosi primo="1" secondo = '2' terzo= "333"/}
	{apostrofi caso1="John's" caso2='He said: "Hello, world!"  '/}
{/elementi-con-attributi}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>Documento con attributi formati in maniera errata</description>
<doc>
{errori}
	{carattere_errato a<error>*</error>b = "23432"/}
	{delimitatore_non_congruente  valore = <error>"</error>12<error>'</error>/}
	{delimitatore_di_tipo_errato  valore="aa<error>"</error>aa"/}
	{delimitatore_di_tipo_errato  valore='bb<error>'</error>bb'/}
	{inizio_errato <error>XML</error>-ID = "xml234"/}
{/errori}
</doc>
</demo>

</XTutorial>

<XTutorial id="8" next="9" previous="7">
<description lang='ita'>I caratteri &lt; e &amp; non possono venire usati nel testo poich&#233; si utilizzano per i tag. Se occorrono questi caratteri,si usa &amp;lt; al posto di &lt; ed &amp;amp; al posto di &amp; </description>
<demo type="wf">
<description lang='ita'>Sostituzione di &amp; e &lt;</description>
<doc>
{esempio}
	{minore}
		23 &amp;lt; 46
	{/minore}
	{ampersand}
		Willey &amp;amp; sons
	{/ampersand}
{/esempio}
</doc>

</demo>

<demo type="notwf">
<description lang='ita'>I caratteri &amp; e &lt; non possono essere usati all'interno del testo</description>
<doc>
{esempio}
	{minore}
		23 <error>&lt;</error> 46
	{/minore}
	{ampersand}
		Willey <error>&amp;</error> sons
	{/ampersand}
{/esempio}
</doc>
</demo>

</XTutorial>

<XTutorial id="9" next="10" previous="8">
<description lang='ita'>Anche i caratteri >, " , e ' possono essere rispettivamente sostituiti da &amp;gt; , &amp;quot; e &amp;apos; </description>
<demo type="wf">
<description lang='ita'>Sostituzioni possibili</description>
<doc>
{esempio}
	{parentesi-destra} entrambi > e &amp;gt; sono permessi{/parentesi-destra}
	{doppie-virgolette} entrambi " e &amp;quot; sono permessi{/doppie-virgolette}
	{apostrofo} entrambi ' e &amp;apos; sono permessi{/apostrofo}
	Utili in: {el value=" &amp;apos; &amp;quot; &amp;apos; "/}
{/esempio}
</doc>

</demo>


</XTutorial>

</allExamples>