Extension:CBxHandler

The CBx extension generates previews and thumbnails for uploaded Comic Book Archive files of the types cbz and cbt, and shows a paginator preview layout in file-pages. It makes Comic Book Archives behave like PDF and multipage TIFF files as handled by extension:PDFHandler and Extension:PagedTiffHandler respectively.

Comic Book Archive files are a de facto standard utilizing common file archive formats files, sometimes augmented with metadata, and having custom extensions of cbx where x denotes the archive format.

Pre-requisites
This extension requires the following packages to be installed first:

Installation
The required software above must be installed first.

Usage

 * A user can display CBx files as an image, showing a single page at a time, like so: myCbxFile.cbz . The page and size parameters are optional; the default page is page #1. Instead of a size-parameter, you can also use the thumb-parameter, with or without captions: myCbxFile.cbz.
 * Because CbxHandler extends ImageHandler, you can use all the arguments that you would for an Image -- for example: thumb, right/left, caption, border, link, etc.
 * If you would like to present a 2-page cbz, for example, do the following: myCbxFile.cbz myCbxFile.cbz


 * The main usage of the CBxHandler extension is without user interaction. If you upload a new cbx file, the metadata will be stored in the database, and then this file can be shown in a multipage preview layout like the djvu handler does. Without this extension, cbx will not display properly when uploaded.

Configuration

 * Variables below are not specific to this extension
 * Enable ImageMagick, if you haven't already: $wgUseImageMagick = true;
 * $wgMaxShellMemory - memory limit for convert, cbx-info and cbx-extract. The default value might be too low.

Debugging
Please report bugs in the bug tracker at Github.