Fonctionnalité de lecture/Web/PDF

< Reading‎ | Web
Jump to navigation Jump to search
This page is a translated version of the page Reading/Web/PDF Functionality and the translation is 10% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎tarandíne • ‎русский • ‎العربية • ‎فارسی • ‎हिन्दी • ‎বাংলা • ‎ગુજરાતી • ‎ไทย • ‎ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어

Update on PDF rendering, July 15 2019

We’ve launched the new PDF renderer. We’re looking at feedback, but haven't so far seen any significant issues. We might incorporate some suggestions, but want to note that this is not an ongoing project with continuous development. In other words, now that it's deployed and proven to work, the new renderer is entering maintenance mode. The talk page of this page won’t be abandoned, but it could take a while before anyone reacts, simply because everyone's got so much else on their plate.

In terms of books, we've left it in the hands of volunteer developers and PediaPress. We'll be glad to reach out to them with questions, but we're not planning any involvement in terms of the technical implementation.

Mise à jour du rendu PDF, le 4 juin 2019

We have deployed the new renderer for single-article PDFs for all projects. We hope this will resolve the issues associated with the Electron renderer, which was often unable to generate PDFs as expected. Please feel free to try out the new renderer and let us know if you have questions or come across any bugs or other issues.

Update on PDF rendering, March 18 2019

We're getting close to the deployment of our new renderer, Proton, with only a few tasks remaining as blockers (as can be seen in the task graph in phab:T181084). We will post another update once the deployment date is set. This renderer will replace the electron renderer as the default PDF renderer for single-page PDFs.

Mise à jour du 17 août 2018

Sample book from PediaPress

Voici un exemple actualisé et plus complet du nouveau service de rendu de livres. La mise en page a considérablement changé depuis la première version présentée lors de Wikimania. Merci pour tous les retours. L'export présente encore un certain nombre de problèmes : sauts de page, infoboxes, tableaux et formules mathématiques doivent être substantiellement améliorées. Cet exemple centré sur les différents systèmes d'écritures et les formules mathématiques révèle certains des problèmes qu'il reste à résoudre. Actuellement les formules sont rendues en utilisant MathML, utiliser LaTeX à la place devrait améliorer significativement le résultat.

Update on books, August 8 2018

We have been working with PediaPress on generating and styling the new books. They have provided us with a sample of the current output, which will be very similar to the final version. We discussed points of improvement with the PediaPress team, which they are addressing currently. If you have any feedback or other comments on these samples, please let us know on the talk page.

Update on books, April 2018

Books functionality will be returning via PediaPress. 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 January 2018

We're currently preparing performance tests of the PDF to book function. We should know more in early February.

Actualisation de septembre 2017

Notre actuel service de rendu en pdf, l'offline content generator (OCG) ne sera plus maintenu et cessera de fonctionner. L'équipe reading team de la fondation Wikimédia a travaillé plusieurs mois pour le remplacer. OCG, créé à l'origine comme une implémentation tierce partie, fonctionnait avec un code obsolète susceptible d'introduire des vulnérabilités et d'autres problèmes majeurs dans le futur. Durant les trois derniers mois, nous avons placé des bandeaux sur la page de création des pdf afin d'obtenir de l'information en retour concernant le prototype de notre nouveau moteur de rendu. Ce dernier aura des fonctionnalités améliorées, il pourra rendre les tableaux et les infoboxes et utilisera des styles visant à une meilleure lisibilité. Nous avons réuni une bonne quantité de commentaires positifs à propos du prototype et nous travaillons pour incorporer les actualisations nécessaires pour nos nouveaux pdf.

Later addendum: Turning PDF book rendering OFF for the short term

Malheureusement, les problèmes majeurs que rencontre notre ancien moteur de rendu (OCG) obligent à le supprimer avant de pouvoir terminer la fonction de création de livres. Cela se produit plus tôt que nous le pensions. Au moment où nous supprimerons OCG, le travail nécessaire pour la création de fichier à partir d'un seul article sera terminé. Néanmoins, il manquera quelques fonctionnalités au rendu de livres, telles que les feuilles de style et la table des matière. Nous allons travailler pour que cela soit disponible dans les mois à venir et espérons proposer des fonctionnalités complètes en novembre-décembre 2017.


  • Release of full-featured renderer for single articles (print to pdf) – Oct 1, 2017
  • Pausing book PDF rendering – Oct 1, 2017
  • Sunsetting of OCG renderer – Oct 1, 2017
  • Release of new PDF renderer – Jan, 2018 (tentative based on research results into alternative rendering systems)

Fonctionnalité :

For a full list of current and upcoming functionality, see below.

In addition to this page being updated, this will be communicated in a banner on PDF creation page, in Tech News and on some Wikimedia mailing lists.


Notre moteur de rendu PDF actuel, le offline content generator, n'est plus maintenable. En termes simples, il est en panne. Créé initialement par un tiers, il fonctionne actuellement avec un code obsolète qui pourrait introduire des vulnérabilités de sécurité et d'autres problèmes majeurs à l'avenir. Si nous voulons conserver la fonctionnalité de création de PDF, nous devons le remplacer, ou nous pourrions soudnainement nous retrouver dans une situation où nous devrions le désactiver sans avoir une alternative.

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 identified as necessary. We would like to invite conversation around what is missing or what is superfluous in the provided list. We would also like to highlight over our future plans for PDF rendering to gather initial feedback.

Known Issues


The following table shows a sample of traffic to the Electron "Download as PDF" service for over a 6 hour period. The traffic is broken down by operating system (OS), browser, and the browser major version (e.g. Windows 7, Chrome v61.*). Note well that the majority of our traffic appears to come from Windows based machines.

OS Browser Browser Major Version % of requests
Other Other - 14.38
Windows 7 Chrome 61 12.42
Windows 10 Chrome 61 8.83
Windows 7 IE 11 7.33
Windows 7 Firefox 56 6.59
Windows 10 Firefox 56 3.82
Windows 10 Edge 15 3.24
Windows 8.1 Chrome 61 3.07
Windows XP Chrome 49 2.2
Windows 10 Chrome 59 1.53
Windows 10 IE 11 1.51
Windows 8.1 Firefox 56 1.31
Windows XP Firefox 52 1.22
Windows 8 Chrome 61 1.15
Windows 8.1 IE 11 1.15
Mac OS X Safari 11 0.9
Windows 7 Firefox 53 0.89
Windows 7 Firefox 52 0.78
Ubuntu Firefox 56 0.78
Windows XP IE 6 0.7
Windows 7 Chrome 55 0.68
Windows 7 Firefox 55 0.62
Mac OS X Chrome 61 0.62
Android UC Browser 11 0.6
Windows 10 Edge 14 0.59
Windows 7 Opera 48 0.53
Android Chrome Mobile 61 0.49
Windows 10 Opera 48 0.44
Windows 7 Chrome 60 0.4
Windows Vista Chrome 49 0.39
Windows 7 Yandex Browser 17 0.37
Windows 10 Firefox 55 0.37
Mac OS X Safari 10 0.36
Windows 10 Chrome 50 0.34
Android Android 4 0.33
Mac OS X Firefox 56 0.33
Windows 10 Chrome 60 0.32
Windows 8.1 Chrome 43 0.3
Android Amazon Silk 60 0.29
Windows 7 Sogou Explorer 1 0.27
Windows 8 IE 10 0.26
Windows 7 IE 8 0.26
Windows 7 IE 9 0.25
Windows 8 Opera 12 0.25
Linux Firefox 52 0.25
Mac OS X Firefox 53 0.24
Windows 7 Firefox 45 0.24
Windows 10 Firefox 57 0.24
Windows 7 Firefox 38 0.22
Windows 10 Firefox 47 0.21

Exigences de la fonctionnalité actuelle

Voici une liste des exigences actuelles pour le rendu en PDF des documents PDF en un seul article et pour les livres. Les exigences différentes de l'implémentation actuelle sont affichées en gras.

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.


  • Le rendu des articles en PDF et des livres provenant des pages de Wikipedia est géré par un service appelé OCG. Lorsque vous créez des "livres" à travers le créateur de livre, il utilise OCG intégré dans l'extension Collection. OCG a plusieurs problèmes, en particulier avec des tableaux.
  • 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 identified, including complaints from the community around OCG's inability to render tables.
  • Rendering of tables ranks as number 9 on the German-speaking Community Technical Wishlist.
  • Wikimedia Deutschland begins on working on a solution for rendering tables in PDF's, and introduces Electron. They do this planning to run it alongside OCG, not to replace it.
  • 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 responsibility for the long term maintenance of PDF rendering begins plans on implementing table rendering across all projects.
  • The Reading team launches a community consultation for gathering feedback on Electron.
  • The Reading Infrastructure and Web teams begin scoping the working necessary to port OCG functionality over to the Electron service.

Update After Consultation

Proposed PDF and print styles based on feedback from 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.


Voici une proposition pour la portée des fonctionnalités nécessaires au rendu PDF :

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 images
  • All PDFs rendered will be able to print tables
    • Users will be able to customize the layout of their PDF (optional)

Differences between current and future implementation

OCG New Service Notes
Rendering individual articles Yes Yes
Rendering multiple articles using the book creator Yes Yes
Contains table of contents for multiple articles Yes Yes
Renders tables No Yes
Attribution Yes Yes Open question: location of attribution within the new service
Styling Latex New styles
N-column layout Yes No
Default 2-column layout Yes Tentative Default one column or two-column layout will be chosen based on feedback and quantitative and/or qualitative testing
Output format PDF, Plaintext PDF Only


The new PDF styles will be designed for increased readability. 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.

Feuille de route de développement et de déploiement

Voici une description détaillée de la feuille de route de développement et de déploiement. Elle est sujet à changements.

The following is a rough outline of the development and deployment roadmap. It is subject to change.

  1. April – May 2017:
    1. The Reading team builds back-end support for functionality identified above
    2. Communities are consulted on expanding or shrinking proposed functionality
    3. Qualitative test performed for styling
  2. June – July 2017:
    1. New styles implemented
    2. First iteration is launched along with OCG on all projects and performance is compared
    3. Iterations based on consultations and identified edge cases
  3. August 2017 – September 2017
    1. Additional changes made if necessary
  4. October 2017
    1. Second iteration launched without OCG on all projects

Articles individuels

  • Un PDF par article sera créé en sélectionnant le lien « Télécharger en PDF »
  • 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)
    • Tableaus (if any)
    • Single-column layout
    • Numéro de page
    • All article images and captions
    • Links to pages linked from the article (blue links and external links)
    • Text and image sources, contributors, and licenses

Phabricator Tracking

All PDF-related changes including sunsetting OCG, replacing the Electron PDF renderer, and any updates to books or the collections extension are tracked under the phabricator project Proton. The project page will display any recent updates for all tasks related to PDFs.


Fonctionalité disponible à partir d'octobre 2017

Note : aucune modification ne sera apportée au flux de travail courant du créateur de livres à l'heure actuelle

  • 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

  • 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

Styles for books will be updated for improved readability


There is an alternative way of exporting MediaWiki to LaTeX, PDF, ODT and EPUB:

The computational resources on the server are limited.

If you run Ubuntu Linux and want results faster, you can install the m2l-pyqt or mediawiki2latex packages.