Extension:CBxHandler

From mediawiki.org
MediaWiki extensions manual
CBxHandler
Release status: unmaintained
Implementation Media
Description A paginated viewer for Comic Book Archive files
Author(s) Maysara Abdulhaq (uwe_atalk)
MediaWiki 1.25+
PHP 5.4+
Database changes No
License GNU General Public License 3.0 or later
Download
README

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[edit]

This extension requires the following packages to be installed first:

Package Description Link
libfile-mimeinfo-perl
imagemagick dynamic resizing and thumbnailing of images http://www.imagemagick.org/script/install-source.php for instructions on how to install
cbx-info and cbx-extract Extract metadata from CBx archives https://github.com/arabdigitalexpression/cbx-utils linux sh binaries, also requires unrar

Installation[edit]

Note Note: The required software above must be installed first.

Usage[edit]

  • A user can display CBx files as an image, showing a single page at a time, like so: [[File:myCbxFile.cbz|page=1|600px]]. 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: [[File:myCbxFile.cbz|page=1|thumb|My 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: [[File:myCbxFile.cbz|page=1]] [[File:myCbxFile.cbz|page=2]]
  • 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[edit]

Variables below are not specific to this extension

Debugging[edit]

Please report bugs in the bug tracker at Github.

Notes[edit]

This extension was developed for Wiki Gender, sponsored by Goethe-Institut Ägypten and by technical expertise from ADEF

See also[edit]