This plugin adds Material-for-MkDocs Admonition notes to Dokuwiki (https://squidfunk.github.io/mkdocs-material/reference/admonitions/).
Not all features of the Material-for-MkDocs Admonition notes are supported. Notes are not collapsible and you cannot omit the header line.
Some note styles had to be renamed to avoid conflicts with existing DokuWiki base styles.
This plugin is published under the Gnu Public License (GPL) V2.
CSS-Code: © 2016-2020 Martin Donath. Available under MIT License
Material Icons: © Google Inc. Available under Apache license version 2.0
Unpack the file in the /lib/plugin
directory of your Dokuwiki installation. It will create a directory named admnote there. You can also use the extension manager.
This plugin uses the <adm></adm>
tag pair to start and end a note. The first parameter of the opening tag chooses the note style.
There are twelve styles available: 'abstract', 'bug', 'danger', 'example', 'failure', 'information', 'note', 'question', 'quote', 'achievement', 'tip', 'warning'
<adm abstract>Abstract</adm>
Abstract
Abstract
<adm bug>Bug</adm>
Bug
Bug
<adm danger>Danger</adm>
Danger
Danger
<adm example>Example</adm>
Example
Example
<adm failure>Failure</adm>
Error
Failure
<adm information>Information</adm>
Info
Information
<adm note>Note</adm>
Note
Note
<adm question>Question</adm>
Question
Question
<adm quote>Quote</adm>
Quote
Quote
<adm achievement>Achievement</adm>
Success
Achievement
<adm tip>Tip</adm>
Tip
Tip
<adm warning>Warning</adm>
Warning
Warning
You can replace the standard heading by adding your heading text as a third parameter in the <adm>
tag:
<adm warning A very special warning>This is a warning</adm>
A very special warning
This is a warning
There is no need for quotes in your heading. You cannot use wiki styles in the heading.
You can also omit the body of the note completely:
<adm danger Will initiate self destruction if you click this></adm>
Will initiate self destruction if you click this
The default style is 'note', so <adm></adm>
is a valid note although it does not make much sense:
Note
The default style will also be used if you mistype a style.
You can use almost every DokuWiki element inside a note body except headers.
Version 0.1 of this plugin was made for DokuWiki Release 2020-07-29 “Hogfather”. It may work with earlier releases but that is untested.
admnote-0.1.2.tar.gz (27,042 Bytes)
The plugin is also available from a GitHub repository https://github.com/kvormweg/admnote