Wikisource:WS Export
WS Export est un outil pour exporter les textes de Wikisource en format ePub, PDF ou autre.
Il peut être utilisé directement depuis sa page sur Toolforge : https://ws-export.wmcloud.org/ (pour les textes de toutes les langues ; utiliser "www" pour Wikisource multilingue, ou "beta" pour Beta Wikisource).
Cette page explique comment configurer un projet Wikisource pour obtenir les meilleurs résultats de WS Export. La plupart de ces opérations nécessite un rôle administrateur.
Historique
L'outil a été créé par l'utilisateur Tpt pour Wikisource français, mais il est également disponible pour les autres sous-domaines Wikisource.
Pour les livres
Microformat
Quand WS Export exporte une page, il recherche ses métadonnées (titre, auteur, année, etc.) dans les spécifications Microformat. Pour inclure ces informations dans les ePubs exportés, Microformat doit être mis en œuvre dans le modèle d’en-tête utilisé par les textes de votre sous-domaine. Vous pouvez trouver un exemple à la fin de fr:Modèle:Proofreadpage header template.
Cacher les éléments inutiles
Si vous le désirez, certains éléments peuvent être absents dans vos ePubs, comme le boîte d’en-tête, ou les numéros de pages générés par MediaWiki:Proofreadpage pagenum template. Affectez la classe class="ws-noexport" à chaque élément à exclure de l’export.
Pour le wiki
WS Export utilise un système de cache, vous devez suivre cette URL si vous modifiez les fichiers ci-dessous : https://ws-export.wmcloud.org/?&lang=en
CSS
Si vous avez besoin de personnaliser les styles CSS, vous pouvez créer MediaWiki:Epub.css et le mettre ici. Aucun CSS de Mediawiki:Common.css ou fourni par MédiaWiki n’est injecté dans le fichier ePub généré. Pour éviter que du contenu n’apparaisse dans le text exporté, vous pouvez lui affecter la classe CSS ws-noexport.
Traduction
Pour traduire les messages de l'interface, créez MediaWiki:Wsexport i18n.ini (suivre ce fichier comme exemple).
À propos de cette édition électronique
Vous pouvez fournir votre fichier « À propos » en créant MediaWiki:Wsexport about (suivre fr:MediaWiki:Wsexport about comme exemple). La liste des contributeurs, à l'exception des bots, est incluse par la balise "{CONTRIBUTORS}". Pour la liste des bots, utilisez la balise "{BOT-CONTRIBUTORS}".
Signalement de boques
Veuillez signaler tout problème via Phabricator, avec la balise #ws_export du projet. Vous pouvez également les ajouter à la page de discussion de cet article.
Sous-pages
Pour extraire la table des matières (TdM) du livre (et donc inclure ses autres pages), l’algorithme actuel de WS Export est :
- rechercher des nœuds dans les pages de class="ws-summary" (la page wikitext pourrait contenir directement MY_TOC ou un équivalent fait à l'aide de modèles)
- si de tels nœuds sont trouvés, utiliser la liste des liens qui y figurent pour construire la TdM
- sinon, rechercher tous les liens vers des sous-pages et utiliser la liste constituée comme TdM
Voir aussi
- Code source sur GitHub
- Les vidages mémoires de log SQL peuvent être trouvés à https://ws-export.wmcloud.org/logs/
- Documentation de déploiement : wikitech:Nova Resource:Wikisource
Problèmes connus
- Les liens internes ne fonctionnent pas s'il y a une redirection dans Wikisource.