DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:bbcode

BBCode Plugin

Compatible with DokuWiki

  • 2013-12-08 "Binky" yes
  • 2013-05-10 "Weatherwax" yes
  • 2012-10-13 "Adora Belle" yes
  • 2012-01-25 "Angua" yes

plugin Makes the use of BBcode syntax possible. (previous authors: Esther Brunner)

Last updated on
2010-06-04
Provides
Syntax
Repository
Source

:!: See the ”testing” section below for further updates!

Description

This plugin provides support for 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 the Demo page for the BBCode Testing Branch (courtesy of Luis Machuca BezzazaLuis Machuca Bezzaza
ryan.chappelle

Temuco, Chile
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 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 odt. More Info [dokuwiki] – — ryan.chappelleLuis Machuca Bezzaza
ryan.chappelle

Temuco, Chile
2010/12/18 19:35

Testing

:!: Update 2011-05-25: there's a new development branch for the BBCode plugin, at 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:

Changes

plugin/bbcode.txt · Last modified: 2013/12/14 18:50 by 217.150.76.18