Extension:ElectronPdfService

This page is a translated version of the page Extension:ElectronPdfService and the translation is 48% complete.

Outdated translations are marked like this.

Other languages:

Deutsch • ‎English • ‎français • ‎português do Brasil • ‎русский • ‎中文 • ‎日本語

The information on this page is partially outdated. See phab:T247310.

**Manual de extensões do MediaWiki**
ElectronPdfService Estado da versão: estável

Implementação	Interface de usuário
Descrição	Fornece acesso ao serviço Electron para renderização em PDF do navegador
Autor(es)	Wikimedia Germany (WMDE) – Roadmap
Última versão	continuous updates
Política de compatibilidade	branches de lançamento
MediaWiki	1.25+
Modifica o banco de dados	Não
Licença	GNU GPL (Licença Pública Geral) 2.0 ou superior
Download	Baixar extensão Git ^[?]: Baixar master do Git navegar pelo repositório (GitHub) histórico de commits repository contributors (GitHub) revisão de código
Exemplo	Wikipedia article
Parâmetros $wgElectronPdfServiceRESTbaseURL
Hooks usados BeforePageDisplay SidebarBeforeOutput
Para traduzir a extensão ElectronPdfService, verifique sua disponibilidade no translatewiki.net
Verificar uso e matriz de versões
Problemas	Tarefas em aberto · Relatar um bug

A extensão ElectronPdfService fornece acesso ao serviço Electron para renderização em PDF do navegador. (O serviço deve ser instalado separadamente.)

Descrição

A extensão fornece uma maneira mais fácil de acessar o serviço Electron pelo endpoint da API RESTBase. O serviço fornece um novo método de renderização para páginas wiki, como alternativa à renderização OCG/LaTeX, já existente. A grande vantagem de usar o serviço é que o PDF gerado terá todas as tabelas, infocaixas e predefinições, algo que não era possível no método antigo. Saiba mais sobre o contexto da motivação para a extensão e para o serviço.

Aqui há um exemplo: PDF para o artigo sobre Brasília.

Instalação

Instale e configure um serviço Electron exposto sobre um endpoint da API RESTBase
- Siga as instruções de instalação do serviço e verifique o funcionamento em http://seu-host:porta/pdf?accessKey=sua-chave-de-acesso&url=https://pt.wikipedia.org/wiki/Brasil.
- Instale o https://github.com/wikimedia/restbase e defina uma configuração semelhante a em config.example.wikimedia.yaml. Ajuste a URL do servidor de PDF para refletir seu host e porta.
Baixe e coloque o(s) arquivo(s) num diretório chamado ElectronPdfService na sua pasta extensions/.

Adicione o seguinte código ao final do seu arquivo LocalSettings.php:

wfLoadExtension( 'ElectronPdfService' );
$wgElectronPdfServiceRESTbaseURL = '/api/rest_v1/page/pdf/';

Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.

Ubuntu 16.04.3 (instalação local)

Ao instalar no Ubuntu Server 16.04.3 LTS, a seguinte configuração era necessária:

$wgElectronPdfServiceRESTbaseURL = "http://HOSTFQDN:3000/pdf?accessKey=secret&url=http://HOSTFQDN/wiki/";

O /wiki/ é a URL de reescrita do Apache, dado que essa instalação imita a variação genérica de reescrita.

Você tem a liberdade de modificar! Hardcoding pode ser um tanto quanto difícil, mas as variáveis não funcionavam.

Uso

Uma vez instalada a extensão, a ligação “Baixar como PDF” na barra lateral do MediaWiki levará você à nova tela de seleção.

Na tela de seleção, você poderá escolher se quer renderizar seu PDF usando o Electron (“Coluna única”) ou o antigo OCG/LaTeX (“Duas colunas”).

Após escolher o método de renderização desejado, clique no botão “Baixar” para obter o PDF.

Nota: se não houverem dois métodos de renderização disponíveis na wiki, “Baixar como PDF” automaticamente fornecerá a renderização Electron, sem exibir uma tela de seleção.

Ligações

Ver também

PDF export – summary of all PDF export extensions