Wikisource:WS Export
WS Export è uno strumento per esportare i testi di Wikisource in formato EPUB, PDF e altri.
Può essere usato direttamente dalla sua pagina di Toolforge: https://ws-export.wmcloud.org/ (per testi in tutte le lingue; usa www per Wikisource Multilingue, o "beta" per Beta Wikisource).
Questa pagina spiega come configurare una Wikisource per ottenere i migliori risultati da WS Export. Per la maggior parte di queste operazioni avrai bisogno dei diritti di amministratore.
Storia
Lo strumento è stato creato dall'utente Tpt per la Wikisource in francese, ma è disponibile anche per gli altri sottodomini linguistici.
Per libri
Microformat
Nell'esportare una pagina, WS Export cerca i metadati della pagina (titolo, autore, anno ecc.) usando le specifiche Microformat. Per vedere queste informazioni negli EPUB esportati, devi implementare Microformat sul tuo sottodominio, nel template che stai usando come intestazione per i tuoi testi. Puoi trovare un esempio in fondo a template:Proofreadpage header template.
Nascondere elementi indesiderati
Potresti desiderare nascondere certi elementi nei tuoi EPUB, ad esempio il riquadro di intestazione o i numeri di pagina generati da MediaWiki:Proofreadpage pagenum template. Assegna class="ws-noexport" a ciascun elemento HTML che vuoi escludere dall’esportazione.
Per la wiki
WS Export usa un sistema di cache, devi seguire questo URL quando cambi i file seguenti: https://ws-export.wmcloud.org/?&lang=en
CSS
Se hai bisogno di includere degli stili CSS, puoi creare MediaWiki:Epub.css e collocarli lì. Nessuno stile CSS da Mediawiki:Common.css o da CSS forniti con MediaWiki è inserito nel file ePub generato. Se vuoi evitare che un certo contenuto appaia nel testo esportato, puoi usare la classe CSS ws-noexport.
Traduzione
Per tradurre i messaggi dell'interfaccia, crea MediaWiki:Wsexport i18n.ini (segui questo file come esempio).
Informazioni
Puoi fornire il tuo file di informazioni creando MediaWiki:Wsexport about (segui fr:MediaWiki:Wsexport about come esempio). L'elenco dei contributori, eccetto i bot, è incluso al tag "{CONTRIBUTORS}". Per la lista dei bot, usa il tag "{BOT-CONTRIBUTORS}".
Segnalazione di malfunzionamenti
Per favore riporta qualunque problema tramite Phabricator, con il tag di progetto #ws_export. In alternativa puoi aggiungerli alla pagina di discussione qui.
Sottopagine
L'attuale algoritmo usato da WS Export per estrarre la tavola dei contenuti (TOC) del libro (e così, includere le altre pagine del libro) è:
- cerca nodi nelle pagine con class="ws-summary" (potrebbe essere direttamente MY_TOC nel wikitesto della pagina di una cosa equivalente fatta usando dei template)
- se si trovano tali nodi, usa la loro lista di link per costruire la TOC
- altrimenti cerca tutti i link a sottopagine e usa l'elenco risultante come TOC
Vedi anche
- Codice sorgente su github
- Puoi trovare i dump dei registri SQL presso https://ws-export.wmcloud.org/logs/
- Documentazione di diffusione: wikitech:Nova Resource:Wikisource
Problemi noti
- I link interni non funzionano se c'è un reindirizzamento su Wikisource.