Table of Contents
XSLFO Plugin
Compatible with DokuWiki
Weatherwax
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to dw2pdf
Installation
External requirements: This plugin requires a XSL processor such as Apache FOP to be installed separately.
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
To add a link to your site template, add the following code somewhere appropriate:
<a id='export-pdf-link' href="<?= wl($ID, array('do'=>'export_xslfo','rev'=>$REV)) ?>" title='Get a PDF copy of this document'> <img src="<?= DOKU_BASE ?>lib/images/fileicons/pdf.png" alt='PDF file type icon' /> Printable PDF version </a>
Configuration and settings
Option | Description | Default |
---|---|---|
output | Display the PDF file in the browser, or prompt to download it? | Browser |
usecache | Cache the PDF? | Yes |
template | XSL template to use by default. Explained below. | default.xsl |
command | The processor command. | fop -xml "{xml}" -xsl "{xsl}" -pdf "{pdf}" |
XSL-FO templates
The plugin comes with a default.xsl
template, which produces a basic PDF. Site templates (i.e. in the /lib/tpl
directory) can supply their own XSL files. These will be available to be selected from a dropdown menu on the main site configuration page. All .xsl
files in the current site template's directory will be available.
This template can be overridden for individual pages by adding &tpl=name.xsl
to the end of the URL.
The default template is not yet complete and does not handle all Dokuwiki syntax. It's got the basics, but if you find any problems please raise an issue on Github, and we'll get it sorted.
Processor command
The processor command will have {xml}
, {xsl}
, and {pdf}
replaced by the correct filesystem paths.
For example, on Windows this might be:
C:\Progra~1\fop\fop.bat -xml "{xml}" -xsl "{xsl}" "{pdf}"
Development
Change Log
- Merge pull request #13 from dokuwiki-translate/lang_update_911_153079… by samwilson (2018-07-06 00:54)
- translation update by alexbelchior (2018-07-05 15:45)
- Merge pull request #12 from dokuwiki-translate/lang_update_610_150974… by samwilson (2017-11-04 01:14)
- translation update by alexgearbox (2017-11-03 22:30)
- Merge pull request #11 from dokuwiki-translate/lang_update_24 by samwilson (2016-07-27 14:16)
- translation update by araname (2016-07-27 13:25)
- Merge pull request #10 from dokuwiki-translate/lang_update_99 by samwilson (2016-07-01 08:45)
- translation update by araname (2016-07-01 08:30)
Bugs and other issues
Please report all bugs on the plugin's Github issue-tracker, and not on this page.