Wikisource:WS Export
WS Export ist ein Werkzeug zum Export von Wikisource-Texten in EPUB, PDF und andere Dateiformate.
Es kann direkt von seiner Seite auf Toolforge aus genutzt werden: https://ws-export.wmcloud.org/ (für Texte in allen Sprachen; nutze "www" für die mehrsprachige Wikisource oder "beta" für Beta Wikisource).
Diese Seite erklärt, wie man ein Wikisource-Projekt konfiguriert, um die besten Ergebnisse von WS Export zu erhalten. Für die meisten dieser Aktionen benötigst du Admin-Rechte.
Geschichte
Das Werkzeug wurde von Benutzer Tpt für die französischsprachige Wikisource erstellt, ist jedoch auch für die anderen Wikisource-Subdomains verfügbar.
Für Bücher
Mikroformat
Wenn du eine Seite exportierst, sucht WS Export nach den Metadaten der Seite (Titel, Autor, Jahr, etc.) und verwendet dafür die Mikroformat-Spezifikation. Um diese Informationen in den exportierten EPUBs zu sehen, musst du Mikroformat in deiner Subdomain in der Vorlage implementieren, die du als Titelleiste für deine Texte nutzt. Du kannst ein Beispiel unten auf fr:Modèle:Proofreadpage header template finden.
Unerwünschte Elemente verstecken
Möglicherweise möchtest du bestimmte Elemente in deinen EPUBs, wie die Titelleiste oder die durch MediaWiki:Proofreadpage pagenum template generierten Seitenzahlen, verstecken. Weise class="ws-noexport" jedem HTML-Element zu, das du vom Export ausschließen möchtest.
Für das Wiki
WS Export nutzt ein Cache-System. Du musst dieser URL folgen, wenn du die folgenden Dateien änderst: https://ws-export.wmcloud.org/?&lang=en
CSS
Wenn du bestimmte benutzerdefinierte CSS-Styles einschließen musst, kannst du MediaWiki:Epub.css erstellen und sie dort einfügen. Kein CSS aus Mediawiki:Common.css oder CSS, das durch MediaWiki bereitgestellt wird, wird in die generierte ePub-Datei aufgenommen. Wenn du bestimmte Inhalte im exportierten Text behalten möchtest, kannst du die CSS-Klasse ws-noexport nutzen.
Übersetzung
Um die Nachrichten der Benutzeroberfläche zu übersetzen, erstelle MediaWiki:Wsexport i18n.ini (folge dieser Datei als Beispiel).
Über
Du kannst eine About-Datei bereitstellen, indem du MediaWiki:Wsexport about erstellst (folge fr:MediaWiki:Wsexport about als Beispiel). Die Liste von Beitragenden, Bots ausgenommen, wird durch die Markierung "{CONTRIBUTORS}" aufgenommen. Nutze die Markierung "{BOT-CONTRIBUTORS}" für die Bot-Liste.
Fehlerberichte
Bitte melde alle Probleme im Phabricator mit der Projekt-Markierung #ws_export. Alternativ kannst du sie hier auf der Diskussionsseite hinzufügen.
Unterseiten
Der aktuell in WS Export genutzte Algorithmus, um das Inhaltsverzeichnis (TOC) des Buchs zu extrahieren (und somit die anderen Seiten des Buchs mit einzubeziehen), ist:
- Suche nach Knoten in den Seiten mit class="ws-summary" (es kann direkt MY_TOC im Wikitext einer äquivalenten Sache sein, die mit Vorlagen erreicht wurde).
- Wenn solche Knoten gefunden wurden, nutze ihre Liste von Links, um das TOC zu erstellen.
- Wenn nicht, suche nach allen Links auf Unterseiten und nutze die erhaltene Liste als TOC.
Siehe auch
- Quellcode auf Github
- Dumps von Log-SQL finden sich auf https://ws-export.wmcloud.org/logs/
- Einsatz-Dokumentation: wikitech:Nova Resource:Wikisource
Bekannte Fehler
- Die internen Links funktionieren nicht, wenn es in Wikisource eine Weiterleitung gibt.