Extensão:ElectronPdfService

Manual de extensões do MediaWiki

Extension:ElectronPdfService Estado da versão: beta
Implementação	User interface
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 por lançamento
MediaWiki	1.25+
Modifica o banco de dados	Não
Licença	GNU General Public License 2.0 or later
Download	Baixar snapshot Git [?]: Baixar mestre de Git navegue pelo repositório (GitHub) histórico de commits revisão de código
Exemplo	Wikipedia article
Traduzir a extensão ElectronPdfService, se estiver disponível 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.

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. Um maior contexto sobre a motivação que levou à implementação da extensão e do serviço pode ser encontrado aqui (em inglês).

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

• • Follow the service install instructions & verify correct functioning with http://yourhost:port/pdf?accessKey=yourkey&url=https://de.wikipedia.org/wiki/Berlin
  • Install https://github.com/wikimedia/restbase, and set up a config similar to config.example.wikimedia.yaml. Adjust the pdf server URL to reflect your host & port.
• 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/';
  

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

Ubuntu 16.04.3 (Local Install)

When installing on Ubuntu Server 16.04.3 LTS, the following configuration was needed instead:

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

The /wiki/ is the Apache rewrite URL as this installation mimics the generic variation of re-writing. Change to whatever you use! Yes, hardcoding can be bad, but variables refused to work otherwise.

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

• Documentação do serviço Electron (em inglês)
• Documentação da API RESTBase
• Documentação do OCG (em inglês)
• PDF de exemplo

See also

• PDF export - summary of all PDF export extensions