====== plaintext Plugin ======

---- plugin ----
description: <text> tag that embeds plain text with linebreaks
author     : danny0838 
email      : danny0838@gmail.com
type       : syntax
lastupdate : 2018-05-20
compatible : 2012-10-13, 2013-03-06, Angua, Rincewind, Anteater, Detritus, Greebo
depends    : 
conflicts  : 
similar    : 
tags       : formatting

downloadurl: https://github.com/danny0838/dokuwiki-plugin-plaintext/archive/master.zip
bugtracker : https://github.com/danny0838/dokuwiki-plugin-plaintext/issues
sourcerepo : https://github.com/danny0838/dokuwiki-plugin-plaintext/
donationurl: 
----

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Syntax and Usage =====

Here is the demo picture:

{{https://github.com/downloads/danny0838/dw-plaintext/plaintext.jpg?500|Demo Picture}}

==== <text> ====

Similar to **%%<nowiki>text</nowiki>%%**, but linebreaks are preserved (replaced by <br/> in the output, but head and tail linebreaks are trimmmed)

<code text>
<text>
(Line 1) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
(Line 2) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
 
(Line 4) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
</text>
</code>

==== <TEXT> ====

Adds a box like **%%<code>%%**, but long text is auto wrapped.

<code text>
<TEXT>
(Line 1) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
(Line 2) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
 
(Line 4) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
</TEXT>
</code>

==== <code> <file> ====

This plugin adds a "plaintext" style for wrapped text, so you can use it in **%%<code>%%** or **%%<file>%%** box.

<code text>
<file plaintext>
(Line 1) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
(Line 2) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
 
(Line 4) This is a **long** //long// __long__ long long long long long long long long long long long long long long long long long long long sentence.
</file>
</code>

===== Discussion =====
How is this different than...
  indenting two spaces?
<file>using <file> tags?</file>
<code>using <code> tags?</code>
 --- [[user>greenseeker]] //2011/01/14 19:28//

>The text inside <text> is wrapped and is not monospace.  --- [[user>danny0838|danny0838]] //2013/03/19 03:41//

Thank you! It's perfect for [[http://www.mediawiki.org/wiki/Extension:Poem|poems]]!
 --- [[user>shane]] //2011/01/14 21:43//