Book tool/it

From Meta, a Wikimedia project coordination wiki

Jump to: navigation, search

Book tool: aiuto per principianti | aiuto per esperti | Domande frequenti | feedback (in inglese) | esplora i libri 

Libri di Wikipedia stampati

È prevista l'attivazione dell'estensione Collection su più progetti WMF; tale estensione consente la raccolta di voci e la loro conversione in formato PDF. Questa pagina ha lo scopo di guidare le comunità verso una corretta installazione dell'estensione, concentrandosi pertanto sulle varie edizioni linguistiche di Wikipedia. Per farsi un'idea di come funziona questo nuovo strumento è possibile visitare l'edizione in Simple English di Wikipedia (simple.wikipedia.org) e seguire il collegamento "Create a book" nella barra laterale.

Contents

[edit] Introduzione

Questo strumento consente agli utenti di organizzare dei gruppi di pagine personali in forma di libro. I libri possono essere:

  • modificati e strutturati in capitoli
  • resi permanenti, caricati e condivisi
  • trasformati in formato PDF (esempio)
  • esportati come Documento di Testo ODF
  • ordinati come libri stampati da PediaPress (esempio)

Consultare questo comunicato stampa Wikis Go Printable (in inglese) per maggiori informazioni sul progetto. L'estensione è stata provata sui siti *.wikibooks.org a partire dall'ottobre 2008 ed è attiva sulla Wikipedia in lingua tedesca dal 27 gennaio 2009. Ulteriori attivazioni sono previste.

Per farsi un'idea di come funziona questo nuovo strumento è possibile visitare l'edizione in Simple English di Wikipedia (simple.wikipedia.org e seguire il collegamento "Create a book" nella barra laterale.

[edit] Cose da fare

Se stai visitando questa pagina, probabilmente è perché hai saputo che sulla tua Wikipedia verrà attivata a breve questa estensione. Ci sono alcune cose da sapere in proposito e queste pagine (vedi tutte le pagine) si sforzeranno di farti da guida.

Per quanto riguarda la pagina di Feedback, è probabile che sia molto frequentata; sarà quindi necessario trovare un modo per filtrare i problemi e inoltrarne la traduzione in inglese nella pagina Feedback su Meta. Vedi la sezione #Segnalazione delle anomalie, feedback e aiuto per maggiori informazioni. Inoltre, gli utenti spesso utilizzano la pagina di discussione dell'aiuto per lasciare commenti sullo strumento stesso, non sull'aiuto. Mettere un collegamento alla pagina di feedback in testa alla pagina di discussione può risolvere il problema.

Suggerimento per i traduttori: Provate l'estensione su http://simple.wikipedia.org per capire meglio le funzioni e i concetti legati ad essa. Fate attenzione alla traduzione di "pagina", che può riferirsi sia alla pagina (o alla voce) del sito che alla pagina di un documento PDF o di un libro stampato.

Dopo aver sistemato questi elementi di base, si possono apportare delle migliorie opzionali:

[edit] Concetti di base

libro
di norma si tratta di una raccolta di pagine Wiki (eventualmente corredate di capitoli, titolo e sottotitolo); si può riferire anche a un documento PDF, un testo stampato o un libro memorizzato, tutti derivati da questo
libro temporaneo
è una raccolta di voci che esiste solo nella sessione corrente del proprio browser. L'elenco delle voci contenute nel libro temporaneo è visibile nella pagina [[Speciale:Book]].
libro memorizzato
è una raccolta di voci memorizzata, resa permanente su una normale pagina Wiki. La pagina può essere nel namespace utente([[Utente:Nome/Libri/Nome del libro]]) oppure in quello globale ([[Wikipedia:Libri/Nome del libro]]). È possibile caricare un libro memorizzato; in quel caso il libro temporaneo diventa una copia del libro memorizzato.
pagina dei libri
di norma si riferisce alla pagina di sistema [[Special:Book]] nella quale sono elencate tutte le voci di un libro temporaneo e il libro stesso può essere modificato, salvato, ordinato o esportato. Si può riferire anche a un libro memorizzato.
menu libro
È la casella "Crea un libro" nella fascia verticale sinistra dello schermo (comprende anche i collegamenti 'Aggiungi/rimuovi pagina', 'Mostra libro (N pagine)', 'Carica libro', 'Rimuovi libro', 'Aiuto sui libri')
aiuto sui libri
La pagina di aiuto principale [[Aiuto:Libri]] cui si accede dal menu
"esportazione (offline)", "stampa", "versione stampata", ...
si riferisce a una esportazione di un libro, sia in formato digitale (PDF, ODF) che fisico (libro stampato)

[edit] Modifiche della localizzazione

Fate attenzione a non sbagliare i concetti. Ad esempio: "Mostra libro (19 pagine)" può essere interpretata come un'indicazione che il file PDF sarà composto da 19 pagine anche se in realtà sarà basato su 19 voci e il libro stampato o il documento PDF avranno molte più pagine. E a cosa si riferisce il messaggio svuota libro quando è stato caricato un libro memorizzato che diventa quindi anche un libro temporaneo?

Per modificare la traduzione dei messaggi generici, applicabile a tutte le installazioni, è possibile intervenire su Translatewiki.net (ext-collection) (le modifiche verranno applicate al succesivo aggiornamento del software) mentre la personalizzazione dei messaggi per la propria Wiki si può fare sulla pagina [[Special:Allmessages]] (il filtro "coll-*" consente di vedere tutti i messaggi relativi). Se necessario, è possibile consultare il sorgente dell'applicazione per identificare il messaggio corrispondente in caso di dubbi.

Nota: la metafora del libro è adeguata per la maggior parte dei progetti Wiki ma non per *.wikibooks.org, per i quali va in conflitto con il libro già esistente. (NdT: In questo caso il consiglio è quello di non modificare i messaggi generici ma solo quelli del proprio progetto.)

La localizzazione dei messaggi che appaiono nei documenti PDF generati dallo strumento può essere anch'essa modificata su Translatewiki.net (mwlibrl).

Verificate su Translatewiki.net che tutti i messaggi di sistema utilizzati dall'estensione siano tradotti nella vostra lingua. (NdT: Tutti i messaggi sono correnti al 04/03/2009.)

[edit] Pagine utilizzate dall'estensione

Di seguito vengono riportate tutte le pagine, le categorie e i template da creare.

[edit] Pagine

[[Special:book]] (non va creata)
La pagina speciale attraverso la quale si svolgono le interazioni principali con i libri temporanei
[[Special:book/rendering]] (non va creata)
La pagina di conversione mostra lo stato di avanzamento del processo di generazione del documento; al termine viene mostrato un collegamento per scaricarlo. Se il processo di conversione non va a buon fine, può essere mostrato un messaggio di errore. I testi sono modificabili mediante i messaggi coll-rendering_text, coll-rendering_article, coll-rendering_status, coll-rendering_page, coll-rendering_finished_text, coll-is_cached, coll-excluded_templates, coll-blacklisted_templates
[[Special:book/load_collection]] (non va creata)
Pagina utilizzata nel caricamento dei libri memorizzati e visibile all'utente solo se si desidera caricare un libro quando ne è già presente uno nella sessione corrente. I testi sono modificabili mediante i messaggi coll-load_overwrite_text, coll-overwrite, coll-append, coll-cancel
[[Aiuto:Libri]]
Pagina di aiuto principale (esempio) di questo strumento, il cui collegamento appare nel menu. La posizione può essere modificata mediante il messaggio di sistema coll-helppage
[[Aiuto:Libri/per esperti]]
sottopagina con aiuto più dettagliato (esempio), utile soprattutto per i Wikipediani
[[Aiuto:Libri/Domande frequenti]]
Le domande poste con maggiore frequenza organizzate in sottopagina (esempio), utili per tutti gli utenti
[[Aiuto:Libri/Feedback]]
sottopagina (esempio in inglese) nella quale gli utenti possono segnalare anomalie, porre domande, suggerire nuove funzioni.
[[NomeProgetto:Libri]]
Questa pagina può essere utilizzata per realizzare uno scaffale di libri memorizzati (esempio in tedesco con uno scaffale generato da un bot) (esempio in inglese senza libri), fornire informazioni o dare suggerimenti sul modo migliore per creare dei buoni libri (v. oltre la sezione "Organizzare i libri memorizzati"). La posizione della pagina può essere modificata mediante il messaggio coll-collections, mentre il namespace è definito da una variabile di configurazione globale che contiene il nome del progetto (MediaWiki: su un'installazione standard, Wikipedia: sulle varie edizioni di Wikipedia).
[[NomeProgetto:Libri/]]
i libri memorizzati nel namespace pubblico vengono creati come sottopagine di [[NomeProgetto:Libri]]
[[Template blacklist]] (FIXME)
Tutti i template richiamati in questa pagina verranno esclusi dalla stampa. Si raccomanda di non usare questa funzione in quanto rappresenta un approccio rigido e centralizzato. Si consiglia di usare invece la [[Categoria:Exclude in print]] (v. oltre). La posizione può essere modificata mediante il messaggio coll-template_blacklist_title

[edit] Categorie

[[Categoria:Wikipedia:Book tool]]
per memorizzare tutta la documentazione e le relative pagine e template
[[Categoria:Libri]]
Categoria che mantiene traccia di tutti i libri memorizzati. Si tratta di una categoria speciale in quanto tutte le pagine che ne fanno parte possono essere caricate come libri grazie al collegamento "Carica libro" che appare nel menu quando si visita una pagina della categoria. Detto ciò, i libri memorizzati vengono aggiunti automaticamente in fase di creazione, mentre non dovrebbero far parte della categoria i libri temporanei. Può essere personalizzato tramite il messaggio coll-bookscategory. Può essere opportuno modificare il messaggio in "NomeProgetto:Libri" (la categoria predefinita è solo "Libri").
[[Categoria:Exclude in print]]
utilizzata per tenere traccia di tutti i template che inseriscono informazioni inutili o fuorvianti nelle esportazioni (v. oltre per le motivazioni). Modificabile mediante il messaggio coll-exclusion_category_title

[edit] Template

[[Template:Saved book]]
Questo template (esempio) viene incluso automaticamente in testa a ciascun libro memorizzato. Può essere personalizzato per far sì che la pagina del libro memorizzato sia più gradevole e per ospitare dei metadati. La sua posizione può essere modificata mediante il messaggio coll-savedbook_template
[[Template:Hide in print]]
Questo template (esempio) restituisce tutti i comandi che gli vengono passati nel primo parametro (in altri termini: non esegue alcuna azione). Aggiungendolo alla [[Categoria:Exclude in print]] consente la rimozione selettiva di contenuti nei libri stampati o in formato PDF. Comodo! Lo si può chiamare in qualunque modo, ma non bisogna dimenticare di aggiungerlo alla categoria e darne conto nella pagina di aiuto per esperti, lasciando anche un collegamento. Nota: Questo template è stato adottato rapidamente ed è diventato ben presto uno dei più inclusi; potrebbe essere utile proteggerlo.
[[Template:Only in print]] e [[Template:PrintOnly in print]]
Questo template (esempio) non restituisce nessuno dei comandi che gli vengono passati come primo parametro, mentre [[Template:Only in print/Print]] (esempio) restituisce i comandi passati. Si veda la pagina di Aiuto per esperti per maggiori informaizoni sulla sottopagina */Print che viene utilizzata per sostituire i template in stampa. Il prefisso utilizzato per sostituire i template in stampa può essere modificato mediante il messaggio coll-print_template_prefix.

[edit] Template da escludere nei report offline

Esistono molti template i cui contenuti dovrebbero essere esclusi dalle versioni stampate. Se ne possono individuare almeno tre tipologie principali:

Messaggi di manutenzione
sono inutili e fuorvianti nelle esportazioni offline, dalle quali è impossibile contribuire. Esempi (in inglese): Maintenance, Cleanup ...
Messaggi di avviso e suggerimenti
sono inutili e fuorvianti nelle esportazioni offline; gli utenti li hanno visti quando hanno scelto i contenuti e hanno deciso di stamparli lo stesso. Esempi (in inglese): Sources of articles, Disputes, Deletion, General ...
Strumenti di navigazione
I collegamenti di navibazione sono inutili e fuorvianti nei report. Esempi (in inglese): Compact TOC, Wikimedia sister projects ...

Tali template dovrebbero essere aggiunti alla [[Categoria:Exclude in print]] (. sopra).

Si raccomanda di identificare e aggiungere i template opportuni a questa categoria quanto prima, se possibile prima dell'attivazione dell'estensione. Sulla Wikipedia in lingua tedesca è stato possibile identificare rapidamente 130 template consultando le relative categorie. A quel punto, sono stati elencati tutti in una pagina ed è stato fatto passare un bot per inserirli nella categoria. Dopo questa fase, sono stati identificati solo 14 altri template da aggiungere manualmente. Suggerimento: alcuni template sono usati a loro volta da altri template. In tali casi può essere sufficiente aggiungere il template "padre" alla categorie, escludendo quindi un'intera classe di template dalla stampa.

[edit] Organizzare i libri memorizzati

Anche se molti preferiranno crearsi i libri da soli, altri troveranno utile accedere direttamente a una serie di libri già realizzati su vari argomenti.

La pagina [[Wikipedia:Books]] può essere utilizzata per promuovere l'accesso ai libri memorizzati. Anche se siamo tutti ancora alle prime esperienze, alcune delle idee che sono state proposte finora sono riportate di seguito:

[edit] Promuovere la creazione dei libri

  • Fornire una guida sulla creazione di "libri ben fatti"
    • come scegliere un titolo adatto
    • come includere una prefazione
    • come scegliere le voci
    • raccomandazioni sul numero di voci
  • realizzare delle linee guida sui libri ammessi nel namespace pubblico. Alcuni possibili requisiti:
    • comprendere un numero ragionevole di voci (ad es. più di 5 e meno di 200)
    • avere un titolo e sottotitolo sensati
    • essere legati a un dato argomento
    • comprendere voci di qualità sufficiente (ad es. nessuna voce contestata, abbozzi, voci in canzellazione, ecc)
  • coordinare gli argomenti

[edit] Rendere i libri di facile accesso

  • fare un elenco di libri della settimana, del mese, dell'anno
  • individuare e mettere in vetrina i libri eccellenti
  • aggiungere un box "Esiste un libro su questo argomento" nelle voci, categorie o portali correlati.
  • collegare o includere parti dello scaffale A-Z

[edit] Lo scaffale

I libri memorizzati vengono inseriti nella categoria [[Categoria:Wikipedia:Books]], che però tende rapidamente a riempirsi (sulla Wikipedia in tedesco in una decina di giorni sono stati memorizzati circa 1.000 libri, la maggior parte dei quali nel namespace utente). Inoltre, la vista per categorie non consente di visualizzare i metadati né di accedere ai libri per argomento. In teoria sarebbe possibile collegare i libri alle categorie, ma ciò porterebbe a sporcare le categorie principali con i libri oppure a replicare la struttura gerarchica delle categorie in un namespace diverso.

Esiste un bot che è in grado di generare automaticamente uno scaffale che consente di esplorare i libri per titolo (A-Z) o per parole chiave. Ovviamente, lo scaffale si può creare anche a mano. Consultare la pagina dello scaffare per maggiori informazioni sull'approccio con il bot.

[edit] Preparare la Pagina Principale

Le Pagine Principali, come anche i portali, sono particolari perché spesso utilizzano una disposizione del testo su due colonne. Tail pagine si presentano in modo pessimo nei documenti PDF convertiti, legati ai vincoli di larghezza invariabile delle pagine disposte in verticale. D'altra parte, si tratta della prima pagina che quasi tutti i nuovi utenti dello strumento aggiungono al proprio libro. Un modo per evitare questa delusione al primo approccio consiste nel preparare la Pagina Principale in modo che si presenti bene in formato PDF. Questo si può ottenere utilizzando il template [[Hide in print]] in modo che la Pagina Principale (nella forma stampata) non contenga nessuna tabella o si sviluppi su una sola colonna. (Da sistemare: manca un esempio.)

Un altro problema è rappresentato dalla visibilità del menu laterale. I visitatori di Wikipedia (non quelli che stanno leggendo questa pagina, ovviamente) in gran parte non fanno nemmeno caso alla barra laterale. Può essere d'aiuto inserire per qualche tempo un avviso ben visibile su questa nuova funzione e un collegamento alla pagina di aiuto nel box "Novità su Wikipedia" della Pagina Principale, se esiste.

[edit] Segnalazione delle anomalie, feedback e aiuto

[edit] Sul sito

Esiste una pagina di feedback unificata su Meta (in inglese) dove vengono raccolte tutte le domande, le richieste di nuove funzioni, i suggerimenti e le segnalazioni di anomalie, ecc. Le edizioni di Wikipedia in lingue diverse possono decidere di realizzare una pagina simile (esempio) su ciascun sito e definire un meccanismo per l'eventuale traduzione e segnalazione degli aspetti irrisolti a livello locale su Meta.

[edit] Bug Tracker

Il metodo migliore per segnalare delle anomalie e verificarne lo stato è il sistema di gestione dei bug sul sito . Esiste anche una componente "collection" su bugzilla (il sistema di gestione dei bug di MediaWiki) ma non dovrebbe essere usata.

[edit] IRC

Esistono due canali IRC:

  • #booktool - per le domande e le discussioni generali
  • #pediapress - per discussioni relative al codice con sviluppatori e bot

[edit] Mailing list

Esiste un gruppo di discussione di Google dedicato all'estensione Collection. Ci si può escrivere via e-mail: mwlib-subscribe-at-googlegroups.com o consultare gli archivi.

[edit] Esperienze dalle installazioni già eseguite

[edit] de.wikipedia.org

Quello che ha funzionato: Lo strumento è stato accolto perlopiù in modo positivo. Sono stati creati molti libri memorizzati in un breve lasso di tempo. I media hanno rapidamente ripreso la notizia dopo un comunicato stampa del Chapter tedesco di WMF. Quello che non ha funzionato: Era previsto di limitare l'uso del nuovo strumento agli utenti registrati per la prima settimana, ma per qualche motivo non è andata così. La funzione è stata quindi attivata senza che la documentazione e la localizzazione fossero completamente pronte. Alcuni utenti non vedevano il menu su alcune pagine, probabilmente per un problema di cache. La Pagina Principale non era adatta alla versione stampabile (v. sopra). Infine, si è verificato un effetto Slashdot quando il noto magazine online Heise ha riportato la notizia. Il server di conversione è crollato (per un carico vicino a 300) e non è stato in grado di rispondere alle richieste.

[edit] Aggiornamenti

In questa sezione vengono riportati gli aggiornamenti al software, in particolare quelli che richiedono attenzione da parte della comunità.

(Nota: Vedere la pagina originale in inglese).

Retrieved from "http://meta.wikimedia.org/wiki/Book_tool/it"