====== BBCode Plugin ======

---- plugin ----
description: Makes the use of BBcode syntax possible. (previous authors: Esther Brunner)
author     : Gina Häußge, Michael Klier, Luis Machuca Bezzaza
email      : luis.machuca@gulix.cl
type       : syntax
lastupdate : 2010-06-04
compatible : >= 2006-11-06
depends    : 
conflicts  : 
similar    : 
tags       : formatting, markup_language

downloadurl: http://cloud.github.com/downloads/dokufreaks/plugin-bbcode/plugin-bbcode.tgz
sourcerepo:  http://github.com/dokufreaks/plugin-bbcode
bugtracker:  http://github.com/dokufreaks/plugin-bbcode/issues
----

:!: See the "[[#testing]]" section below for further updates!

===== Description =====

This [[plugins|plugin]] provides support for [[wp>BBCode]] syntax within [[:DokuWiki]]. BBCode is popular among discussion forums like phpBB or vBulletin. The BBCode plugin supports almost all of the phpBB implementation of BBCode.

Of course, DokuWiki's [[:syntax]] is much more powerful and is more intuitive to read and write, but nevertheless, you might want to switch content from a forum to your wiki or make it easy for users coming from forums to start contributing.

===== Syntax =====

Basic Formatting:

  [b]bold text[/b]
  [i]italic text[/i]
  [u]underline[/u]
  [s]deleted[/s]
  [m]monospace[/m]

Code and Quoting:

  [code]<?php echo $text;[/code]
  [quote="Esther"]DokuWiki is great![/quote]

Links and Images:

  [url=http://www.kaffeehaus.ch]Esthers Kaffeehaus Blog[/url]
  [email]esther@kaffeehaus.ch[/email]
  [img]http://www.dokuwiki.org/lib/exe/fetch.php?w=&h=&cache=cache&media=wiki%3Adokuwiki-128.png[/img]

The %%[url]%% parameter can be optionally quoted.

Lists:

  [list][*]item 1[*]item 2[*]item 3[/list]
  [list=1][*]item 1[*]item 2[*]item 3[/list]  attribute: 1, a, A, i or I

Text size:

  [size=90%]smaller text[/size]               attribute: CSS units (px, em, %, ...), single-digit, or keywords like small; can be optionally quoted

Text color:

  [color=red]colored text[/color]             attribute: color name, "browser-color" name, #fff[fff] or rgb(255,255,255); can be optionally quoted

To learn more about the supported text size and color formats, you can check [[http://ryan.gulix.cl/tests/doku.php/bbcode|the Demo page for the BBCode Testing Branch]] (courtesy of [[user>ryan.chappelle|Luis Machuca Bezzaza]] //2011/05/28 07:48//).

===== Known Issues =====

  * Images within a link aren't supported. Use DokuWiki's syntax ''%%[[http://www.some.url|{{http://www.some.url/logo.png}}]]%%''.
  * Only some of the supported formats map to the [[plugin:odt|ODT Plugin]], namely the basic format ones, %%[url]/[email]%%, %%[quote]%% and color (partially). All of the others may render without extra formatting when exporting to an ODT document.

==== New Management ====

I'd like to announce my intentions of maintaining this plugin starting Jan 2011, after Chi's (let's hops temporary) exit of the DokuWiki development world. As a starting point a new demo page as well as screenshots and localization strings will be developed in for the next release, which will bring few if any behavioural modifications. Later on I will work to improve compatibility with alternate renderers, in particular [[plugin:odt]]. //[[http://www.freelists.org/post/dokuwiki/Chis-Legacy,4|More Info [dokuwiki] ]]// --  --- [[user>ryan.chappelle]] //2010/12/18 19:35//

==== Testing ====

:!: **Update ''2011-05-25''**: there's a new development branch for the BBCode plugin, at ''[[https://github.com/lmachucab/plugin-bbcode/tree/bbcode-testing|bbcode-testing]]''. Changes and new developments are being tested before being pulled to upstream, as I am still quite fuzze in this Git stuff. You can visit the demo page and grab a working copy, but waiting for upstream pulls is **very** recommended.

Changes in the latest ''bbcode-testing'' builds include:

  * Basic color support in the ODT renderer for colornames and %%#colortuples%%.
  * A new syntax mode for smallcaps which can be invoked with %%[c]Some Smallcaps Text[/c]%%.
  * Others...

Useful links:

^ Demo Page    | http://ryan.gulix.cl/tests/doku.php/bbcode |
^ Git Repo     | https://github.com/lmachucab/plugin-bbcode/tree/bbcode-testing |
^ Zipball (testing)  | https://github.com/lmachucab/plugin-bbcode/zipball/bbcode-testing  |

===== Changes =====

{{rss>http://github.com/feeds/dokufreaks/commits/plugin-bbcode/master date}}