====== rndtxt Plugin ======

---- plugin ----
description: Output a random text choice
author     : andi 
email      : andi@splitbrain.org 
type       : syntax
lastupdate : 2021-03-31
compatible : Hogfather, Greebo, Kaos
depends    : 
conflicts  : 
similar    : 
tags       : random, rpg

downloadurl: https://github.com/splitbrain/dokuwiki-plugin-rndtxt/zipball/master
bugtracker : https://github.com/splitbrain/dokuwiki-plugin-rndtxt/issues
sourcerepo : https://github.com/splitbrain/dokuwiki-plugin-rndtxt/
donationurl: https://donate.dokuwiki.org/rndtext

screenshot_img : 
----

This plugin will output one of the given choices at random. Note, that it disables caching for the page to give a new random pick on every page load.

===== Installation =====

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

Separate your choices by the ''|'' character and enclose them in ''{?'' and ''?}''. Like this:

<code>
I love {?bananas|turtles|big giraffes|you?}!
</code>

You can also put choices one per line:

<code>
She has {?
dark green|
emerald green|
bright green|
sky blue|
pale blue|
bright blue|
deep blue|
blue-gray|
black|
brown
?} eyes.
</code>

Contents of the random list are not parsed (e.g. they cannot contain wiki links).

===== Acknowledgements =====

Development of this plugin was funded by the [[https://wiki.stararmy.com|Star Army Roleplaying Community]](([[https://forum.dokuwiki.org/d/19016-200-bounty-randomizer-extension|Dokuwiki User Forum thread: $200 Bounty: Randomizer Extension]])).