Extension:ElectronPdfService

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 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 extensão Git [?]: Baixar master do Git navegar pelo repositório (GitHub) histórico de commits revisão de código
Exemplo	Wikipedia article
Hooks usados SidebarBeforeOutput BeforePageDisplay
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. (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/';
  

•  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 (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

• Documentação do serviço Electron
• Documentação da API RESTBase
• Documentação do OCG
• PDF de exemplo

• RESTBase API documentation
• OCG documentation
• Example PDF

Ver também

• PDF export – summary of all PDF export extensions