diff options
Diffstat (limited to 'files/it/creare_un_microsommario')
| -rw-r--r-- | files/it/creare_un_microsommario/index.html | 209 |
1 files changed, 209 insertions, 0 deletions
diff --git a/files/it/creare_un_microsommario/index.html b/files/it/creare_un_microsommario/index.html new file mode 100644 index 0000000000..4d4e37cc46 --- /dev/null +++ b/files/it/creare_un_microsommario/index.html @@ -0,0 +1,209 @@ +--- +title: Creare un Microsommario +slug: Creare_un_Microsommario +translation_of: Archive/Mozilla/Creating_a_microsummary +--- +<p> + Un generatore di microsommari è un insieme di istruzioni per creare un microsommario a partire dal contenuto di un documento. Le pagine possono essere collegate ai generatori tramite <code><link rel="microsummary"></code>, che va inserito nell'elemento <code><head></code>. I generatori possono anche essere scaricati in maniera indipendente e installati dagli utenti, se questi scrivono una lista di pagine alla quale i generatori devono essere associati.</p> +<p> + In questo articolo creeremo un generatore di microsommario per la <a class="external" href="http://www.spreadfirefox.com/">home page di SpreadFirefox</a> che mostra il numero di download del browser con l'etichetta <cite>Fx downloads</cite>; per esempio: <cite>174475447 Fx downloads</cite>.</p> +<p> + Costruiremo poi il foglio stile <a href="it/XSLT">XSLT</a> che converte la pagina in un microsommario e impareremo a specificare che il generatore si applica proprio a quella pagina; infine impareremo a preparare il generatore per il download e l'installazione.</p> +<p> + In ogni passo della creazione del foglio stile, ciò che viene aggiunto rispetto all'esempio precedente è in <b>grassetto</b> per facilitarne l'identificazione.</p> +<h2 id="Iniziare" name="Iniziare"> + Iniziare</h2> +<p> + I generatori si presentano come documenti <a href="it/XML">XML</a>, la cui radice è l'elemento <code><generator></code> e il namespace è <cite><a class="external" href="http://www.mozilla.org/microsummaries/0.1" rel="freelink">http://www.mozilla.org/microsummaries/0.1</a></cite>. Per iniziare a costruire il generatore, creiamo un nuovo file di testo vuoto, poi inseriamo la dichiarazione XML e l'elemento radice:</p> +<pre class="eval"><b><?xml version="1.0" encoding="UTF-8"?></b> +<b><generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>"></b> +<b></generator></b> +</pre> +<h2 id="Il_nome" name="Il_nome"> + Il nome</h2> +<p> + Ogni generatore dovrebbe essere dotato di attributi <code>name</code>, che forniscono descrizioni arbitrarie dei microsommari. I nomi dovrebbero essere abbastanza descrittivi da dare all'utente un'idea di quali informazioni vengono fornite dal microsommario. Siccome il nostro generatore creerà dei microsommari che mostrano il conteggio dei download di Firefox, lo chiameremo "Download di Firefox":</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + <b>name="Download di Firefox"</b>> +</generator> +</pre> +<h2 id="Creare_un_foglio_stile_XSLT" name="Creare_un_foglio_stile_XSLT"> + Creare un foglio stile XSLT</h2> +<p> + I generatori devono includere un foglio stile XSLT (o trasformazione XSLT), che trasforma il contenuto della pagina in un microsommario. XSLT è un potente linguaggio per trasformare i documenti in rappresentazioni diverse delle stesse informazioni.</p> +<p> + Aggiungiamo quindi il foglio stile includendolo in un elemento <code><template></code>:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + name="Download di Firefox"> + <b><template></b> + <b><transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"></b> + <b></transform></b> + <b></template></b> +</generator> +</pre> +<p> + Si noti che, mentre i generatori di microsommari includono del codice XSLT arbitrario, compreso codice che produca un output formattato, Firefox attualmente visualizza soltanto una versione di puro testo dell'output XSLT.</p> +<h2 id="Specificare_il_tipo_di_output" name="Specificare_il_tipo_di_output"> + Specificare il tipo di output</h2> +<p> + Siccome il foglio stile genera un sommario testuale, dovremmo indicarlo nell'elemento <code><output></code>:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + name="Download di Firefox"> + <template> + <transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"> + <b><output method="text"/></b> + </transform> + </template> +</generator> +</pre> +<h2 id="Utilizzare_un_semplice_.3Ctemplate.3E" name="Utilizzare_un_semplice_.3Ctemplate.3E"> + Utilizzare un semplice <code><template></code></h2> +<p> + L'elaboratore XSLT trasforma i documenti comparando ogni elemento <code><template></code> presente nel foglio stile con un insieme di nodi del documento. Quando trova un attributo <code>match</code>, dell'elemento <code><template></code>, l'elaboratore esegue le trasformazioni specificate nel contenuto dell'elemento stesso.</p> +<p> + Questo è un meccanismo potente, perchè permette di attraversare l'albero di un documento, generando ricorsivamente un output basato sui contenuti. Ma, per gli scopi di un microsommario per la pagina di Spread Firefox, necessitiamo di un solo <code><template></code> che corrisponde al nodo radice del documento e che viene processato una volta sola:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + name="Download di Firefox"> + <template> + <transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"> + <output method="text"/> + <b><template match="/"></b> + <b></template></b> + </transform> + </template> +</generator> +</pre> +<h2 id="Inserire_il_conteggio_dei_download" name="Inserire_il_conteggio_dei_download"> + Inserire il conteggio dei download</h2> +<p> + Per inserire il conteggio dei download nell'output del foglio stile, occorre aggiungere un elemento <code><value-of></code> al template il cui attributo <code>select</code> contiene un'espressione <a href="it/XPath">XPath</a> che punta al nodo che contiene il numero da visualizzare.</p> +<p> + XPath è un linguaggio che serve a identificare i nodi nei documenti HTML o XML. Contiene anche alcuni funzioni basilari per la manipolazione dei nodi e del loro contenuto. Il modo più semplice per ottenere una espressione XPath che punti al nodo desiderato è utilizzare l'estensione <a class="link-https" href="https://addons.mozilla.org/firefox/1095/">XPath Checker</a>.</p> +<p> + Quindi installiamo l'estensione e riavviamo Firefox quando l'installazione è completa. Andiamo quindi alla home page di Spread Firefox, troviamo il conteggio dei download (un numero grande nella colonna di destra), clicchiamo col tasto detro del mouse su tale informazione e selezioniamo <cite>View XPath</cite> nel menù a comparsa.</p> +<p> + XPath Checker aprirà una nuova finestra. La nuova finestra contiene un campo <cite>XPath</cite> che contiene l'espressione XPath desiderata, che punta al numero di download: <cite>id('download-count')</cite>.</p> +<p> + Aggiungiamo un elemento <code><value-of></code> dentro <code><template></code>, con un attributo <code>select</code> che contiene detta espressione XPath:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + name="Download di Firefox"> + <template> + <transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"> + <output method="text"/> + <template match="/"> + <b><value-of select="id('download-count')"/></b> + </template> + </transform> + </template> +</generator> +</pre> +<h2 id="Inserire_del_testo" name="Inserire_del_testo"> + Inserire del testo</h2> +<p> + Per inserire l'etichetta <cite>Fx downloads</cite> nel microsommario, occorre aggiungere un elemento <code><text></code> in <code><template></code>, il cui contenuto sarà il testo che si desidera inserire.</p> +<p> + Aggiungiamo quindi un elemento <code><text></code>, il cui contenuto è <cite>Fx downloads</cite>:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + name="Download di Firefox"> + <template> + <transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"> + <output method="text"/> + <template match="/"> + <value-of select="id('download-count')"/> + <b><text> download</text></b> + </template> + </transform> + </template> +</generator> +</pre> +<p> + Si noti che lo spazio bianco tra i tag XSLT non viene incluso nell'output, diversamente da quanto accade in HTML, dove invece tutti gli spazi vengono riuniti in un singolo spazio, quindi facciamo attenzione a inserire uno spazio prima della frase "download" per separarla dal numero.</p> +<p> + Con questo, abbiamo terminato di scrivere il foglio stile XSLT che converte la pagina principale di Spread Firefox in un microsommario.</p> +<h2 id="Specificare_a_quale_pagina_di_riferisce_il_generatore" name="Specificare_a_quale_pagina_di_riferisce_il_generatore"> + Specificare a quale pagina di riferisce il generatore</h2> +<p> + Ora che abbiamo terminato il foglio stile, dobbiamo specificare a quale pagina si applica. Se fossimo i webmaster di Spread Firefox, sarebbe sufficiente inserire un riferimento al generatore nella pagina stessa aggiungendo un tag <code><link rel="microsummary"></code> nella sezione <code><head></code> del documento:</p> +<pre class="eval"><head> + ... + <b><link rel="microsummary" href="path/to/our/generator.xml"></b> +</head> +</pre> +<p> + Siccome però non siamo i webmaster di quel sito, possiamo specificare la pagina al quale si applica il generatore dentro al generatore stesso e poi renderlo disponibile per il download e l'installazione. Per specificare la pagina, utilizziamo un elemento <code><pages></code>, figlio di <code><generator></code>:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" + name="Download di Firefox"> + <template> + <transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"> + <output method="text"/> + <template match="/"> + <value-of select="id('download-count')"/> + <text> download</text> + </template> + </transform> + </template> + <b><pages></b> + <b></pages></b> +</generator> +</pre> +<p> + Tale elemento può contenere una sequenza di tag <code><include></code> e <code><exclude></code> che specificano, rispettivamente, a quali pagine il generatore si applica e non si applica.</p> +<p> + Per far sì che il generatore si applichi a una pagina, si può aggiungere un elemento <code><include></code>, il cui contenuto è un'espressione regolare che corrisponde alla pagina (o alle pagine). Per far sì che il generatore invece ignori una pagina, è necessario inserire un elemento <code><exclude></code>, il cui contenuto è anch'esso un'espressione regolare.</p> +<p> + Per default i generatori non si applicano ad alcuna pagina, quindi è possibile elencare esplicitamente a quali pagine si applica e non è necessario escludere altre pagine, a meno che non siano state precedentemente incluse.</p> +<p> + Aggiungiamo un elemento <code><include></code> che corrisponda alla home page di Spread Firefox:</p> +<pre class="eval"><?xml version="1.0" encoding="UTF-8"?> +<generator xmlns="<span class="nowiki">http://www.mozilla.org/microsummaries/0.1</span>" name="Download di Firefox"> + <template> + <transform xmlns="<span class="nowiki">http://www.w3.org/1999/XSL/Transform</span>" version="1.0"> + <output method="text"/> + <template match="/"> + <value-of select="id('download-count')"/> + <text> download</text> + </template> + </transform> + </template> + <pages> + <b><include><span class="nowiki">http://(www\.)?spreadfirefox\.com/(index\.php)?</span></include></b> + </pages> +</generator> +</pre> +<h2 id="Rendere_il_generatore_disponibile_per_il_download" name="Rendere_il_generatore_disponibile_per_il_download"> + Rendere il generatore disponibile per il download</h2> +<p> + Ora che il nostro generatore si applica alla home page di Spread Firefox, l'unica cosa rimasta da fare è renderlo scaricabile. Per fare questo, dobbiamo caricarlo in rete e creare un link <a href="it/JavaScript">JavaScript</a> in una qualche pagina che chiami il metodo di Firefox <code>window.sidebar.addMicrosummaryGenerator()</code> per scaricarlo e installarlo.</p> +<p> + Per esempio, se carichiamo il generatore all'indirizzo <a class="external" href="http://people.mozilla.com/~myk/microsummaries/tutorial/sfx-generator.xml" rel="freelink">http://people.mozilla.com/~myk/micro...-generator.xml</a> e vogliamo che gli utenti possano installarlo da <a class="external" href="http://people.mozilla.com/~myk/microsummaries/tutorial/index.html" rel="freelink">http://people.mozilla.com/~myk/micro...ial/index.html</a>, possiamo aggiungere il seguente codice alla pagina <cite>index.html</cite>:</p> +<pre class="eval"><b><a href="javascript:window.sidebar.addMicrosummaryGenerator('<span class="nowiki">http://people.mozilla.com/~myk/microsummaries/tutorial/sfx-generator.xml</span>')">Installa il microsommario della pagina principale di Spread Firefox!</a></b> +</pre> +<p> + Cliccando sul link, si genera un errore JavaScript sui browser che non supportano i microsommari, pertanto si può migliorarlo controllando se i microsommari sono supportati. Potremmo farlo con il codice seguente:</p> +<pre class="eval"><b><script></b> +<b> const warning = "Spiacente, ma è necessario un browser che supporti i microsommari, come Firefox 2.0";</b> +<b> function addGenerator(url) {</b> +<b> if (typeof window.sidebar == "object" &&</b> +<b> typeof window.sidebar.addMicrosummaryGenerator == "function")</b> +<b> window.sidebar.addMicrosummaryGenerator(url);</b> +<b> else</b> +<b> alert(warning);</b> +<b> }</b> +<b></script></b> +<b><a href="javascript:addGenerator('<span class="nowiki">http://people.mozilla.com/~myk/microsummaries/tutorial/sfx-generator.xml</span>')">Installa il microsommario della pagina principale di Spread Firefox!</a></b> +</pre> +<p> + </p> +<h2 id="Conclusione" name="Conclusione"> + Conclusione</h2> +<p> + Abbiamo creato un generatore di microsommari che, una volta installato, mostra il numero attuale di download di Firefox e seleziona il microsommario dal menu a discesa <cite>Summary</cite> nella finestra <cite>Add Bookmark</cite>.</p> +<p> + Per ulteriori informazioni sui microsommari, si veda <a class="external" href="http://wiki.mozilla.org/Microsummaries">Microsummaries home page</a> (EN).</p> |