Extension:CBxHandler

The CBx extension generates previews and thumbnails for uploaded Comic Book Archive files of the types cbz and cbt, and shows a paginated preview layout in file-pages. It makes Comic Book Archives behave like PDF and multi-page 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:
 * - 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.

MediaWiki 1.39.x LTS Test Plan
The items listed here are general issues related to MediaWiki 1.39.x LTS. They are not addressing any issues that are specific to this extension.


 * Extension considered active for MediaWiki 1.39.x LTS