[visualizza] [modifica] Documentazione


Descrizione modifica

Il template trasforma il numero di una pagina cartacea in link alla pagina djvu corrispondente (in nsPagina e nsIndice); quando transcluso su ns0, il link punta automaticamente al capitolo e alla pagina in ns0 appoggiandosi sul Modulo:Dati/ dell’opera, se presente e correttamente compilato dall’apposito tool.

Aggiungendo un quarto parametro con il valore nsPage viene dovunque forzato il link a nsPage.

Uso

Ricopiare il testo sottostante e modificare le parole in blu in base alle esigenze.
{{Pg|numero pagina libro|testo da visualizzare come link (opzionale)|nome base pagina Indice (opzionale)|forza link a nsPagina (con il valore nsPage)}}


Casi speciali modifica

Numerazioni multiple di pagina sullo stesso Indice
In alcuni casi il file Indice riunisce volumi diversi, ognuno dei quali con una propria numerazione che riparte da pag. 1; in queste circostanze il solo numero pagina non basta a identificare una pagina del file djvu. Al momento il Modulo:Dati/ dell’opera va modificato manualmente, aggiungendo un suffisso .0, .1, ... a tutti i numeri pagina rispettivamente del volume 1, volume 2....; vedi esempio in Modulo:Dati/Istorie dello Stato di Urbino.djvu.
La soluzione migliore per questi casi è però quella di dividere il file Indice in più file Indice, uno per volume, ciascuno con la sua numerazione pagine univoca.
vari testi/sezioni/capitoli indipendenti che iniziano nella stessa pagina
Accade nelle raccolte di testi/sezioni/capitoli molto brevi. In questo caso non vi è una relazione univoca fra sezione/capitolo e numero pagina del libro e il modulo Pg aggancia la pagina all’ultimo delle sezioni/capitoli che iniziano nella pagina. In questi casi, il template Pg va usato solo per linkare l'utlimo sezione/capitolo; per i precedenti va invece usato {{LinkPagineIndice}} che permette di indicare manualmente il numero di pagina djvu e il nome del capitolo. Vedi alcuni esempi nell'indice originale di Le cento novelle antiche, da pag. 137 a pag. 144.
riferimento a pagine Indice diverse da quella di default
In alcune edizioni i numeri pagina si riferiscono a diversi volumi inseriti come indici separati (esempio: Decameron, che transclude da Indice:Boccaccio - Decameron I.djvu e Indice:Boccaccio - Decameron II.djvu. In questo caso viene utilizzato il terzo parametro opzionale in cui va inserito in modo esplicito il PAGENAME della pagina Indice appropriata (ossia il nome pagina privo del namespace: Indice:Boccaccio - Decameron I.djvu -> Boccaccio - Decameron I.djvu).
Poichè i nomi delle pagine Indice spesso sono lunghi e complessi e potrebbero "oscurare" il codice rendendo difficile la rilettura e correzione, è stata creata la possibilità di utilizzare delle abbreviazioni, integrate in un dizionario dentro Modulo:Pg. Le prime abbreviazioni inserite sono quelle elencate; in seguito ne sono state aggiunte molte altre.
  • dec1 -> Boccaccio - Decameron I.djvu
  • dec2 -> Boccaccio - Decameron II.djvu
  • polo1 -> Polo - Il milione, Pagani, Firenze 1827, I.djvu
  • polo2 -> Polo - Il milione, Pagani, Firenze 1827, II.djvu

Errori modifica

Se il numero pagina non produce un link (es. per inesistenza della pagina nel libro) verrà visualizzato un doppio punto interrogativo a fianco del numero, e alla pagina che contiene l'errore verrà assegnata la categoria Categoria:Pagine con errori in Pg. Questo avviene quando il Moduli Dati non esiste o non è aggiornato.

Approfondimento modifica

Il template chiama alcune funzioni di Modulo:Pg. Vedi anche Wikisource:Lua.