DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== xbr Plugin ======

---- plugin ----
description: Replacement renderer, preserves line breaks present in raw wiki data
author     : Christopher Smith
email      : chris@jalakai.co.uk
type       : render
lastupdate : 2012-06-30
compatible : anteater, rincewind, angua, adora belle, binky, ponder stibbons, Hrun, Detritus
depends    : 
conflicts  : 
similar    : linebreak
tags       : typography
downloadurl: https://github.com/Chris--S/dokuwiki-plugin-xbr/zipball/master
sourcerepo : https://github.com/Chris--S/dokuwiki-plugin-xbr
----

===== Description =====

This plugin enables the preservation of line breaks from the raw wiki text through to the html output.  It is a replacement for the standard DokuWiki XHTML renderer, as such to use it you must set the [[config:renderer_xhtml]] setting to the plugin's name, **''%%'xbr'%%''**.  For simplicity's sake the plugin uses all of the standard renderers routines with the exception of plain character output, where it uses its own routine to replace new lines with the HTML element, **''<br />''**.

Note, the plugin does not preserve multiple consecutive line breaks, but it will preserve single line breaks.

Also see the [[plugin:linebreak]] plugin.

===== Download and 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.

After installation set the [[config:renderer_xhtml]] configuration setting (via your wiki's admin panel) to **''%%'xbr'%%''**.

===== Revision History =====

* 2008-06-30 --- include Danny Lin's suggestions and move code to GitHub
  * 2008-11-11 --- installable packages and darcs versions prepared.  No changes.
  * 2008-08-13 --- released

===== Bugs =====

>Does not work with Release 2014-09-29b "Hrun"
>> Test with success with Release 2014-09-29**d** "Hrun".\\ This plugin has no dedicated section in the configuration manager. You need to change the ''renderer_xhtml'' parameter in advanced settings.\\ __I'm not the author__ but changed compatibility to OK in this page.

===== To Do (feature requests) =====

===== Discussion / Requests for help =====

Please fill all the letters into the box to prove you're human. S V A S K Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International