Extension:PdfBook

Overview
Categories are a good way of organising many articles which together make up an entire book. The sort-key's in the article's categorisation statements can be used to ensure that they're ordered properly. This extension allows such categories to be composed into downloadable PDF files with a table of contents and each article forming the start of a new chapter.

Installation
First Htmldoc needs to be installed (on Debian based systems such as Ubuntu or Mepis use: apt-get install htmldoc). Windows Binary can be found here. Then copy the extension code from Organic Design, save into your extensions directory and include into your LocalSettings.php file as usual.

Configuration
Here are some global variables which affect the operation of the extension. These should be set in your LocalSettings file after the include of the PdfBook.php script. These configuration options can be overridden by the parser function so that they can be set specifically for each book.

Usage
This extension is used by adding a parser function to categories which whose articles make up the content of a book. Actually a template is best which can contain the parser function and also supply a nice message and download link. For an example book, see OrganicDesign:Category:I am that.

Bugs and Todo

 * Images not rendering properly
 * Multibyte characters not working
 * Tables are "hardwired" to a standard format currently
 * Dynamic per-book parameters not done yet