Extension:PDF Writer
From MediaWiki.org
 Release status: beta |
|
|---|---|
| Implementation | Data extraction |
| Description | Generates PDF from single articles or collections |
| Author(s) | PediaPress |
| License | GPL |
| Download | no link |
| Example | http://wiki.services.openoffice.org/wiki/Help:Collections |
Contents |
[edit] Overview
mwlib.rl is a python library for writing pdf documents from MediaWiki articles which were parsed by the mwlib library.
See this press release Wikis Go Printable for more information on this project.
[edit] No Installation required !
The PDF Writer can run standalone on a server and provide PDF generation for multiple MediaWiki instances. A server for public testing and low traffic Wikis runs at http://tools.pediapress.com .
All you need is the Collection extension which is configured to use this server by default.
[edit] Example
[edit] Technical
The PDF Writer uses the Python Reportlab libraries to generate PDF based on a DOM derived from parsing mediwawiki-markup using the mwlib parser. The Collection Extension can be used to select and manage articles that shall constitute the resulting PDF.
[edit] Source
mwlib.rl is copyrighted by PediaPress and is distributed under a BSD license (see the included README.txt for details).
If you have Python >= 2.4 and setuptools installed, you can install the current release with
easy_install mwlib.rl
[edit] Mailing List
We've setup a google group for discussion of mwlib.rl. You can subscribe per email: mailto:mwlib-subscribe@googlegroups.com.
[edit] Help Needed
Please help us localize some strings used in the generated PDF. The process of localization will be updated to use BetaWiki in the future, but for now we´d appreciate your help.
See this page for missing translations and consider to help out.
[edit] Programs
mwlib installs the following programs:
- mw-render
- generates documents in formats like PDF or ODF from MediaWiki articles
- mw-zip
- generates ZIP files from MediaWiki articles that contain all information to produce some output document like a PDF file
- mw-serve
- starts a render server that allows the Collection extension to render documents from article collections
[edit] Configuration
If your MediaWiki has the MediaWiki API enabled, you just specify the base URL of the wiki as the configuration. For example using the English Wikipedia, this
$ mw-render --config http://en.wikipedia.org/w/ --output test.pdf --writer rl Physics
will produce a PDF document containing the article Physics.
[edit] Customization
It is possible to customize the resulting PDFs - for more information check the readme.txt (README.txt)
