name=Dimostrazione UN HTML
section_Title=titoli delle sezioni
section_text=capitoli
document_text=documenti completi
document=Documento
textdate=data di pubblicazione\:
textnumpages=numero di pagine\:
textsource=fonte rif.\:

shortDescription=Le biblioteche sullo sviluppo umanitario rappresentano una vasta collezione di informazioni pratiche volte a contribuire alla riduzione della povertà, all'aumento del potenziale umano e a fornire un'istruzione pratica e utile per tutti. Questo sottoinsieme contiene circa 25 pubblicazioni - documenti, relazioni e articoli di periodici - in vari settori dello sviluppo umano, dalle pratiche agricole alle politiche economiche, dall'acqua e i servizi igienico-sanitari alla società e la cultura, dall'istruzione alla produzione manifatturiera, dalla mitigazione dei disastri alle microimprese.

description0=<p>Gli editori di questa collezione sono Human Info NGO, HumanityCD Ltd e le organizzazioni partecipanti. Contattaci all'indirizzo Humanitarian and Development Libraries Project, Oosterveldiaan 196, B-2610 Anversa, Belgio, Tel. 32-3-448.05.54, Fax 32-3-449.75.74, e-mail <a href=mailto\:humanity@humaninfo.org>humanity@humaninfo.org</a>.

description1=<h3>Come funziona la collezione</h3><p>La collezione DLS è piuttosto complessa. Se sei alle prime armi, potresti preferire dare prima un'occhiata ad altre collezioni (ad esempio <a href="library/collection/wrdpdf-e/page/about">Dimostrazione Word e PDF</a>, o gli <a href="library/collection/gsarch-e/page/about">Archivi Greenstone</a>, o la <a href="library/collection/image-e/page/about">Collezione immagini semplici</a>).</p>

description2=<p>Il file di configurazione della collezione, <tt>collectionConfig.xml</tt>, come tutti i file di configurazione delle collezioni, inizia con l'elemento metadati <i>creator</i> che fornisce l'indirizzo e-mail del creatore della collezione e un altro metadato (“public”) che determina se la collezione apparirà nella home page dell'installazione Greenstone. Si noti che impostando “public” su “false” si rimuove solo dalla home page; sarà comunque accessibile nella libreria a chiunque conosca l'URL della collezione.

description3=<p><b>Plugin</b>. Le righe “plugin” nel file di configurazione della collezione indicano i plugin utilizzati dalla collezione. I documenti nella collezione DLS sono in formato HTML, quindi è necessario includere <i>HTMLPlugin</i>. L'opzione <i>description_tags</i> elabora i tag nel testo che definiscono le sezioni e i titoli delle sezioni come descritto di seguito.

description4=<p>Gli altri plugin, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin e DirectoryPlugin</i>, sono utilizzati da Greenstone per scopi interni e sono standard in quasi tutte le collezioni.

description5=<p><b>Indici ricercabili</b>. Il blocco di righe che inizia con <i>indici</i> specifica quali indici ricercabili saranno disponibili. In questa collezione ce ne sono tre: puoi vederli quando apri il menu “Cerca” nella <a href="library/collection/dls-e/search/TextQuery">pagina di ricerca</a> della collezione. Il primo indice si chiama “capitoli”, il secondo “titoli delle sezioni” e il terzo “documenti interi”. I nomi di questi tre indici sono dati da tre proprietà (section_text, section_Title e document_text) nel file traducibile <tt>collectionConfig.properties</tt> che si trova nella sottocartella <tt>resources</tt> della collezione.

description6=<p>Il contenuto degli indici, ovvero la specifica di ciò che verrà cercato, è definito dalla riga <i>indexes</i> all'inizio di questo blocco. Questo specifica tre indici, due a livello di sezione (che iniziano con <i>section\:</i>) e uno a livello di documento (che inizia con <i>document\:</i>). La differenza è che una query composta da più parole corrisponderà solo a un indice a livello di sezione se tutti i termini della query compaiono nella stessa sezione, mentre corrisponderà a un indice a livello di documento se i termini compaiono in qualsiasi punto del documento (che in genere comprende diverse sezioni). Il primo e il terzo indice sono <i>section\:text</i> e <i>document\:text</i>, mentre <i>\:text</i> significa che verrà cercato il testo completo delle sezioni e dei documenti rispettivamente. Il secondo è <i>section\:Title</i>, che significa che verranno cercati i metadati <i>Title</i>, in questo caso i titoli delle sezioni (anziché i titoli dei documenti). I tre indici appaiono nell'ordine in cui sono specificati nella riga <i>indexes</i>.</p>

description7=<p><b>Classificatori</b>. Il blocco di righe etichettato <i>classify</i> definisce gli indici di navigazione, chiamati “classificatori” in Greenstone. Ce ne sono quattro, corrispondenti ai quattro pulsanti sulla barra di navigazione nella parte superiore di ogni pagina della collezione (ad esempio la <a href="library/collection/dls-e/search/TextQuery">pagina di ricerca</a>)\: <i>argomenti</i>, <i>titoli</i>, <i>organizzazioni</i> e <i>howto</i>. Il pulsante <i>ricerca</i> è il primo, seguito dai quattro classificatori, in ordine.

description8=<p>Il primo classificatore fornisce l'accesso per argomento. Si tratta di un classificatore <i>Hierarchy</i> la cui gerarchia è definita nel file <tt>etc/dls.Subject.txt</tt> (l'argomento <i>hfile</i>); questo file è descritto più avanti. Questo classificatore si basa sui metadati <i>dls.Subject</i> e, quando più libri compaiono in una foglia della gerarchia, vengono ordinati in base ai metadati <i>dls.Title</i> (come si può vedere aprendo il browser dei classificatori <tt>CL1.4.1</tt>). Il secondo classificatore consente l'accesso per titolo. Si tratta anche di un classificatore <i>Hierarchy</i>, questa volta basato sui metadati <i>dls.AZList</i>, la cui gerarchia è definita in <tt>etc/dls.AZList.txt</tt>. Questo file è descritto di seguito. Il terzo fornisce l'accesso per organizzazione: è un classificatore <i>List</i> basato sui metadati <i>dls.Organization</i>. L'opzione <i>-bookshelf_type always</i> crea una nuova libreria per ogni organizzazione, anche se solo un documento appartiene a quella categoria. Il quarto fornisce l'accesso per testo “Howto”: è un classificatore <i>List</i> basato sui metadati <i>dls.Keyword</i>. L'opzione <i>-bookshelf_type never</i> impedisce la creazione di librerie anche se due documenti condividono le stesse parole chiave.

description9=<p><b>Immagini di copertina</b>. Greenstone cerca un'immagine di copertina per ogni documento, il cui nome è lo stesso del documento ma con estensione <i>.jpg</i>. Questa immagine è associata al documento e può essere visualizzata nella pagina del documento (vedi sotto). Le immagini di copertina possono essere disattivate impostando il flag -no_cover_image per ogni plugin.

description10=<p><b>Istruzioni di formato</b>. Gli elementi <i>format</i> (elementi XML &lt;format;&gt;, &lt;browse&gt;, &lt;search&gt; e &lt;display&gt;), chiamati “istruzioni di formato”, regolano la modalità di visualizzazione delle varie parti della collezione. L'istruzione di formato <i>VList</i> si applica agli elenchi di elementi visualizzati verticalmente, come gli elenchi di titoli, argomenti e organizzazioni e il sommario dei documenti di destinazione. È sovrascritta per l'elenco dei risultati della ricerca dall'istruzione di formato <i>SearchVList</i> e anche per il classificatore <i>Howto</i> dall'istruzione <i>CL4VList</i> (CL4 specifica il quarto classificatore).</p>

description11=<p>L'istruzione <i>DocumentText</i> regola la formattazione del testo del documento, con i metadati <i>Title</i> ([<i>Title</i>]) in formato HTML <i>heading</i> seguiti dal testo del documento [<i>Text</i>]. Per impostazione predefinita, le immagini di copertina vengono visualizzate con ogni documento (<i>DocumentImages</i>) e sono disponibili i pulsanti <i>DocumentButtons</i>: i pulsanti <i>Espandi testo, Espandi contenuto, Stacca</i> e <i>Evidenzia</i> vengono visualizzati con ogni documento.

description12=<p>Greenstone 3 utilizza XML per le dichiarazioni di formato, consentendo ai bibliotecari con esperienza XML di comprendere e utilizzare più facilmente le dichiarazioni di formato rispetto a Greenstone 2, che funzionava con un modo personalizzato di specificare le dichiarazioni di formato. Per ulteriori informazioni sulla comprensione delle istruzioni di formato e sulla scrittura delle proprie istruzioni di formato per le collezioni, consultare <a href="http\://wiki.greenstone.org/doku.php?id=en\:user\:gs3_format_statements">Istruzioni di formato Greenstone 3</a> sul wiki Greenstone.

description13=<p><b>Metadati a livello di collezione</b>. Gli elementi <i>&lt;displayItem&gt;</i> sotto il livello superiore <i>&lt;displayItemList&gt;</i> nel file di configurazione sono standard in tutte le collezioni Greenstone. Forniscono informazioni generali sulla collezione, definendone il nome e una descrizione che appare nella sua home page. Il testo della descrizione (definito nei file traducibili <tt>resources/collectionConfig.properties</tt>) è visibile nella home page della collezione DLS (questo testo ne fa parte).</p>

description14=<p><b>Traduzioni linguistiche</b>. Nel file di configurazione della collezione, le righe simili a <tt>&lt;displayItem assigned="true" dictionary="collectionConfig" key="..." name="..."/&gt;</tt> consentono la traduzione dei metadati a livello di collezione, definiti nei file di proprietà <tt>resources/collectionConfig.properties</tt> e possono essere tradotti nella stessa posizione, ad esempio creando versioni in francese e spagnolo (rispettivamente in <tt>resources/collectionConfig_fr.properties</tt> e <tt>resources/collectionConfig_es.properties</tt>). Si consiglia ai traduttori di utilizzare il sistema GTI (Greenstone Translation Interface) se desiderano contribuire con traduzioni a Greenstone utilizzabile da tutti, come le traduzioni delle collezioni demo di Greenstone e delle collezioni di esempio documentate. I file delle proprietà consentono l'uso di caratteri accentati (ad esempio, il carattere francese <i>é</i>). I file sono in UTF-8 e questi caratteri sono rappresentati da sequenze multibyte (&lt;C3&gt;&lt;A9&gt; in questo caso). In alternativa, potrebbero essere rappresentati dai loro nomi di entità HTML (come <i>& eacute ;</i>). Non fa alcuna differenza per come appaiono sullo schermo.

description15=<p><b>Tag di descrizione</b>. I tag di descrizione riconosciuti da <i>HTMLPlugin</i> vengono inseriti nel testo sorgente HTML dei documenti per definire dove iniziano e finiscono le sezioni e per specificare i titoli delle sezioni. Hanno questo aspetto\: <pre> &lt;!-- &lt;Section&gt; &lt;Description&gt; &lt;Metadata name="Title"&gt; Realizzare i diritti umani per i poveri\: Strategie per il raggiungimento degli obiettivi internazionali di sviluppo &lt;/Metadata&gt; &lt;/Description&gt; --&gt; (il testo della sezione va qui) &lt;!-- &lt;/Section&gt; --&gt; </pre> I marcatori &lt;!-- ... --&gt; servono a garantire che questi tag siano contrassegnati come commenti in HTML e quindi non influenzino la formattazione del documento. Nella parte <i>Description</i> è possibile specificare altri tipi di metadati, ma ciò non viene fatto per lo stile della collezione che stiamo descrivendo qui. La stessa identica specifica (compresi i marcatori &lt;!-- ... --&gt;) può essere utilizzata anche nei documenti Word.

description16=<p><b>File metadati</b>. I metadati di tutti i documenti della collezione DLS sono forniti in file metadata.xml, uno per ogni cartella di documenti. In questa collezione, <tt>import/r0087e</tt> è il file <tt>metadata.xml</tt> per un libro -- <i>Income generation and money management\: training women as entrepreneurs</i> -- che è un blocco di circa dieci righe racchiuso tra i tag &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. Definisce i metadati <i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> e <i>dls.AZList</i>. È possibile specificare più di un valore per ogni elemento di metadati. Ad esempio, questo libro ha due classificazioni dls.Subject. Entrambe sono memorizzate come valori di metadati per questo particolare documento (perché è specificato <i>mode=accumulate</i>; l'alternativa, e l'impostazione predefinita, è <i>mode=override</i>).</p>

description17=<p><b>File di gerarchia</b>. I file di gerarchia contengono una serie di righe, ciascuna delle quali contiene tre elementi. Il primo elemento è una stringa di testo che viene confrontata con i metadati presenti nel file <i>metadata.xml</i> descritto sopra. Il secondo elemento è un numero che definisce la posizione nella gerarchia. Il terzo elemento è una stringa di testo che descrive il nodo della gerarchia nelle pagine web generate da Greenstone.

description18=<p>Ad esempio, di seguito sono riportate tre righe dal file della gerarchia degli argomenti <tt>etc/dls.Subject.txt</tt>. \n\
<pre> “Allevamento e lavorazione dei prodotti animali ” \n\
7 “Allevamento e lavorazione dei prodotti animali ” “Allevamento e lavorazione dei prodotti animali|Bovini ” \n\
7.1 “Bovini ” “Allevamento e lavorazione dei prodotti animali|Altri animali (micro-bestiame, animali poco conosciuti, bachi da seta, rettili, rane, lumache, selvaggina, ecc.) ” \n\
7.2 “Altri animali (micro-bestiame, animali poco conosciuti, bachi da seta, rettili, rane, lumache, selvaggina, ecc.) ” \n\
</pre> \n\
</p>

description19=<p>Queste tre righe definiscono una libreria di primo livello (alla posizione 7), intitolata “Allevamento e lavorazione dei prodotti animali”, con due librerie sottostanti, intitolate rispettivamente ‘Bovini’ e “Altri animali (micro-bestiame, animali poco conosciuti, bachi da seta, rettili, rane, lumache, selvaggina, ecc.)”.</p>

description20=<p>In questo caso, le prime stringhe (e quindi le voci nei file metadata.xml) contengono i valori dell'intera gerarchia. I livelli nella gerarchia sono separati da “|”. Potrebbero essere utilizzati direttamente da un classificatore <i>Hierarchy</i> senza l'uso del file di gerarchia. Tuttavia, in tal caso le voci sarebbero ordinate in ordine alfabetico, anziché secondo l'ordine speciale definito dal file.

description21=<p>Il file di gerarchia <tt>etc/dls.AZList.txt</tt> utilizzato dal classificatore dei titoli contiene una struttura simile. Normalmente, un browser di titoli utilizzerebbe un classificatore <i>List</i> (o <i>AZList</i>). In questo caso, vogliamo predefinire i raggruppamenti dalla A alla Z e includere una voce separata per i periodici, come si può vedere nel browser dei classificatori <a href="library/collection/dls-e/browse/CL2/7">qui</a>.</p>
