Ajuda:WSexport

WSexport és una utilitat per a descarregar els textos de Viquitexts com a fitxers EPUB, mobi, PDF o d'altres formats.

No és l'única manera de fer-ho: també disposeu de l'utilitat Llibre (més informació a Ajuda:Llibres).

Ús

La descàrrega pot sol·licitar-se de diferents maneres:

• Botó de color blau amb l'etiqueta «Baixa» (habitualment a la part superior d'una pàgina).

• Opcions del menú esquerre per a la descàrrega:

• Baixa com a EPUB
• Baixa com a MOBI
• Baixa com a PDF
• Altres formats

• Icones de descàrrega a les pàgines amb una capçalera estàndard ({{Header}}): «Baixa com a    »

• Accedir directament al servidor https://ws-export.wmcloud.org/book.php i especificar quin text voleu convertir.

Contingut

En general, el fitxer que es genera i que podreu descarregar inclou el contingut de la pàgina des de la qual premeu l'enllaç.

No obstant, algunes pàgines permeten la descàrrega única de l'obra sencera tot i estar dividida en més d'una pàgina. En aquests casos, caldrà fer-ho possible seguint les següents instruccions:

1r. Establir la pàgina pòrtic des d'on farem clic a l'enllaç de descàrrega i que haurà de portar per nom l'arrel de les subpàgines de capítols. Per exemple, Jochs Florals de Barcelona en 1860 seria el pòrtic i els capítols hauran d'anomenar-se com a subpàgines de l'estil Jochs Florals de Barcelona en 1860/Jesucrist, Jochs Florals de Barcelona en 1860/Las barras de sanch, etc.

2n. Crear una taula de continguts:

2.a. Si l'obra originalment no conté cap taula de continguts, la crearem manualment o bé mitjançant {{Taula auxiliar de continguts}} a l'esmentada pàgina de pòrtic. Exemple: Curial y Guelfa.

2.b. Si l'obra originalment conté una taula de continguts i...

2.b.I. ...queda transclosa a la pàgina de pòrtic, el programari sabrà construir el fitxer de descàrrega sense fer res més. Exemple: Lo nou testament de nostre senyor Jesu-Christ.

2.b.II. ...queda transclosa en una pàgina que no és la pàgina de pòrtic, caldrà que (1) el pòrtic enllaci l'esmentada pàgina que conté la taula de continguts, i (2) que les pàgines amb la taula de continguts quedin incloses amb l'etiqueta de la classe "ws-summary". Exemple.

Configuració (per administradors)

Trobareu informació actualitzada a la pàgina oldwikisource:Wikisource:WSexport.

Els enllaços del menú esquerre s'afegeixen a través de l'extensió Wikisource ^[1].

• MediaWiki:Wsexport about: conté el text que apareixerà a la darrera pàgina de tots els fitxers de descàrrega (Quant a). Inclou el nom de la pàgina a la qual s'hi enllaçarà per informar dels errors, actualment Ajuda:Informar d'un error.
• MediaWiki:Wsexport i18n.ini: conté la taula de continguts que apareixerà a cadascun dels fitxers generats.
• MediaWiki:Epub.css: conté el codi necessari per a permetre determinats estils, com els escolis laterals.

Metadades

Cada fitxer pot contenir metadades addicionals (autor, data de publicació, etc.). Per permetre-ho, cal que el codi Html contingui les marques indicades a oldwikisource:Wikisource:Microformat, com per exemple, <span id="ws-author">[[Autor:Ramon Llull|Ramon Llull]]</span>.

La inclusió d'aquest codi de marques actualment es fa a través de MediaWiki:Proofreadpage header template (que redirecciona, en darrera instància, a Mòdul:Header, qui prepara les metadades següents, sempre que existeixin: ws-title, ws-author, ws-translator, ws-illustrator, ws-publisher, ws-year, ws-place, ws-progress, ws-volume, ws-scan, ws-cover i ws-summary).

Per a fer servir el codi de la pàgina MediaWiki:Proofreadpage header template cal afegir el paràmetre header en la marca de transclusió pages (vegeu Ajuda:Pàgines de transcripció per a veure informació bàsica sobre pages). Per exemple, <pages index="Quixot.djvu" from=1 to=5 header=1 /> farà que a la transclusió, a més d'aparéixer les pàgines de la 1 a la 5, també aparegui el codi contingut a MediaWiki:Proofreadpage header template.

Referències

1. Vegeu phab:T256392. Fins a gener de 2021, els enllaços estaven codificats a Mediawiki:Common.js