Reading/Web/PDF Functionality/pt

Atualização Janeiro 2018
Estamos preparando testes de performance para a função de livro em PDF. Saberemos mais no início de fevereiro

Atualização setembro de 2017
O nosso serviço atual de composição de PDF, o gerador de conteúdo fora de linha (OCG) deixará de ser mantido. Por outras palavras, irá deixar de funcionar. A equipa de leitura da Wikimedia Foundation trabalha há meses para substituí-lo. O OCG tem funcionado com código desatualizado que pode criar vulnerabilidades de segurança e outros problemas sérios no futuro. Durante os últimos três meses apresentámos banners na página de criação de PDF solicitando comentários sobre o protótipo do nosso novo compositor. O novo compositor terá funcionalidades melhoradas de OCG — irá imprimir tabelas e caixas informativas, e elementos estilísticos focados na melhoria da legibilidade. Recebemos uma grande quantidade de comentários sobre o protótipo e estamos a fazer as atualizações necessárias aos nossos novos PDF.

Adenda posterior: Desativação da composição de livros em PDF no curto prazo
Infelizmente, problemas sérios no nosso antigo compositor (OCG) irão obrigar-nos a removê-lo das opções de composição antes de completarmos as atualizações necessárias para a criação de livros. Isto sucede mais cedo do que pretendíamos. Quando removermos o OCG, o trabalho de composição de artigos individuais estará completo. No entanto, a composição de livros será interrompida enquanto avaliamos e concluímos os trabalhos necessários. A nossa escolha inicial do compositor de substituição, o serviço de composição Electron, não suporta ficheiros PDF de tamanhos grandes e falha ao tentar compor um livro com vários artigos. Iremos selecionar um novo sistema de composição de livros que possa suportar o tamanho dos ficheiros e preencha os nossos requisitos. Não era este o nosso plano inicial. Nunca quisemos desativar temporariamente a funcionalidade de composição de livros em PDF.

Cronologia:
 * Release of full-featured renderer for single articles (print to pdf) – Oct 1, 2017
 * Pausando o processamento de livros em PDF - 1 de outubro de 2017
 * Sunsetting of OCG renderer – Oct 1, 2017
 * Release of new PDF renderer – Jan, 2018 (tentative based on research results into alternative rendering systems)

Functionality:

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.

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.

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

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.

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.

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.

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

Desenho
Os novos estilos PDF serão desenhados por incremento de legibilidade. Baseado no retorno da conversação da comunidade e dos testes qualitativos e quantitativos, o suporte para layout de 2-colunas poderão ser construídos para o criador do livro e/ou PDFs individuais.

Planos de Desenvolvimento e Lançamento
A seguinte e realce provisório dos planos de desenvovimento e lançamento. Está sujeito à alterações.


 * 1) Abril - Maio 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) Outubro de 2017
 * 12) Second iteration launched without OCG on all projects

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

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.

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