Extension:ElectronPdfService/es
 Release status: beta |
|
|---|---|
 |
|
| Implementación | User interface |
| Descripción | Provides access to the Electron Service for browser-based PDF rendering |
| Autor(es) | Wikimedia Germany (WMDE) – Roadmap |
| Última versión | continuous updates |
| Política de compatibilidad | release branches |
| MediaWiki | 1.25+ |
| Cambios de la base de datos | No |
| Licencia | GNU General Public License 2.0 or later |
| Descarga | |
| Ejemplo | Wikipedia article |
| Translate the ElectronPdfService extension if it is available at translatewiki.net | |
| Verificar uso y versión de la matriz. | |
| Asuntos | Tareas abiertas · Reportar un bug |
The ElectronPdfService extension provides access to the Electron Service for browser-based PDF rendering. (The Electron Service needs to be installed separately.)
Contents
Description
The extension provides a handy way to access the Electron Service via a RESTBase API endpoint. The Electron Service provides a new rendering method for wiki-pages as alternative to the existing OCG/LaTeX rendering. The huge advantage of using the Electron Service is, that the generated PDF will contain all tables as well as rendered infoboxes and other templates which was not possible with the old method. Read more on the background of the motivation for the extension and the service.
And here's an example: PDF for the article about Berlin.
Installation
- Install and configure an Electron Service exposed over a RESTBase API endpoint
- Follow the service install instructions & verify correct functioning with
http://your-host:port/pdf?accessKey=your-key&url=article-url - Install RESTBase, and set up a config similar to config.example.wikimedia.yaml. Adjust the PDF server URL to reflect your host & port.
- Follow the service install instructions & verify correct functioning with
- Descarga y extrae los archivos en el directorio «
ElectronPdfService» dentro del directorioextensions/existente.
- Añade el siguiente código a tu LocalSettings.php (preferiblemente al final):
wfLoadExtension( 'ElectronPdfService' ); $wgElectronPdfServiceRESTbaseURL = '/api/rest_v1/page/pdf/';
Listo – Navega a Special:Version en tu wiki para verificar que la apariencia se haya instalado correctamente.
Listo – Navega a 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.
Usage
- Once the extension is installed, the “Descargar como PDF” link in the MediaWiki sidebar will lead you to a new selection screen.
- On the selection screen you can then choose whether you want to render your PDF using Electron (“Single Column”) or using the old OCG/LaTeX renderer (“Two Column”).
- After you've chosen the desired rendering method, click the “Descargar” button to get the PDF.
- Note: if there is no alternative rendering method available on the Wiki, “Descargar como PDF” will immediately serve you the Electron rendered PDF without showing a selection screen.
Links
Véase también
- PDF export – summary of all PDF export extensions
 | Esta extensión está siendo usada en uno o más proyectos de Wikimedia. Esto significa probablemente que la extensión es estable y funciona lo suficientemente bien como para ser usada en sitios con gran cantidad de visitas. Puedes buscar el nombre de esta extensión en los archivos CommonSettings.php e InitialiseSettings.php de Wikimedia para ver dónde se instala. Encontrarás la lista completa de extensiones instaladas en un wiki en particular en la página Special:Version del wiki. |
