It's better when it's simple

User Tools

Site Tools


Definition List Plugin

Compatible with DokuWiki

  • 2016-06-26 "Elenor Of Tsort" unknown
  • 2015-08-10 "Detritus" unknown
  • 2014-09-29 "Hrun" yes
  • 2014-05-05 "Ponder Stibbons" yes

plugin (X)HTML Definition lists, simple syntax and smart styling

Last updated on
Conflicts with

This plugin adds support for definition lists to DokuWiki.


A definition list is made up of one or more lines of the format shown below:

  ; term : definition
  ; term
  : definition

:!: Note the two spaces at the beginning of each line.

The lines can be used in any order, the only requirements is that the first line must be one of the two lines commencing with a semi-colon “;” and the list is terminated by leaving a line completely blank.

In a slight change over standard DokuWiki lists, if you use new lines within the list the text on the new line is added to the end of the previous line when the definition list is displayed.

See the page in action here


The plugin can be installed using the standard plugin installation instructions.


The plugin has two configuration settings.

  • dt_fancy — on/off, default on. When on will float the term content to the left side of the wiki page, making a faux two column effect with the data content on the right.
  • classname — string, default “plugin_definitionlist”. The html classname given to the wrapping <dl> element, e.g. <dl class=“plugin_definitionlist”>. Can be used in conjunction with userstyle.css to vary how the definition is displayed. [ Forerunner for future enhancements providing multiple display styles with the plugin ].

HTML Structure

<!-- dt_fancy ON, classname plugin_definitionlist -->
<dl class="plugin_definitionlist">
    <dt><span class="term">term</span></dt>
<!-- dt_fancy OFF, classname plugin_definitionlist -->
<dl class="plugin_definitionlist">


The plugin is an evolution of the earlier plugins by Stephane Chamberland and Pavel Vitis.

At the time of original publication of this plugin there were two other definition list plugins:

Why use this plugin rather than one or other of the other two?

This plugin is very similar to definitions, it fixes a couple of problems with that plugin, other markup (e.g. formatting, links, etc) is allowed in the definition term and raw wiki data is properly filtered to maintain wiki security.

I like the simplicity of DokuWiki's markup. I believe this plugin keeps to that ideal, deflist is capable of handling more circumstances but I feel at the cost of some simplicity.

I have also added some configuration settings to allow more heavily styled lists and a choice of markup characters (it is set to MediaWiki's “; term : definition” by default but can be changed to “= term : definition” used by definitions). By turning DL_FANCY on (default) the definition list will be output in a two column format, one column for the terms (<dt>) and another for the definitions (<dd>).

In 2013 the plugin was moved to Github, for easier collaborative development.

Recent changes in the Github repository:

Previous revisions:

  • 2008-08-13 — Update plugin URL, add OpenDocument renderer support, add generic rendering for unknown render formats
  • 2005-09-21 — Style corrections, sources updated.
  • 2005-09-17 — Released.


Please log all bugs and feature requests in the issue tracker on Github.


Blank line after list?

Can't create blank line after making a list. — please check this page (Korean) 2014/05/16

Syntax note; and anchor tag?

One caveat for usage and one suggestion:

CAVEAT The TERM line [;] need to be either right after the previous DEFINITION [;] or it needs to be separated by two blank lines.

If a single blank line is used, the markup is not triggered and the text, with the punctuation is shown.

This is no longer the case. It is important to make sure the intervening blank lines don't have a couple of blank spaces, which the editor might leave in place. These confuse the parser and result in it triggering dokuwiki's own preformatted code block

SUGGESTION What would be a nice addition to this plugin would be an ANCHOR tag wrapped around the TERM

walter 2008-01-11 01:59

plugin/definitionlist.txt · Last modified: 2016-09-15 19:50 by LarsDW223