#format wiki
#language en
#pragma section-numbers off
#acl IanRiley:read,write,delete,revert,admin All:read
#pragma supplementation-page on

<<TableOfContents>>

= LastEdit =

== Background and rationale ==

MoinMoin themes (e.g. modernized) insert the date of the last edit and the name of the editor, usually discretely in a small font.  However, there will be situation where a more prominent presentation of the data is helpful.  There is no in-built macro for this purpose.

== Description ==

!LastEdit is a macro to insert the page's last edit and name of the editor. Without an argument the macro inserts the date only.

Included an argument triggers the inclusion of the editor's name and provides the associated text. This text either appears before the editor's name, or can include %s or %(editor)s to have the editor's name inserted into a position within the text (see example below).

The editor's name is included as link to their home page or email address as determined by their user preferences.

The text provided in the argument can include wiki markup. 

== Usage ==

=== <<LastEdit(by)>> ===

{{{
Argument "by" is optional.

<<LastEdit>> or <<LastEdit()>> - inserts date only.

<<LastEdit(by)>> - inserts date and editor as determined by the "by" string.

"by": by="..." text is inserted as "date ... editor". 
    : by="...%s..." text is inserted as "date ...editor...".
    : by="...$(editor)..." text is inserted as "date ...editor...".

Where "..." is any text, including wiki markup.

In the first of these three cases, spaces surrounding "..." are included automatically. No spaces are included in the other two cases.

}}}

== Download & Release Notes ==
|| Download || Release Version || Moin Version || Release Notes ||
|| [[attachment:LastEdit-1.0.py]] || 1.0 || 1.9.2  ||  ||

== Examples ==

{{{
Created by: IanRiley

Version: <<LastEdit(~-(editor: %s)-~)>>

Accessed: <<DateTime>>
}}}

Created by: IanRiley

Version: <<LastEdit(~-(editor: %s)-~)>>

Accessed: <<DateTime>>

{i} the wiki markup for small font (~``-smaller-``~) is included to show that it will be successfully parsed.

== Copyright ==

 . @copyright: 2011 Ian Riley <ian@riley.asia>

== License ==

GNU GPL, see COPYING for details.

== Known issues and limitations ==

 * None

-----

 Hits:: <<Hits>>