For discussion and the branch please see transient pages. If this plugin is merged, this page can be renamed to act as its documentation. --smcv

Plugin: transient
Author: Simon McVittie
Included in ikiwiki: no
Enabled by default: no
Included in goodstuff: no
Currently enabled: no

The transient plugin adds an underlay in .ikiwiki/transient, which is intended for pages that are automatically created and should not be committed to the RCS. It works in the same way as the basewiki and the underlays set up by the underlay plugin, so if a page in the transient underlay is edited via the web, the edited version is committed to the RCS as usual. Unlike other underlays, if a page in the transient underlay is superseded by an edited version in the RCS, the old transient version is deleted automatically.

This plugin is mostly useful as something that other plugins can depend on:

  • album always writes photo-album "viewer" pages to the transient underlay

Likely future users of this plugin (the appropriate branches need to be merged first):

  • with a patch (which exists but hasn't yet been tested), aggregate always writes aggregated posts into the transient underlay
  • with a patch, autoindex can be configured to auto-create missing pages that have a subpage or an attachment, but not commit them, in which case they go in the transient underlay
  • comments can be configured to not commit comments: if so, it should probably put them in the transient underlay
  • with a patch, recentchanges always writes new changes into the transient underlay
  • with a patch, tag can be configured to auto-create missing tag pages but not commit them, in which case they go in the transient underlay