Reading/Web/PDF Functionality/de

Update September 2017
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 große Probleme herbeiführen kann. In den letzten drei Monaten wurde auf der PDF-Erstellungsseite um Rückmeldung zu dem Prototyp für einen neuen PDF Rendering Service gebeten. Der neue Renderer soll gegenüber OCG verbesserte Funktionen haben – 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 Updates für unsere neuen PDFs zu machen.

Leider machen es große Probleme mit unserem alten Renderer (OCG) nötig, ihn schon jetzt als Option zur Erstellung von PDFs abzuschalten, noch bevor die notwendigen Updates für die Buchfunktion abgeschlossen sind. Das ist früher, als wir wollten. Zu dem Zeitpunkt, an dem OCG abgeschaltet wird, werden die Arbeiten für die Erstellung von einzelnen PDFs ("Als PDF herunterladen") abgeschlossen sein. Für das Erstellen von Büchern fehlen allerdings noch einige Funktionen, insbesondere die Gestaltung und das Inhaltsverzeichnis betreffend. Wir werden daran arbeiten, die Buchfunktion in den folgenden Monaten auszubauen und hoffen, sie in vollem Umfang im November-Dezember 2017 freizugeben.

Zeitplan:
 * Bereitstellung des PDF-Renderers mit vollem Funktionsumfang für einzelne Artikel (als PDF drucken) - 1. Oktober 2017
 * Bereitstellung eines OCG-Ersatzes für die Bucherstellung - 1. Oktober 2017
 * Abschalten des OCG-Renderers - 1. Oktober 2017
 * Bereitstellung des Renderers für die Buchfunktion mit vollem Funktionsumfang - 1. Oktober 2017

Funktionalität:

Für eine vollständige Liste der aktuellen und bevorstehenden 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 große 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.

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 wir die wichtigsten Teile der Funktionalität beschreiben, die wir als notwendig identifiziert haben. Wir möchten Gespräch darüber einladen, was fehlt oder was in der angegebenen Liste überflüssig ist. Wir möchten außerdem auf unsere zukünftigen Pläne für die PDF-Erzeugung hinweisen, um auch dazu ein Feedback zu erhalten.

Vorgeschichte
OCG hat verschiedene Probleme, besonders mit der Darstellung von Tabellen.
 * Die Erstellung von PDF-Artikeln und Büchern aus Wikipedia-Seiten erfolgt über einen Dienst namens OCG. Wenn "Bücher" durch den Buchgenerator erzeugt werden, verwendet dieser OCG über die Mediawiki-Erweiterung Collection.
 * 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 Wunsch 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 Community, 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 After Consultation
We launched a consultation on the current implementation of the PDF renderer in early June, 2017. After reviewing the consultation responses, we have made the following observations:
 * A larger number of users preferred the single-column format over the double column format
 * Users which prefered the double-column format highlighted that their preference was based in the styling and look and feel of double columns. Some users also expressed concerns with font size and wasting paper when printing PDF's in the single-column option
 * The following feature requests were made:
 * Functional hyperlinks
 * Date and url, 'this page downloaded [date] from [URL]'
 * Customizable css for layout, title, TOC
 * Option for 2 column format
 * Include/exclude images versions
 * Modifiable margins
 * print by section - allows you to remove references, paragraphs you don’t want, index, etc
 * allowing configurable text size

Based on the feedback, we have incorporated the following into our new print styles:
 * hyperlinks
 * article information
 * smaller font and book-like styling

The remainder of the requests above will be postponed until the second iteration of the PDF renderer, in which we plan to build a settings mode that will allow for customization of the available options.

Vorschlag
Das Folgende ist ein Vorschlag für den Funktionsumfang, der für das Erzeugen von PDFs benötigt wird:
 * 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 Plan für Entwicklung und Bereitstellung. Änderungen vorbehalten.
 * 1) April - May 2017:
 * 2) Das Reading Team baut die Backend-Unterstützung für die oben identifizierte Funktionalität.
 * 3) Die Communitys werden bei Erweiterung oder Verringerung der vorgeschlagenen Funktionalität konsultiert.
 * 4) Ein qualitativer Test zur Gestaltung wird durchgeführt.
 * 5) Juni - Juli 2017:
 * 6) Neue Gestaltungsstile werden eingebaut.
 * 7) Die erste Iteration wird zusammen mit OCG auf allen Projekten gestartet und die Performance wird verglichen.
 * 8) Iterationen auf der Grundlage von Konsultationen 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

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.

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ählen die Nutzenden den Link "Herunterladen".
 * Jede PDF-Datei enthält Folgendes:
 * Titel und Text des Artikels
 * Infobox(falls vorhanden)
 * Tabelles (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, Beitragende und Lizenzen

Funktion verfügbar im Oktober 2017
Hinweis: Zum jetzigen Zeitpunkt werden keine Änderungen am aktuellen Buchgenerator vorgenommen.
 * Nutzende 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 Nutzende auf den Link "Herunterladen" auf der Seite des Buchgenerators.
 * Nutzende können Bücher nur im PDF-Format herunterladen.
 * Über die Elemente der Einzelartikel-PDFs hinaus enthalten Bücher:
 * Titelseite des Buches
 * The references for each article from the book will appear at the end of the article
 * Each article will begin on a new page
 * A single section for text and image sources, contributors, and licenses, that contains the collected contributions from all articles

Functionality available in November - December, 2017
Styles for books will be updated for improved readability __INDEX__ __NEWSECTIONLINK__
 * Books will contain a table of contents with page numbers
 * Selecting a section from the table of contents will navigate the user to the corresponding section within the book