Reading/Web/PDF Functionality/de

Update zum PDF rendern, 15. Juli 2019
Wir haben den neuen PDF-renderer veröffentlicht. Wir schauen uns eure Rückmeldungen an, bisher sind jedoch keine dramatischen Probleme geschildert worden. Wir werden noch einige der Anmerkungen berücksichtigen. Bitte beachtet jedoch, dass die Arbeit am PDF-Renderer kein dauerhaftes Projekt bleibt! Das heißt, wenn es veröffentlicht wird und funktioniert, dann bleibt es so und wird nur noch gewartet, aber nicht weiter entwickelt. Die Diskussionsseite dieser Seite hier wird weiter offen bleiben, es könnte jedoch etwas dauern, eh ihr eine Rückmeldung erhaltet. Ganz einfach deswegen, weil jeder sich jetzt an die anderen offenen Projekte setzen wird.

Zur Büchergenerierung: dort haben wir noch ein paar freiwillige Entwickler und Leute von PediaPress an Bord. Wir freuen uns dort auch über eure Fragen, wir planen derzeitig aber keine Veränderungen der technischen Implementierung.

Update zum PDF rendern, 4. Juni 2019
Wir haben in allen Projekten den neuen Renderer für PDFs aus einem einzelnen Artikel freigeschaltet. Wir hoffen, dass dies die Probleme mit dem Electron-Renderer beseitigen wird, der oftmals nicht die gewünschten Ergebnisse erzielte. Probiert den neuen Renderer aus und lasst uns eure Fragen, Fehlermeldungen und Ideen zukommen.

Update der PDF-Darstellung, 18. März 2019
Es dauert nicht mehr lange, bis der neue PDF-Renderer (Proton) veröffentlicht wird. Derzeit sind nur noch wenige Probleme aus dem Weg zu räumen (wie es in der Grafik in T181084 zu sehen ist). Sobald ein Veröffentlichungsdatum fest steht, werden wir es bekannt geben. Dieser Renderer wird den electron-Renderer als Standard-PDF-Anwendung ersetzen (für PDFs mit einzelnen Seiten).

Update der Buchfunktion, 17. August 2018
Hier ist ein aktualisiertes und umfassenderes Beispiel für den neuen Buch-Renderer. Das Layout hat sich gegenüber der ersten Version, die bei Wikimania vorgestellt wurde, stark verändert. Danke für das ganze Feedback. Der Export hat noch eine Reihe wichtiger Probleme: Seitenumbrüche, Infofelder, Tabellen und mathematische Formeln müssen erheblich verbessert werden. Diese Beispieldatei, die sich auf internationale Skripte und mathematische Formeln konzentriert, zeigt einige der Probleme, die noch zu lösen sind. Matheformeln werden derzeit mit MathML gerendert - die Umstellung auf LaTeX sollte zu deutlichen Verbesserungen führen. The layout changed quite a from the first version presented at Wikimania. Thanks for all the feedback. The export still has a number of significant issues: page breaks, infoboxes, tables, and math formulas need to be improved substantially. This sample file focusing on international scripts and math formulas reveals some of the problems that still need to be solved. Math formulas are currently rendered using MathML - switching to LaTeX should lead to significant improvements.

Update der Buchfunktion, 8. August 2018
Wir haben mit PediaPress an der Erstellung und Gestaltung der neuen Bücher gearbeitet. Sie haben uns ein Muster der aktuellen Ausgabe zur Verfügung gestellt, das der endgültigen Version sehr ähnlich sein wird. Wir haben mit dem PediaPress-Team Verbesserungspunkte besprochen, das es derzeit in Angriff nimmt. Wenn Sie Rückmeldungen oder andere Kommentare zu diesen Beispielen haben, lassen Sie es uns bitte auf der Diskussionsseite wissen.

Update April 2018
Die Buchfunktionalität wird über PediaPress zurückkehren. Nachdem wir den neuen Renderer eingehend untersucht hatten, stellten wir fest, dass die Kernfunktionen der ursprünglichen Buchfunktion (wie Seitenzahlen und Inhaltsverzeichnis) mit dem neuen Renderer nur sehr schwer zu implementieren sind. Außerdem hatten wir erhebliche Probleme mit unserem Verknüpfungscode. Daher mussten wir nach Alternativen suchen, um die PDF-Buchfunktionalität bei Wikimedia-Projekten wiederherzustellen. Wir wandten uns an PediaPress, die die ursprünglichen Förderer von Büchern auf Wikipedia waren, um zu sehen, ob sie daran interessiert wären, die PDF-Wiedergabe für Bücher wieder aufzunehmen. Sie haben zugestimmt und wir arbeiten derzeit an den Details und dem Zeitplan. Sie werden zunächst an einer temporären Lösung arbeiten, die auf einer älteren Technologie basiert, die bisher zur Erstellung von PDF-Dateien verwendet wurde. Dies kann einige Nachteile haben, wenn es um grafische Elemente wie z.B. Karten geht, bedeutet aber eine schnellere Lösung. Anschließend planen sie die Arbeit an einem neuen HTML-zu-PDF-Renderer, basierend auf dem Feedback der ersten Implementierung. After investigating the new renderer in depth, we realized that core features of the original book creator (such as page numbers and table of contents) would be very difficult to implement using the new renderer. In addition, we had significant issues with our concatenation code. Thus, we had to look for alternatives in terms of bringing back the PDF books functionality on Wikimedia projects. We reached out to PediaPress, who were the original patrons of books on Wikipedia to see if they would be interested in taking up PDF rendering for books once again. They have agreed and we are currently working on the details and schedule. They will start by working on a temporary solution based on an older technology that has previously been used to create PDF. This might have some drawbacks when it comes to graphical elements, such as maps, but will mean a faster working solution. They then plan to work on a new HTML-to-PDF renderer afterwards, based on feedback on the first implementation.

Update im Januar 2018
Wir bereiten derzeit Leistungstests der PDF-to-Book-Funktion vor. Wir sollten Anfang Februar mehr wissen.

Update im September 2017
Unser aktueller PDF-Renderer (Service zur Erzeugung von PDF-Dateien), der Offline Content Generator (OCG), kann nicht mehr gewartet werden. Er gibt, verkürzt gesagt, den Geist auf. Das Reading Team bei der Wikimedia Foundation arbeitet seit Monaten daran, den Service zu ersetzen. OCG wurde auf veraltetem Code ausgeführt, der in der Zukunft Sicherheitslücken und andere gravierende Probleme verursachen kann. In den letzten drei Monaten wurde auf der Spezialseite "Als PDF herunterladen" um Rückmeldung zum Prototyp eines neuen PDF-Renderers gebeten. Der neue Renderer soll besser funktionieren als OCG – er wird in der Lage sein, Tabellen und Infoboxen zu drucken und das Design der PDFs wird zugunsten einer besseren Lesbarkeit optimiert. Wir haben viele gute Rückmeldungen zum Prototyp gesammelt und arbeiten daran, die erforderlichen Verbesserungen an der neuen PDF-Funktion zu machen. Simply put, it's breaking down. The Reading team at the Wikimedia Foundation has been working towards replacing it for months. OCG has been running on outdated code which may introduce security vulnerabilities and other major issues in the future. Over the last three months, we’ve had banners on the PDF creation page asking for feedback on the prototype for our new renderer. The new renderer will have improved capabilities from OCG – it will be able to print tables and infoboxes and will contain styling focused on better readability. We've gathered a lot of good feedback on the prototype and are working on making the required updates to our new PDFs.

Nachtrag: Kurzfristiges ABSCHALTEN der PDF-Bucherstellung
Leider machen es große Probleme mit unserem alten Renderer (OCG) erforderlich, dass wir ihn abschalten, bevor die notwendigen Verbesserungen für die Buchfunktion abgeschlossen sind. Damit findet die Abschaltung früher statt, als wir wollten. Zu dem Zeitpunkt, an dem wir OCG abschalten, werden die Arbeiten an Einzeldownloads (“Als PDF herunterladen”) abgeschlossen sein. Die Buchfunktion wird allerdings pausieren, während wir auswerten und die nötigen Arbeiten abschließen. Der ursprünglich von uns ausgewählte Ersatz-Renderer, der Electron Rendering Service, ist nicht in der Lage, größere PDFs zu unterstützen und scheitert, wenn man versucht, ein Buch mit mehreren Artikeln zu erzeugen. Wir werden daran arbeiten, ein neues Rendering-System für Bücher auszuwählen, das die Größe der Dateien verarbeiten und unsere Anforderungen unterstützen kann. Dies entspricht nicht unserer ursprünglichen Planung. Wir haben niemals angestrebt, die Bucherstellung vorübergehend zu entfernen. This is earlier than we wanted. By the time we remove OCG, the work for rendering of single articles will be completed. However, the rendering of books will be paused while we evaluate and complete the necessary work. Our initial choice of renderer for the replacement, the Electron rendering service, is not capable of supporting PDFs of larger sizes and fails when attempting to render a book with multiple articles. We will be working to select a new rendering system for books which can handle the size of the files and support our requirements. This is not how we planned to do this. We never aimed to temporarily remove the book PDF functionality.

Zeitplan:


 * Bereitstellung des PDF-Renderers mit vollem Funktionsumfang für einzelne Artikel (als PDF drucken) - 1. Oktober 2017
 * Pausieren der PDF - Bucherstellung - 1. Oktober 2017
 * Abschalten des OCG-Renderers - 1. Oktober 2017
 * Bereitstellung eines neuen PDF - Renderers mit vollem Funktionsumfang – Jan 2018 (vorläufig, abhängig von den Rechercheergebnissen zu alternativen Rendersystemen)

Funktionalität:

Für eine vollständige Liste der aktuellen und geplanten Funktionen, siehe unten.

Zusätzlich zu den Aktualisierungen auf dieser Seite wird dies in einem Banner auf PDF-Erstellungsseite kommuniziert, auf Tech News und auf einigen Wikimedia-Mailinglisten.

Einleitung
Unser aktueller Service zur Erzeugung von PDF-Dateien, der Offline Content Generator (OCG), kann nicht mehr gewartet werden. Verkürzt gesagt gibt er den Geist auf. Das Reading Team bei der Wikimedia Foundation arbeitet seit Monaten daran, den Service zu ersetzen. Ursprünglich von einem Dritten erstellt, wurde OCG auf veraltetem Code ausgeführt, der in der Zukunft Sicherheitslücken und andere gravierende Probleme herbeiführen kann. Wenn wir eine PDF-Funktion haben wollen, müssen wir OCG leider ersetzen, sonst befinden wir uns möglicherweise plötzlich in einer Situation, in der wir den Service ungeplant abschalten müssen. Simply put, it's breaking down. Originally created by a third party, it currently runs on outdated code which may introduce security vulnerabilities and other major issues in the future. If we're to have the PDF functionality, we unfortunately have to replace it, or we might suddenly find ourselves in a situation where we'd have to take it down without having planned to do so.

Darüber hinaus unterstützt OCG eine Reihe von Anforderungen aus der Community nicht; die wichtigste davon ist die Fähigkeit, Tabellen darzustellen. Als passenden Ersatz haben wir einen neuen Service ausgewählt, den Electron Rendering Service. Unser nächster Schritt ist es, die Funktionen von OCG im Electron Rendering Service zu duplizieren. Im Folgenden werden die wichtigsten Teile der Funktionalität beschrieben, die wir als notwendig identifiziert haben. Wir möchten zum Gespräch darüber einladen, was fehlt oder was in der Liste überflüssig ist. Wir möchten außerdem auf unsere zukünftigen Pläne für die PDF-Erzeugung hinweisen, um auch dazu Feedback zu erhalten.

Bekannte Probleme

 * Es gibt derzeit einen Bug in Firefox (Upstream), der das Styling von Infoboxen betrifft, die über mehrere Seiten hinweg angezeigt werden. Der Fortschritt von Mozilla kann hier verfolgt werden: https://bugzilla.mozilla.org/show_bug.cgi?id=688556.

Nutzerbasis
Die folgende Tabelle zeigt den Datenverkehr (Traffic) zum Electron-Renderer, wenn die Funktion „Als PDF downloaden“ aufgerufen wird (über einen sechsstündigen Zeitraum). Der Datenverkehr wird nach Betriebssystem, Browser und der Browserversion aufgeschlüsselt (z. B. Windows 8, Chrome v61.*). Es ist klar erkennbar, dass der meiste Datenverkehr von Computern mit Windows kommt.

Aktuelle Funktionalitätsanforderungen
Im Folgenden findet sich eine Liste der aktuellen Anforderungen für das PDF-Rendering für Einzelartikel-PDFs und für Bücher. Die von der aktuellen Implementierung abweichenden Anforderungen werden fett dargestellt.

Historie

 * Die Erstellung von PDF-Artikeln und Büchern aus Wikipedia-Seiten erfolgt über einen Dienst namens OCG. Wenn "Bücher" mit den Buchgenerator erzeugt werden, greift dieser über die Mediawiki-Erweiterung Collection auf OCG zu. OCG hat verschiedene Probleme, besonders mit der Darstellung von Tabellen.
 * Verschiedene Probleme mit OCG wurden identifiziert, u.a. Beschwerden aus der Community rund um die fehlende Möglichkeit, mit OCG Tabellen darzustellen.
 * Tabellen in PDFs darzustellen ist Rang Nummer 9 auf der deutschsprachigen Technischen Wunschliste.
 * Wikimedia Deutschland beginnt damit, an einer Lösung zur Darstellung von Tabellen in PDFs zu arbeiten, und führt Electron PDF ein. Das Vorhaben ist, Electron PDF parallel zu OCG anzubieten, nicht OCG zu ersetzen.
 * Während Wikimedia Deutschland am Electron Service arbeitet, kommen die verantwortlichen Maintainer von OCG bei der Wikimedia Foundation zu der Schlussfolgerung, dass OCG ersetzt werden muss.
 * Das WMF Reading Team übernimmt die Verantwortung für die langfristige Wartung der PDF-Erstellung und beginnt mit der Planung, wie das Erzeugen von Tabellen in PDFs in alle Projekte implementiert werden kann.
 * Das Reading Team beginnt eine Befragung der Benutzerinnen und Benutzer, um Rückmeldungen zu Electron zu erhalten.
 * Die Teams Reading Infrastructure und Web beginnen eine genauere Betrachtung, was notwendig ist, um die Funktionen von OCG auf den Electron Service zu übertragen.

Update nach der Befragung von Benutzerinnen und Benutzern
Wir haben Anfang Juni 2017 um Rückmeldungen zur aktuellen Umsetzung des PDF-Renderers gebeten. Bei der Durchsicht der Rückmeldungen konnten wir folgende Beobachtungen machen:


 * Eine größere Anzahl von Leuten bevorzugte das einspaltige Format gegenüber dem zweispaltigen.
 * Jene, die das zweispaltige Format bevorzugen, hoben hervor, dass ihre Präferenz auf der Gestaltung und dem "Look-and-Feel" des Doppelspalten-Layouts basiert. Einige Benutzer äußerten auch Bedenken bzgl. Schriftgröße und Papierverschwendung beim Drucken von PDFs mit der einspaltigen Option.
 * Die folgenden Funktionen wurden gewünscht:
 * Funktionale Hyperlinks
 * Datum und URL, "diese Datei wurde heruntergeladen am [Datum] von [URL]"
 * Anpassbares CSS für Layout, Titel und Inhaltsverzeichnis
 * Zweispaltiges Format als Option
 * Bildversionen ein-/ausschließen
 * Veränderbare Ränder
 * Druck nach Abschnitten - erlaubt es, Einzelnachweise, ungewünschte Abschnitte, Index etc. zu entfernen
 * Textgröße einstellbar machen

Auf Basis der Rückmeldungen haben wir Folgendes in unsere neuen Printstile integriert:


 * Hyperlinks
 * Artikelinformation
 * kleinere Schriftgröße und buchähnliche Gestaltung

Der Rest der oben genannten Wünsche wird bis zur zweiten Iteration des PDF-Renderers verschoben. In dieser zweiten Iteration soll an einem Einstellungsmodus gearbeitet werden, der eine Anpassung anhand der verfügbaren Optionen ermöglicht.

Vorschlag
Im Folgenden werden Vorschläge für den Funktionsumfang der PDF-Erstellung gemacht:


 * PDFs zu einzelnen Artikeln werden über den Link "Als PDF herunterladen" in der Seitenleiste erzeugt.
 * PDFs mehrerer Artikel werden mit dem Buchgenerator-Werkzeug erstellt.
 * Alle Artikel enthalten Quellenangaben für Text und Bilder
 * Alle erzeugten PDFs sind in der Lage, Tabellen dazustellen.
 * Nutzerinnen und Nutzer können das Layout ihres PDFs individuell anpassen (optional).

Design
Die neuen PDF-Stile werden auf verbesserte Lesbarkeit ausgelegt. Je nach Community-Rückmeldungen und Ergebnissen der qualitativen oder quantitativen Tests wird eventuell eine Unterstützung von zweispaltigem Layout für den Buchgenerator und/oder Einzel-PDFs gebaut.

Plan für Entwicklung und Bereitstellung
Im Folgenden findet sich ein grober Überblick über den Ablauf von Entwicklung und Bereitstellung der Funktion. Änderungen vorbehalten.


 * 1) April - Mai 2017:
 * 2) Das Reading Team entwickelt die Backend-Unterstützung für die oben identifizierte Funktionalität.
 * 3) Die Benutzerinnen und Benutzer werden bei Erweiterung oder Verringerung des vorgeschlagenen Funktionsumfangs konsultiert.
 * 4) Ein qualitativer Test zur Gestaltung wird durchgeführt.
 * 5) Juni - Juli 2017:
 * 6) Neue Gestaltungsstile wurden eingebaut.
 * 7) Ein Prototyp für den PDF-Renderer (erste Iteration) wird gemeinsam mit OCG auf allen Projekten gestartet und die Performance wird verglichen.
 * 8) Iterationen auf der Grundlage von Nutzerbefragungen und identifizierten Grenzfällen
 * 9) August - September 2017:
 * 10) Zusätzliche Änderungen, falls nötig
 * 11) Oktober 2017:
 * 12) Zweite Iteration beginnt ohne OCG auf allen Projekten

Einzelne Artikel

 * Ein PDF für einen einzelnen Artikel wird erstellt, indem man den Link "Als PDF herunterladen" auswählt.
 * Mit der Auswahl von "Als PDF herunterladen" wird die PDF-Datei erzeugt. Um die Datei herunterzuladen, wählt man den Link "Herunterladen".
 * Jede PDF-Datei wird folgendes enthalten:
 * Titel und Text des Artikels
 * Infobox (falls vorhanden)
 * Tabelle (falls vorhanden)
 * einspaltiges Layout
 * Seitenzahl
 * Alle Bilder und Bildunterschriften des Artikels
 * Links auf Seiten, die im Artikel verlinkt sind (blaue Links und externe Links)
 * Text- und Bildquellen, Beiträge und Lizenzen

Phabricator Tracking
Alle PDF-bezogenen Änderungen, einschließlich des Auslaufens von OCG, des Ersetzens des Electron-PDF-Renderers und aller Aktualisierungen von Büchern oder der Sammlungserweiterung, werden unter dem phabricator-Projekt Protonverfolgt. Auf der Projektseite werden die letzten Aktualisierungen für alle Aufgaben im Zusammenhang mit PDFs angezeigt.

Im Oktober 2017 verfügbare Funktionalität
Hinweis: Zum jetzigen Zeitpunkt werden keine Änderungen am aktuellen Buchgenerator vorgenommen.


 * Benutzer starten den Buchgenerator, indem sie "Buch erstellen" auswählen.
 * Dadurch wird zur aktuellen Seite zum Erstellen von Büchern navigiert.
 * Um ein Buch herunterzuladen, klicken Benutzer auf den Link "Herunterladen" auf der Seite des Buchgenerators.
 * Benutzer können Bücher nur im PDF-Format herunterladen.
 * Über die Elemente der Einzelartikel-PDFs hinaus enthalten Bücher:
 * Titelseite des Buches
 * Die Einzelnachweise für jeden Artikel des Buches erscheinen am Ende des jeweiligen Artikels.
 * Jeder Artikel beginnt auf einer neuen Seite.
 * Ein einziger Abschnitt für Text- und Bildquellen, Mitwirkende und Lizenzen, der die gesammelten Beiträge aus allen Artikeln enthält.

Funktionalität, die im November/Dezember 2017 verfügbar ist

 * Bücher werden ein Inhaltsverzeichnis mit Seitenzahlen enthalten.
 * Wenn man einen Abschnitt im Inhaltsverzeichnis auswählt, navigiert man zum entsprechenden Abschnitt innerhalb des Buches.

Die Formatvorlagen für Bücher werden für eine bessere Lesbarkeit aktualisiert

Alternative
Es gibt eine alternative Möglichkeit zum Exportieren von MediaWiki to LaTeX, PDF, ODT und EPUB:

http://mediawiki2latex.wmflabs.org/

Die Rechenressourcen des Servers sind begrenzt.

Wenn du Ubuntu Linux verwendest und schnellere Ergebnisse wünscht, kannst du das  or   installieren.