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 humanity@humaninfo.org. description1=
La collezione DLS è piuttosto complessa. Se sei alle prime armi, potresti preferire dare prima un'occhiata ad altre collezioni (ad esempio Dimostrazione Word e PDF, o gli Archivi Greenstone, o la Collezione immagini semplici).
description2=Il file di configurazione della collezione, collectionConfig.xml, come tutti i file di configurazione delle collezioni, inizia con l'elemento metadati creator 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=
Plugin. 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 HTMLPlugin. L'opzione description_tags elabora i tag nel testo che definiscono le sezioni e i titoli delle sezioni come descritto di seguito. description4=
Gli altri plugin, GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin e DirectoryPlugin, sono utilizzati da Greenstone per scopi interni e sono standard in quasi tutte le collezioni. description5=
Indici ricercabili. Il blocco di righe che inizia con indici specifica quali indici ricercabili saranno disponibili. In questa collezione ce ne sono tre: puoi vederli quando apri il menu “Cerca” nella pagina di ricerca 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 collectionConfig.properties che si trova nella sottocartella resources della collezione. description6=
Il contenuto degli indici, ovvero la specifica di ciò che verrà cercato, è definito dalla riga indexes all'inizio di questo blocco. Questo specifica tre indici, due a livello di sezione (che iniziano con section\:) e uno a livello di documento (che inizia con document\:). 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 section\:text e document\:text, mentre \:text significa che verrà cercato il testo completo delle sezioni e dei documenti rispettivamente. Il secondo è section\:Title, che significa che verranno cercati i metadati Title, in questo caso i titoli delle sezioni (anziché i titoli dei documenti). I tre indici appaiono nell'ordine in cui sono specificati nella riga indexes.
description7=Classificatori. Il blocco di righe etichettato classify 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 pagina di ricerca)\: argomenti, titoli, organizzazioni e howto. Il pulsante ricerca è il primo, seguito dai quattro classificatori, in ordine. description8=
Il primo classificatore fornisce l'accesso per argomento. Si tratta di un classificatore Hierarchy la cui gerarchia è definita nel file etc/dls.Subject.txt (l'argomento hfile); questo file è descritto più avanti. Questo classificatore si basa sui metadati dls.Subject e, quando più libri compaiono in una foglia della gerarchia, vengono ordinati in base ai metadati dls.Title (come si può vedere aprendo il browser dei classificatori CL1.4.1). Il secondo classificatore consente l'accesso per titolo. Si tratta anche di un classificatore Hierarchy, questa volta basato sui metadati dls.AZList, la cui gerarchia è definita in etc/dls.AZList.txt. Questo file è descritto di seguito. Il terzo fornisce l'accesso per organizzazione: è un classificatore List basato sui metadati dls.Organization. L'opzione -bookshelf_type always 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 List basato sui metadati dls.Keyword. L'opzione -bookshelf_type never impedisce la creazione di librerie anche se due documenti condividono le stesse parole chiave. description9=
Immagini di copertina. Greenstone cerca un'immagine di copertina per ogni documento, il cui nome è lo stesso del documento ma con estensione .jpg. 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=
Istruzioni di formato. Gli elementi format (elementi XML <format;>, <browse>, <search> e <display>), chiamati “istruzioni di formato”, regolano la modalità di visualizzazione delle varie parti della collezione. L'istruzione di formato VList 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 SearchVList e anche per il classificatore Howto dall'istruzione CL4VList (CL4 specifica il quarto classificatore).
description11=L'istruzione DocumentText regola la formattazione del testo del documento, con i metadati Title ([Title]) in formato HTML heading seguiti dal testo del documento [Text]. Per impostazione predefinita, le immagini di copertina vengono visualizzate con ogni documento (DocumentImages) e sono disponibili i pulsanti DocumentButtons: i pulsanti Espandi testo, Espandi contenuto, Stacca e Evidenzia vengono visualizzati con ogni documento. description12=
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 Istruzioni di formato Greenstone 3 sul wiki Greenstone. description13=
Metadati a livello di collezione. Gli elementi <displayItem> sotto il livello superiore <displayItemList> 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 resources/collectionConfig.properties) è visibile nella home page della collezione DLS (questo testo ne fa parte).
description14=Traduzioni linguistiche. Nel file di configurazione della collezione, le righe simili a <displayItem assigned="true" dictionary="collectionConfig" key="..." name="..."/> consentono la traduzione dei metadati a livello di collezione, definiti nei file di proprietà resources/collectionConfig.properties e possono essere tradotti nella stessa posizione, ad esempio creando versioni in francese e spagnolo (rispettivamente in resources/collectionConfig_fr.properties e resources/collectionConfig_es.properties). 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 file sono in UTF-8 e questi caratteri sono rappresentati da sequenze multibyte (<C3><A9> in questo caso). In alternativa, potrebbero essere rappresentati dai loro nomi di entità HTML (come & eacute ;). Non fa alcuna differenza per come appaiono sullo schermo. description15=
Tag di descrizione. I tag di descrizione riconosciuti da HTMLPlugin 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\:
<!-- <Section> <Description> <Metadata name="Title"> Realizzare i diritti umani per i poveri\: Strategie per il raggiungimento degli obiettivi internazionali di sviluppo </Metadata> </Description> --> (il testo della sezione va qui) <!-- </Section> -->I marcatori <!-- ... --> servono a garantire che questi tag siano contrassegnati come commenti in HTML e quindi non influenzino la formattazione del documento. Nella parte Description è 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 <!-- ... -->) può essere utilizzata anche nei documenti Word. description16=
File metadati. I metadati di tutti i documenti della collezione DLS sono forniti in file metadata.xml, uno per ogni cartella di documenti. In questa collezione, import/r0087e è il file metadata.xml per un libro -- Income generation and money management\: training women as entrepreneurs -- che è un blocco di circa dieci righe racchiuso tra i tag <FileSet> ... </FileSet>. Definisce i metadati dls.Title, dls.Language, dls.Subject e dls.AZList. È 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 mode=accumulate; l'alternativa, e l'impostazione predefinita, è mode=override).
description17=File di gerarchia. 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 metadata.xml 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=
Ad esempio, di seguito sono riportate tre righe dal file della gerarchia degli argomenti etc/dls.Subject.txt. \n\
“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\\n\ description19=
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.)”.
description20=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 Hierarchy 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=
Il file di gerarchia etc/dls.AZList.txt utilizzato dal classificatore dei titoli contiene una struttura simile. Normalmente, un browser di titoli utilizzerebbe un classificatore List (o AZList). 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 qui.