This is an old revision of the document!

randominc Plugin

Compatible with DokuWiki

2006-11-06, Detritus

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

Last updated on: 2017-06-15
Provides: Syntax, Helper
Repository: Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with include, random

By LarsDW223 (previous author: Vittorio Rigamonti)

Description

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.

Syntax

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.

{{randominc>[ns]#[section]&[flags]}}

[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.

Arguments

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

Examples

{{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

Development

Changes:

Translations

The plugin is translated into Russian, English, and German. Thanks a lot to the translators, new languages are very welcome!

Please use the DokuWiki Localization Tool.

Bugs

To report bugs or suggest features, please use GitHub Issues. The author does not monitor this page.

Discussion

Tested on Release 2014-09-29d “Hrun”, it's work perfectly. — Alinea 2015-07-17 22:14

Included on http://pe.hillschmidt.de under Release 2017-02-19b „Frusterick Manners“ - perfect!

Table of Contents