Table of Contents
The authorlist plugin adds a list with all authors to the corresponding wikipage. You can add manually the pattern
~~AUTHORS~~ to a wikipage or enable a authorlist for every page.
Usage and Syntax
To display an authorlist you have to put
into the text of a wikipage. A list of all authors will be shown at this place. By default, this looks like
The default behaviour is managed by the wiki admin through the Configuration Settings. Some default settings can be altered by using the following options.
| ||Displays the authors in a list instead (in 1 row).||
| ||Defines the displaystyle for an author. It is possible to show his login name, his fullname or both.||
| || The tooltip should be displayed, if the mouse is over the corresponding author (If ||
| ||Should the creator shown separate before or below the authorlist? (You can choose a templatetext for this in the Configuration Settings).||
| || If there is no author (e. g. you have a public site, and only unregistered authors contributed sth.), the introtext (see ||
| || If the creator of a page never edit the page later, he is not listed in the contributorslist in the Dokuwiki metadata and therefore not listed in authorlist generated through this plugin. |
There may be situations where this is necessary, e. g. if your user only have rights to edit pages, but not to create pages. In this case a admin creates the page, but contributes nothing to the content.
You can apply this options using
option=value. Several options are joined with &.
E. g. this looks like:
In case of options which only have true or false as a value, you can use
to enable them.
Disable authorlist manually
If the authorlist is displayed on every wikipage by default (see option
automatic in Configuration Settings), you can disable automatic generation using
somewhere in the text.
On the one hand, you can set some general options:
| ||Display the authorlist on every wikipage by default.||no|
| ||Show a heading above the list.||no|
| ||The heading that appears above the list, if you enabled this. You can use html-syntax.||Authors|
| ||A introducing text above the list.||<p><b>Contributing authors:</b></p>|
| ||Text, in which the name of the creator and the date will be embedded (use %CREATOR% and %DATE% as wildcard for the creatorname and the date, you can use html-syntax. The date will displayed in the format specified by DokuWiki's dformat).||<p>Created by <i>%CREATOR%</i> on %DATE%.</p>|
| ||You can link each author to his userhomepage or with his email-adress||none|
| ||The template for the link to the userhomepage (use %USER% as wildcard for the username (loginname)).||:user:%USER%|
Also you can set the default style for the authorlist in the configuration menu, while setting the values for options displayed under Usage and Syntax.
Change the layout
There is a css-file (
lib/plugins/authorlist which provides some classes which named
authoremail. This classes control the layout of authorlist. You can change them or integrate them into your template-css.
Bugs / Feature Requests
Please report bugs or feature requests at the Bug tracker.
Authorlist renders putput before RefNotes plugin. How to make the Authorlist go after the RefNotes and naturally before the Discussion Plugin putput?