Extension:ElectronPdfService
![]() | Esta página está desatualizada. |
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 | |
Exemplo | Wikipedia article |
|
|
Para traduzir a extensão ElectronPdfService, verifique sua disponibilidade no translatewiki.net | |
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.
- Siga as instruções de instalação do serviço e verifique o funcionamento em
- Baixe e coloque o(s) arquivo(s) num diretório chamado
ElectronPdfService
na sua pastaextensions/
. - 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