Extension:ElectronPdfService

From MediaWiki.org
Jump to navigation Jump to search
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 • ‎русский • ‎中文 • ‎日本語
Manual de extensões do MediaWiki
OOjs UI icon advanced.svg
Extension:ElectronPdfService
Estado da versão: beta
ElectronPdfService-mockup.png
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
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. (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/';
    
  • Yes 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

Ver também

  • PDF export – summary of all PDF export extensions