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

<<TableOfContents>>
= RandomText =

== Background and rationale ==

Mostly MoinMoin text is static unless the page obtains text from an external source.

For some teaching activities, it can be useful to return a random text from a group of possible texts.

== Description ==

The !RandomText macro inserts a randomly selected text from a list provided as parameter. The texts provided are unquoted and separated by a vertical bar (|). If no text is provided, then nothing is inserted.

== Usage ==
{{{
<<RandomText([Text1|Text2|...|TextN])>>
}}}

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

== Examples ==

{{{
<<RandomText(Text one|Text two|Text three)>>
}}}

First call: <<RandomText(Text one|Text two|Text three)>>

Second call: <<RandomText(Text one|Text two|Text three)>>

See example usage in SentenceMachine.

== Copyright ==

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

== License ==

GNU GPL, see COPYING for details.

== Known issues and limitations ==

 * None

-----

 Hits:: <<Hits>>