Open main menu
MediaWiki extensions manual
OOjs UI icon advanced.svg
FenTT
Release status: beta
Fentt-screenshot-zoom.png
Implementation Parser function
Description Render chess diagrams in <fentt> tag using CSS style and TrueType font
Author(s) Michaël Peeters (xeyownttalk)
Latest version 1.0.3 (2017-12-24)
MediaWiki 1.17+ (>1.27.4 not tested)
License GNU General Public License 2.0 or later
Download https://github.com/xeyownt/mwfentt
Example see WikiTest FenTT page.
Translate the FenTT extension if it is available at translatewiki.net
Check usage and version matrix.

FenTT is a MediaWiki extension written in PHP that allows the rendering of nice chessboards in HTML at any size or color, by using TrueType fonts and without the need of extra images. Chess game diagrams can be rendered in both color or B&W mode, and piece movements or square of interests can be indicated as well. Diagrams rendered in B&W mode can also be copy-pasted into e.g. an office application.


FenTT is in fact a PHP implementation of HTMLTTChess, a javascript program that provides similar functionality. Besides being written in a different language, the major difference with HTMLTTChess is that the markup text that produces the chess diagrams is generated by the server, and hence the extension works even if the client has disabled javascript support.

Supported featuresEdit

Here a summary of supported features:

  • Notation:
  • Forsyth-Edwards compatible notation.
  • Extra symbols for eg. piece movement (. or x).
  • Highlighting of squares of interest.
  • Rendering:
  • Truetype font based rendering, using either local or web font.
  • Color mode or printer-friendly black&white mode.
  • Default mode specification / inline mode specification.
  • Size:
  • Fixed size.
  • Variable size (eg. multiple of browser default font size).
  • Style:
  • Stylesheet-based.
  • Default style.
  • Inline style.
  • Class style.
  • Export:
  • Black&white board can be copy-pasted in external applications.

UsageEdit

Usage instructions are contained in the package. To view it,

  • Download the package.
  • Run the command
make doc
  • Open file doc/reference.html in a browser.

Documentation is also available on the extension homepage.

DownloadEdit

FenTT is available on GitHub.

ExamplesEdit

Check FenTT page on WikiTest. You can see the extension at work and try it by yourself.

InstallationEdit

  • Download and place the file(s) in a directory called FenTT in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'FenTT' );
    
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'FenTT' );, you need to use:

require_once "$IP/extensions/FenTT/FenTT.php";

CompatibilityEdit

Extension has been tested on

  • MediaWiki 1.27.4
  • MediaWiki 1.22.1

Extension uses the ResourceLoader, so it requires at least MediaWiki 1.17.

LicenseEdit

The FenTT MediaWiki extension is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

See file COPYING for more details.