Aiuto:Come gestire le pagine Modulo:Dati

- Aiuto

Le pagine Modulo:Dati contengono una serie di informazioni sulla struttura dei libri (basati su una pagina Indice) utilizzati da template che richiamano script Lua (nel ns:Modulo).

Il nome della pagina Modulo:Dati

Le pagine prendono il nome dal nome dell'Indice; il nome si ottiene sostituendo "Indice:" con "Modulo:Dati/". Ad esempio, a Indice:Georgiche.djvu è collegata la pagina Modulo:Dati/Georgiche.djvu.

Una piccola icona: , a destra del nome della pagina dell'Indice, consente di arrivare direttamente alla pagina Modulo:Dati collegata alla pagina Indice (anche se non esiste ancora).

Come compilare la pagina Modulo:Dati

La compilazione della pagina avviene via javascript. Il tool è attivato cliccando sul link ModuloDati, che compare nel menu verticale a sinistra, gruppo Strumenti, qualche secondo dopo essere entrati in una pagina nsIndice

Attenzione

lo script viene caricato insieme agli altri Strumenti par la rilettura; deve essere quindi attivato il gadget relativo.

Quando e come modificare la pagina Modulo:Dati

quando

la pagina Modulo:Dati di Indice andrebbe modificata ogni qual volta viene modificato pagelist o qualsiasi elemento di Sommario.

come

dopo salvate le modifiche alla pagina Indice, cliccare il link ModuloDati nel menu verticale.

Requisiti della pagina Indice

I dati vengono ottenuti dall'output del tag pagelist e dai template {{Indice sommario}}. Il sistema quindi non funziona, o funziona in modo imprevedibile, in caso di mancata compilazione del tag pagelist o di mancata o erronea compilazione del Sommario.

Attenzione

perchè il collegamento fra pagina del libro e pagina djvu funzioni, è necessario che tutti gli identificatori delle pagine del libro siano diversi. Identificatori identici possono essere utilizzati per le pagine che non hanno interesse (es. le pagine vuote possono essere identificate tutte con il carattere -).

Esempio

per creare una relazione esatta fra figure fuori testo e pagina djvu, non impostare in pagelist il termine "Figura" per tutte le figure, ma piuttosto impostare "Figura 1", "Figura 2"....; con questa avvertenza, una chiamata {{Pg|Figura 1}} trasformerà il testo in un link funzionante.

Come aggiungere la documentazione

In modalità visualizzazione, quando la documentazione manca, compare un invito a aggiungere la documentazione. Volendo aggiungerla, seguire il link e scrivere nella pagina {{Documentazione pagina dati}}. Comparirà un breve testo e un link alla pagina indice collegata (utile per tornare indietro).

Template che usano Moduli:Dati

{{Pg}}

trasforma un numero pagina del libro (anche un identificatore non numerico, purchè unico) in un link alla pagina djvu corrispondente in nsPagina e nsIndice; in un link alla sezione/capitolo corretti quando viene transcluso in ns0. Nota: il link alla sezione/capitolo potrebbe essere errato nel caso che la corrispondenza pagina-capitolo non sia univoca, ossia nei casi in cui la stessa pagina di un libro contenga più di un capitolo. Il problema non è ancora stato risolto. :-(

....