It's better when it's simple

User Tools

Site Tools


randominc Plugin

Compatible with DokuWiki

  • 2017-02-19 "Frusterick Manners" unknown
  • 2016-06-26 "Elenor Of Tsort" unknown
  • 2015-08-10 "Detritus" yes
  • 2014-09-29 "Hrun" unknown

plugin Randomly select a page from a namespace and include it the current page

Last updated on
Syntax, Helper

Tagged with include, random


This plugin is untested and is provided as is, I developed it just for my university project. Check it before use.

This is a useful plugin, if you want to include a randomly chosen page from a namespace, into the current one.

This plugin is directly derived from include plugin, to which I added a random page selection derived from random_page.

Consider the use of Randominc if you want to change a static part of you page, to a randomly chosen part.


Enclose the namespace from where to select the page in double curly brackets. Refer to Include Plugin for detailed information here are only described the added functionallities.

[ns] namespace from which select the page to include

The plugin offers two syntaxes, {{randominc>...}} and {{randomincsec>...}}.

  • randominc works as page syntax of Include Plugin.
  • randomincsec should work as section syntax.


You may use two arguments to control the presentation of the random content:

Name Value Effect Example
max-height A valid CSS size Content height limit max-height: 100px
max-width A valid CSS size Content width limit max-width: 200px


  • {{randominc>namespace1&max-height: 200px}}
  • you can include the random content into a box:<box 80% round blue | Random Content>{{randominc>namespace2&max-height: 250px}}</box>
  • {{randomincsec>:playground:test#abc&nofooter&noheader&noeditbtn}}
    where test is a folder and #abc is a headline


Tested on Release 2014-09-29d “Hrun”, it's work perfectly. — AlineaAlinea

2015-07-17 22:14

Included on under Detritus - perfect!

plugin/randominc.txt · Last modified: 2016-10-30 20:03 by