Reading/Web/PDF Functionality
Please read the plans for the PDF service below and tell
us on the discussion page if we are missing anything, or
if theres anything that we plan to work on that is actually
unnecessary.
1 Introduction[edit]
Our current PDF rendering service, the oine content
generator, is no-longer maintainable. Simply put, its
breaking down. Originally created by a third party, it cur-
rently runs on outdated code which may introduce secu-
rity 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 nd ourselves in a
situation where we'd have to take it down without having
planned to do so.
Additionally, it does not support a number of rendering
requests from the community, the main one being the
ability to render tables. We have selected a new service,
the electron rendering service, as a suitable replacement.
Our next step is to duplicate the functionality provided
by OCG using the electron rendering service. Below, we
will describe the main portions of the functionality we
have identied as necessary. We would like to invite con-
versation around what is missing or what is superuous in
the provided list. We would also like to highlight over our
future plans for PDF rendering to gather initial feedback.
2 History[edit]
Rendering PDF articles and books from Wikipedia
pages is handled by a service called OCG. When
rendering books through the book creator, it uses
OCG as embedded within the Collection extension.
OCG has multiple issues, especially with tables.
Multiple issues with OCG are identied, including
complaints from the community around OCGs in-
ability to render tables.
Rendering of tables ranks as number 9 on the
German-speaking Community Technical Wishlist.
Wikimedia Deutschland begins on working on a tation
solution for rendering tables in PDFs, and intro-
duces Electron. They do this planning to run it We launched a consultation on the current implementa-
alongside OCG, not to replace it. tion of the PDF renderer in early June, 2017. After re-
1
At the same time as Wikimedia Deutschland is
working on the Electron service, the responsible
maintainers of the OCG service at the Wikimedia
Foundation come to the conclusion that OCG has to
be replaced.
The WMF Reading Team takes over the responsibil-
ity for the long term maintenance of PDF rendering
begins plans on implementing table rendering across
all projects.
The Reading team launches a community consulta-
tion for gathering feedback on Electron.
The Reading Infrastructure and Web teams begin
scoping the working necessary to port OCG func-
tionality over to the Electron service.
3 Update After Consultation
Berlin
Berlin (/brln/, German: [blin]( listen)) is the capital and the largest city of Berlin
Germany as well as one of its 16 constituent states. With a population of
approximately 3.7 million,[4] Berlin is the second most populous city proper and the
State of Germany
seventh most populous urban area in the European Union.[5] Located in
northeastern Germany on the banks of the rivers Spree and Havel, it is the centre of
the Berlin-Brandenburg Metropolitan Region, which has roughly 6 million residents
from more than 180 nations.[6][7][8][9] Due to its location in the European Plain,
Berlin is influenced by a temperate seasonal climate. Around one-third of the city's
area is composed of forests, parks, gardens, rivers, canals and lakes.[10]
First documented in the 13th century and situated at the crossing of two important
historic trade routes,[11] Berlin became the capital of the Margraviate of
Brandenburg (14171701), the Kingdom of Prussia (17011918), the German
Empire (18711918), the Weimar Republic (19191933) and the Third Reich
(19331945).[12] Berlin in the 1920s was the third largest municipality in the
world.[13] After World War II and its subsequent occupation by the victorious
countries, the city was divided; East Berlin was declared capital of East Germany,
while West Berlin became a de facto West German exclave, surrounded by the Berlin
Wall (19611989) and East German territory.[14] Following German reunification in
1990, Berlin once again became the capital of all-Germany.
Berlin is a world city of culture, politics, media and science.[15][16][17][18] Its
economy is based on high-tech firms and the service sector, encompassing a diverse
range of creative industries, research facilities, media corporations and convention
venues.[19][20] Berlin serves as a continental hub for air and rail traffic and has a
highly complex public transportation network. The metropolis is a popular tourist
destination.[21] Significant industries also include IT, pharmaceuticals, biomedical
engineering, clean tech, biotechnology, construction and electronics.
Modern Berlin is home to world renowned universities, orchestras, museums,
From top: Skyline including the TV Tower,
City West, Brandenburg Gate,
East Side Gallery (Berlin Wall), Oberbaum Bridge (River Spree),
entertainment venues and is host to many sporting events.[22] Its urban setting has
made it a sought-after location for international film productions.[23] The city is
well known for its festivals, diverse architecture, nightlife, contemporary arts and a
Reichstag building (Bundestag)
high quality of living.[24] Since the 2000s Berlin has seen the emergence of a
cosmopolitan entrepreneurial scene.[25]
Flag
Coat of arms
Location within European Union and Germany
Proposed PDF and print styles based on feedback from consul-
2 4
viewing the consultation responses, we have made the fol-
lowing observations:
A larger number of users preferred the single-
column format over the double column format 4.2
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 PDFs 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
Modiable margins
print by section - allows you to remove refer-
ences, paragraphs you dont want, index, etc
allowing congurable text size
Based on the feedback, we have incorporated the follow-
ing 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 cus-
tomization of the available options.
4 Proposal[edit]
The following is a proposal for the scope of functionality
necessary for PDF rendering:
Individual articles will be rendered to PDF using the
Download as PDF link in the sidebar
Multiple articles will be rendered to PDF using the
Book Creator tool
All articles will contain attribution for text and im-
ages
All PDFs rendered will be able to print tables
Users will be able to customize the layout of
their PDF (optional)
PROPOSAL[EDIT]
4.1 Dierences between current
and future implementation[edit]
Design[edit]
The new PDF styles will be designed for increased read-
ability. Based on community feedback and qualitative or
quantitative testing, support for a 2-column layout may
be built for the book creator and/or for individual PDFs.
Moon
From Wikipedia, the free encyclopedia
The Moon is Earth's only permanent natural satellite. Moon
It is the fifth-largest natural satellite in the Solar
System, and the largest among planetary satellites
relative to the size of the planet that it orbits (its
primary). It is the second-densest satellite among those
whose densities are known (after Jupiter's satellite Io).
The Moon is thought to have formed approximately
4.5 billion years ago, not long after Earth. There are
several hypotheses for its origin; the most widely
accepted explanation is that the Moon formed from the
debris left over after a giant impact between Earth and
a Mars-sized body called Theia.
The Moon is in synchronous rotation with Earth,
always showing the same face, with its near side
Full Moon as seen from Earth's northern
hemisphere
Designations
marked by dark volcanic maria that fill the spaces
between the bright ancient crustal highlands and the
Adjectives
lunar
prominent impact craters. It is the second-brightest
regularly visible celestial object in Earth's sky after the
Sun, as measured by illuminance on Earth's surface. Its
selenic
Orbital characteristics
surface is actually dark (although it can appear a very Perigee 362 600km
(356 400370 400km)
bright white) with a reflectance just slightly higher
Apogee 405 400km
than that of worn asphalt. Its prominence in the sky
and its regular cycle of phases have made the Moon an
(404 000406 700km)
Semi-major axis 384 399km(0.002 57AU)[1]
important cultural influence since ancient times on
language, calendars, art, and mythology.
Eccentricity
Orbital period
0.0549[1]
27.321 661d
The Moon's gravitational influence produces the ocean (27d 7h 43.19min 11.5s[1])
tides, body tides, and the slight lengthening of the day. Synodic period 29.530 589d
(29d 12h 44min 2.9s)
The Moon's current orbital distance is about thirty
times the diameter of Earth, with its apparent size in
Average orbital
speed
1.022km/s
the sky almost the same as that of the Sun, resulting in Inclination 5.145 to the ecliptic[2][a]
the Moon covering the Sun nearly precisely in total Longitudeof regressing by one revolution in
ascendingnode 18.6years
Examples
of new PDF output - Styles will be updated based
on feedback from the ongoing consultation
Bitstream Charter
From Wikipedia, the free encyclopedia
BitstreamCharter is a serif typeface designed by
Matthew Carter in 1987 for Bitstream Inc.[1] Charter
Bitstream Charter
is based on Pierre-Simon Fourniers characters,
originating from the 18th century.[2] Classified by
Bitstream as a transitional-serif typeface (Bitstream
Transitional 801), it also has features of a slab-serif
typeface and is often classified as such.[3][4]
Charter was originally optimized for printing on the
low-resolution 300 dpi laser printers of the 1980s,
and remains suitable for printing on both modern
high-resolution laser printers and inexpensive lower
resolution inkjet printers due to its strong, legible
design. Its structure was optimised for low-memory Category Serif
computers and printers. In a 2013 interview, Carter Classication
Transitional serif
explained that it used "a very simplified structure and
a minimum number of curves, more straight-line Slab-Serif
segments... very economical compared to, say, Times
New Roman," but noted that rapid development of
Designer(s)
Foundry
Matthew Carter
Bitstream Inc.
printers made this unnecessary even before he had
finished the design.[5] In its simplification of serif
Date created
License
1987
[1]
forms, it anticipates Carter's later landmark design,
Georgia for Microsoft.
In 1992 Bitstream donated a version of Charter, along with its version of Courier, to the X
Consortium under terms that allowed the font to be modified and redistributed. This has resulted in
open source derivatives of Bitstream Charter, including Charis SIL.[6] Some consider Bitstream
Charter to be one of the best free fonts available.[7]
Due to its popularity, a new Charter Pro release of the typeface was released in 2004, with an
expanded character set including additional symbols, ranging figures (old-style) and small capitals.
[8]
This version was later added as a system font on OS X.
6.2 Books[edit] 3

5 Development and Deployment All article images and captions

Roadmap[edit] Links to pages linked from the article (blue
links and external links)
The following is a rough outline of the development and Text and image sources, contributors, and li-
deployment roadmap. It is subject to change. censes

1. April May 2017:

6.2 Books[edit]
(a) The Reading team builds back-end support for
functionality identied above Note: no changes will be made to the current book creator
workow at this time
(b) Communities are consulted on expanding or
shrinking proposed functionality
User will launch the books creator by selecting Cre-
(c) Qualitative test performed for styling ate a book
2. June July 2017: This will navigate to the current book creation page
(a) New styles implemented To download a book, users will select the down-
(b) First iteration is launched along with OCG on load link from the books page
all projects and performance is compared
Users may only download books in PDF format
(c) Iterations based on consultations and identied
edge cases Books will contain all elements from single article
format as well as:
3. August 2017 September 2017
Book title page
(a) Additional changes made if necessary
Table of contents with page numbers
4. October 2017 Selecting a section from the table of con-
(a) Second iteration launched without OCG on all tents will navigate the user to the corre-
projects sponding section within the book
The references for each article from the book
will appear at the end of the article
6 Current Functionality Each article will begin on a new page
Requirements[edit] A single section for text and image sources,
contributors, and licenses, that contains the
The following is a list of the current requirements for PDF collected contributions from all articles
rendering for single-article PDFs and for books. The re-
quirements dierent from the current implementation are
displayed in bold.

6.1 Single Articles[edit]

A PDF for a single article will be created by selecting
the Download as PDF link

Upon selecting Download as PDF, the PDF le

will be generated. To download the le, users will
select the Download the le link
Each PDF le will contain the following:
Article title and text
Infobox(if any)
Tables (if any)
Single-column layout
Page number
4 7 TEXT AND IMAGE SOURCES, CONTRIBUTORS, AND LICENSES

7 Text and image sources, contributors, and licenses

7.1 Text
Reading/Web/PDF Functionality Source: https://www.mediawiki.org/wiki/Reading/Web/PDF_Functionality?oldid=2536364 Contrib-
utors: Julle, AKlapper (WMF), SamanthaNguyen, Syum90, Mainframe98, Johan (WMF), OVasileva (WMF), Flex Darwin, Tonpar098,
JackBlack85, ESHTIAQUE HASAN, Ugande Dominic Liambee, M4515 1 and Anonymous: 8

7.2 Images
File:Berlin_-_Wikipedia.pdf Source: https://upload.wikimedia.org/wikipedia/commons/4/44/Berlin_-_Wikipedia.pdf License: CC BY-
SA 3.0 Contributors: Wikimedia Foundation Original artist: Nirzar Pangarkar
File:Moon.pdf Source: https://upload.wikimedia.org/wikipedia/commons/c/c5/Moon.pdf License: CC BY-SA 4.0 Contributors: Own
work Original artist: Melamrawy (WMF)
File:PDF_screenshot_of_charter_typeface.pdf Source: https://upload.wikimedia.org/wikipedia/commons/5/58/PDF_screenshot_of_
charter_typeface.pdf License: CC BY-SA 4.0 Contributors: Own work Original artist: Melamrawy (WMF)

7.3 Content license

Creative Commons Attribution-Share Alike 3.0