Diferència entre revisions de la pàgina «Ajuda:WSexport»

587 bytes afegits ,  fa 3 mesos
canvis de funcionament, reviseu s.u.p.
m (URL update)
(canvis de funcionament, reviseu s.u.p.)
 
'''WSexport''' és una utilitat per a descarregar els textos de Viquitexts com a fitxers [[:w:EPUB|EPUB]], mobi, PDF o d'altres formats.
 
No és l'única manera de fer-ho: també disposeu de l'utilitat '''Llibre'''. Llegiu la pàgina [[Ajuda:Llibres]] per a més informació.
 
==Ús==
Al menú esquerre de cada pàgina trobareu els següents enllaços per a la descàrrega:
Aquesta utilitat només està disponible per aquells texts creats amb el sistema de [[Ajuda:Pàgines de transcripció|pàgines de transcripció]].
* {{:MediaWiki:Wikisource-download-epub}}
* {{:MediaWiki:Wikisource-download-mobi}}
* {{:MediaWiki:Wikisource-download-pdf}}
* {{:MediaWiki:Wikisource-download-choose}}
 
Algunes pàgines també tenen l'enllaç per a la descàrrega com a EPUB (sempre que facin servir la plantilla {{tl|epub}}, generalment a través de {{tl|Encapçalament}}, {{tl|Header}}, {{tl|FD}} i d'altres).
Podeu accedir directament al servidor https://wsexport.wmflabs.org/book.php i especificar quin text voleu convertir a EPUB, amb algunes opcions addicionals.
 
PodeuTambé es pot accedir directament al servidor https://wsexport.wmflabs.org/book.php i especificar quin text voleu convertir a EPUB, amb algunes opcions addicionals.
La forma més còmoda és fer clic a l'opció '''Descarrega com EPUB''' del menú esquerre. El fitxer EPUB es crearà en pocs segons.
 
==Contingut==
Si voleu descarregar un llibre sencer amb totes les seves subpàgines, caldrà seguir les següents instruccions:
 
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ç.
'''1r.''' Establir la pàgina pòrtic des d'on farem clic a ''Descarrega com EPUB'' 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.
 
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:
'''2n.''' Crear una taula de continguts (TOC):
 
'''1r.''' Establir la pàgina pòrtic des d'on farem clic a l''Descarregaenllaç comde EPUB''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.
:'''2.a.''' Si l'obra originalment no conté cap TOC, la crearem manualment o amb {{tl|Taula auxiliar de continguts}} a l'esmentada pàgina de pòrtic. Exemple: ''[[Curial y Guelfa]]''.
 
:'''2.b2n.''' SiCrear l'obrauna originalmenttaula contéde una TOC i...continguts:
 
::'''2.b.Ia.''' ...quedaSi transclosal'obra aoriginalment lano pàginaconté cap taula de pòrticcontinguts, ella programaricrearem sabràmanualment construiro amb {{tl|Taula auxiliar de continguts}} a l'ePubesmentada sensepàgina ferde res méspòrtic. Exemple: ''[[Lo nou testament de nostreCurial senyory Jesu-ChristGuelfa]]''.
 
:'''2n2.b.''' CrearSi l'obra originalment conté una taula de continguts (TOC):i...
::'''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 TOC, i (2) que les pàgines amb la TOC quedin incloses amb l'etiqueta de la classe <code><nowiki>"ws-summary"</nowiki></code>. [https://ca.wikisource.org/w/index.php?title=P%C3%A0gina%3AJochs_Florals_de_Barcelona_en_1860.djvu%2F152&type=revision&diff=132296&oldid=132290 Exemple].
 
::'''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]]''.
'''3r.''' Prémer ''Descarrega com EPUB''.
 
::'''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 TOCtaula de continguts, i (2) que les pàgines amb la TOCtaula de continguts quedin incloses amb l'etiqueta de la classe <code><nowiki>"ws-summary"</nowiki></code>. [https://ca.wikisource.org/w/index.php?title=P%C3%A0gina%3AJochs_Florals_de_Barcelona_en_1860.djvu%2F152&type=revision&diff=132296&oldid=132290 Exemple].
 
'''3r.''' Prémer l''Descarregaenllaç comde EPUB''descàrrega.
 
== Configuració (per administradors) ==
Trobareu informació actualitzada a la pàgina [[:oldwikisource:Wikisource:WSexport]].
 
*Els enllaços s'afegeixen a través de l'extensió Wikisource <ref>Vegeu [[:phab:T256392]]. Fins a gener de 2021, els enllaços estaven codificats a [http://ca.wikisource.org/w/index.php?title=MediaWiki:Common.js&curid=3290&diff=53076&oldid=51970 Actualització] del [[:Mediawiki:Common.js]] per a fer aparéixer l'opció ''Descarrega com EPUB'' del menú esquerre</ref>.
 
*[[:MediaWiki:Wsexport about]]: conté el text que apareixerà a la darrera pàgina de tots els EPUBs (''Quant a''). Inclou el nom de la pàgina on enllaçaran els EPUBs per informar d'errors, actualment [[Ajuda:Informar d'un error]].
*[[:MediaWiki:Wsexport i18n.iniabout]]: conté el text que apareixerà a la tauladarrera pàgina de contingutstots queels apareixeràfitxers de descàrrega (''Quant a''). Inclou el nom de la pàgina a la qual s'hi enllaçarà per cadascuninformar dels EPUBserrors, generatsactualment [[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 EPUB 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, <code><nowiki><span id="ws-author">[[Autor:Ramon Llull|Ramon Llull]]</span></nowiki></code>.
 
La inclusió d'aquest codi de marques pot fer-se manualment o mitjançant plantilles, o fent servir la pàgina [[:MediaWiki:Proofreadpage header template]].
 
Si es canvia el nom d'alguna metadada, també caldrà revisar la plantilla de l'índex ([[:MediaWiki:Proofreadpage index template]]).
 
== Referències ==
{{referències}}
 
[[Categoria:Viquitexts]]