====== poem Plugin ======

---- plugin ----
description: <poem> tag that embeds a block with linebreaks preserved.
author     : danny0838 
email      : danny.0838@gmail.com
type       : syntax
lastupdate : 2012-07-06
compatible : Angua, Rincewind, Anteater, Hrun+
depends    : 
conflicts  : 
similar    : 
tags       : poem, formatting

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

===== Installation =====

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

===== Syntax =====

Similar to [[http://www.mediawiki.org/wiki/Extension:Poem|poem]] plugin of Wikipedia, which embeds a block with linebreaks perserved.

Block elements such as code, tables, lists, or quotes are not available in the poem block.

<code>
<poem>
first line
second line
third line
**Bold Text**, //Italic Text//, __Underlined Text__, ''Code Text'', [[:start|DokuWiki]] are available.


3 empty lines above
</poem>
</code>

The first linebreak immediately followed %%<poem>%% is automatically ignored.

No ending %%</poem>%% is acceptible, which makes all content below the previous %%<poem>%% linebreak-preserved. But it is logically discouraged.

===== Development =====

=== Change Log ===

{{rss>https://github.com/danny0838/dw-poem/commits/master.atom date}}

=== Known Bugs and Issues ===
  * Plugin does not work with "Anteater"
=== ToDo/Wish List ===
  * Lines numbering would be great!
===== FAQ =====

===== Discussion =====