Utilisateur:Cantons-de-l'Est/HDCERtest

Cette page comprend des informations sur l'usage de WsExport, un outil pour générer des fichiers PDF, ePub, mobi... à partir de pages de la Wikisource.

Description

WsExport est une adaptation de Calibre, un logiciel gratuit que l'on peut installer sur son poste de travail (Windows, Mac et Linux). Calibre transforme un format de fichier en un autre. Les meilleurs résultats sont obtenus lorsque le fichier d'entrée est au format HTML. Pour les fichiers en sortie, Calibre propose beaucoup de formats : PDF, ePub, DOC, RTF... Apprivoiser ce logiciel est un exercice délicat : pour chaque format de sortie, on peut moduler la mise en page de multiples façons (pas toujours de façon intuitive, mais la typographie est à la fois un art et une technique).

Usage

WsExport est installé sur Wikimedia Labs : https://tools.wmflabs.org/wsexport/tool/book.php. Si vous suivez ce lien, un formulaire apparaît, que vous pouvez remplir à chaque fois que vous voulez créer un nouveau fichier.

Sinon, vous pouvez créer une commande (à la façon PHP) qui comprend tous les paramètres nécessaires. Voici les paramètres qu'il reconnaît :

• lang : langue de Wikisource (de, en, fr...)
• format : format du fichier créé
  • pdf-a4 : PDF, page à la taille A4
  • pdf-a5 : PDF, page à la taille A5
  • pdf-a6 : PDF, page à la taille A6
  • pdf-letter : PDF, page à la taille US letter
  • mobi : mobi
  • epub-2 : ePub 2
  • epub-3 : ePub 3
  • txt : texte
  • rtf : RTF
  • htmlz : HTMLZ
• fonts : polices de caractères à insérer dans le fichier créé.
  • linuxlibertine : Linux Libertine
  • libertinus : Libertinus
  • freeserif : Free Serif
  • D'autres polices sont disponibles, mais elles concernent des langues indiennes (Mukta Mahee, par exemple)
  • Toutes ces polices sont publiées sous une licence dite libre.
  • (rien) : aucune police ne sera insérée dans le fichier créé. Il est notablement plus léger, mais si l'ouvrage comprend des caractères peu courants, ils seront peut-être mal rendus. L'insertion de la police rend la lecture indépendante de l'appareil (par exemple, si le fichier « parle » grec, l'appareil doit être doté de caractères grecs pour les afficher proprement), au prix d'un fichier plus lourd. Par exemple, l'insertion de Linux Libertine (2 000 caractères) ajoute 2 Mo au fichier créé.
• page : la page de Wikisource à transformer en fichier. WsExport opère de deux façons :
  • Si la page comprend le code <pages index=, il « remonte » au livre associé et regroupe toutes les pages du livre dans un certain ordre, plaçant la table des matières tout de suite après la page-titre.
  • Si la page ne comprend pas <pages index=, WsExport recopie le contenu de la page et créé un fichier.
  • Dans le titre de la page, il faut remplacer les espaces par des soulignés.

Exemple de commande (qu'il suffit de cliquer pour lancer la création d'un fichier)

https://tools.wmflabs.org/wsexport/tool/book.php?lang=fr&format=pdf-a5&fonts=linuxlibertine&page=HDCER/Tome_bidon_sans_lien

MediaWiki:Epub.css comprend une liste de commandes CSS, qui sert à modifier le rendu du texte. Par exemple, pour supprimer le soulignement des hyperliens, il faut utiliser a { text-decoration:none; }. Ce fichier ne peut être modifié que par un adminstrateur de Wikisource.

Limitations

Calibre, version 3.46, comprend des limitations qui peuvent interdire la production d'un ouvrage sans défaut.

• Si le nombre d'entrées d'une liste dépasse 100, le compteur est remis à zéro. Si la liste comprend 256 entrées, Calibre créera trois listes.

  Dans la plupart des ouvrages, aucune liste ne dépasse ce nombre d'éléments. Toutefois, dans Histoire de la décadence et de la chute de l'Empire romain, le nombre de références par chapitre dépasse allègrement cette limite (l'un des tomes dépasse 800 références). Ce bogue « disparaît » si chaque référence est regroupée et numérotée. Exemple : <ref group=e follow=p281_1>, mais pas <ref group=e>, ni <ref follow=p281_1>.

• Si le document comprend au moins 1 000 hyperliens, incluant les renvois vers les références et les retours vers les numéros des notes, la navigation par les liens sera erratique.

  Aucune façon de contourner ce problème. Toutefois, très peu de documents dans Wikisource comprennent autant d'hyperliens et il est toujours possible de naviguer avec les flèches bas et haut ou en utilisant l'ascenseur.

• Si le wikicode comprend une liste avec une puce sans texte, comme

• texte
  
• 
  
• texte

alors la seconde puce, que le moteur de Wikisource masque habituellement dans le rendu de la page, apparaît dans le fichier créé.

Pour contourner ce bogue, supprimer ou masquer la puce sans texte.