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 2017 – September 2017
 * 10) Additional changes made if necessary
 * 11) October 2017
 * 12) Second iteration launched without OCG on all projects

Current Functionality Requirements
The following is a list of the current requirements for PDF rendering for single-article PDF's and for books. The requirements different from the current implementation are displayed in bold.

Single Articles

 * A PDF for a single article will be created by selecting the "Download as PDF" link
 * Upon selecting "Download as PDF", the PDF file will be generated. To download the file, users will select the "Download the file link"
 * Each PDF file will contain the following:
 * Article title and text
 * Infobox(if any)
 * Tables (if any)
 * Single-column layout
 * Page number
 * All article images and captions
 * Links to pages linked from the article (blue links and external links)
 * Text and image sources, contributors, and licenses

Functionality available in October, 2017
Note: no changes will be made to the current book creator workflow at this time
 * User will launch the books creator by selecting "Create a book"
 * This will navigate to the current book creation page
 * To download a book, users will select the "download" link from the books page
 * Users may only download books in PDF format
 * Books will contain all elements from single article format as well as:
 * Book title page
 * 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