Reading/Web/PDF Functionality/pt

Por favor leia abaixo os planos para os serviços de PDF e diga-nos na Página de discussão se estivermos a deixar passar alguma coisa, ou se existe qualquer coisa que planeamos trabalhar nela que se possa dispensar.

Introdução
O nosso actual serviço de visualização de PDF, o offline content generator, deixou de ser suportado, isto é, está disfuncional. Originalmente criado por terceiros, actualmente roda um código desactualizado que pode inserir vulnerabilidades e outros problemas sérios no futuro. Se nós tivermos que ter a funcionalidade PDF, nós infelizmente temos de substituí-la, ou seremos seremos surpreendidos por uma situação em que teríamos de retirar repentinamente a funcionalidade do ar, sem aviso prévio, ou nenhuma previsão.

Além disso, esta funcionalidade não suporta o número de solicitações vindo da comunidade, a principal sendo a A capacidade de visualizar tabelas. Nós seleccionamos um novo serviço, the electron rendering service, como um substituto favorável. O nosso próximo passo será duplicar a funcionalidade fornecida pela OCG utilizando o electron rendering service. Abaixo, descreveremos as porções principais da funcionalidades que identificamos como necessárias. Gostaríamos de convidar acerca das funcionalidades que possam estar em falta, e que acredita que possam ser adicionadas por serem úteis, ou o que dispensável, na lista fornecida. Nós gostaríamos igualmente de realçar sobre os nossos futuros planos para o visualizador de PDF para juntar a conversação de abordagem.

História

 * A visualização de artigos e livros das páginas da Wikipedia são feitas por um serviço chamado OCG. Quando estiver a visualizar "livros" através do book creator, utiliza o OCG como um sistema inserido com a extensão Collection. OCG has multiple issues, especialmente com tabelas.
 * Múltiplos problema com OCG estã identificados, incluindo os abordados pela comunidade à volta da inabilidade de mostrar tabelas do OCG.
 * Visualizador de tabelas, classifica-se como o número 9 na lista de Comunidade Germânica da Technical Wishlist - German-speaking Community Techical Wishlist.
 * A Wikimedia Deutschaland começa a trabalhar na solução para o visualizador de tabelas em PDF's, e introduz o Electron. Eles fazem-no para rodar junto do OCG, e não para substituí-lo.
 * Ao mesmo tempo que Wikimedia Deutschaland está trabalhado no serviço Electron, os manutensores responsáveis do serviço OCG na Wikimedia Foundation chegam a conclusão que o OCG tem de ser substituído.
 * A WMF Reading Team que assumiu a responsabilidade de manutenção a longo termo do visualizador de PDF, começa por planear a implementação do visualizador de tabelas sobre todos os projectos.
 * O Reading team lança a Comunidade de consulta para juntar os retornos das conversas em relação ao Electron.
 * A Reading Infrastructure and Web teams começam por delimitar o trabalho necessário para portabilizar a funcionalidade OCG sobre o serviço Electron.

Proposta
A seguinte e a proposta para escopo da funcionalidade necessária para visualizar o PDF.
 * Artigos individuais serão visualizados em PDF utilizando o link Download as PDF na barra lateral.
 * Múltiplos artigos serão visualizados para PDF utilizando a ferramenta Book Creator.
 * Todos os artigos contêm atribuição para textos e imagens.
 * Todos os PDFs mostrados poderão imprimir tabelas.
 * Utilizadores poderão personalizar o layout dos respectivos PDFs (opcional).

Design
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.

Development and Deployment Roadmap
The following is a rough outline of the development and deployment roadmap. It is subject to change.
 * 1) April – May 2017:
 * 2) The Reading team builds back-end support for functionality identified above
 * 3) Communities are consulted on expanding or shrinking proposed functionality
 * 4) Qualitative test performed for styling
 * 5) June – July 2017:
 * 6) New styles implemented
 * 7) First iteration is launched along with OCG on all projects and performance is compared
 * 8) Iterations based on consultations and identified edge cases
 * 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

Books
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
 * 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
 * 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