Learn about DokuWiki
Learn about DokuWiki
Compatible with DokuWiki
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
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.cssto vary how the definition is displayed. [ Forerunner for future enhancements providing multiple display styles with the plugin ].
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 (
In 2013 the plugin was moved to Github, for easier collaborative development.
Recent changes in the Github repository:
Please log all bugs and feature requests in the issue tracker on Github.
Can't create blank line after making a list. — please check this page (Korean) 2014/05/16
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