Differences

This shows you the differences between two versions of the page.

--- plugin:bbcode [2016-01-03 07:20] – Aleksandr
+++ plugin:bbcode [2024-02-02 20:33] (current) – [Syntax] Aleksandr
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: Makes the use of BBcode syntax possible. (previous authors: Esther Brunner)
+description: Makes the use of BBcode syntax possible.
-author     : Gina Häußge, Michael Klier, Luis Machuca Bezzaza
+author     : Dokufreaks (previous authors: Gina Häußge, Michael Klier, Luis Machuca Bezzaza, Esther Brunner)
-email      : luis.machuca@gulix.cl
+email      : freaks@dokuwiki.org
 type       : syntax
-lastupdate : 2010-06-04
+lastupdate : 2017-01-23
-compatible : >= 2006-11-06, Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons
+compatible : Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
 depends    :
 conflicts  :
@@ Line 13: / Line 13: @@
 tags       : formatting, markup_language
-downloadurl: http://cloud.github.com/downloads/dokufreaks/plugin-bbcode/plugin-bbcode.tgz
+downloadurl: https://github.com/dokufreaks/plugin-bbcode/archive/master.zip
 sourcerepo:  https://github.com/dokufreaks/plugin-bbcode
 bugtracker:  https://github.com/dokufreaks/plugin-bbcode/issues
+demourl   :  http://ryan.gulix.cl/tests.doku/current_/doku.php/bbcode
 ----
-:!: See the "[[#testing]]" section below for further updates!
+===== Installation =====
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ===== 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.
+This 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 [[:wiki: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.
@@ Line 35: / Line 38: @@
   [s]deleted[/s]
   [m]monospace[/m]
+  [c]small-caps[/c]
 Code and Quoting:
@@ Line 56: / Line 60: @@
 Text size:
-  [size=90%]smaller text[/size]               attribute: CSS units (px, em, %, ...), single-digit, or keywords like small; can be optionally quoted
+  [size=90%]smaller text[/size]
+Attribute can be:
+  * [[https://developer.mozilla.org/en-US/docs/Web/CSS/font-size|CSS named units]] (eg.: ''18px'', ''14pt'', ''2em'', ''120%'')
+  * [[https://developer.mozilla.org/en-US/docs/Web/CSS/font-size|CSS size keywords]] (''small'', ''large'', etc).
+  * single-digit ''0'' to ''6''
+  * Can go quoted or unquoted.
+The single-digit option such as ''size=1'' , which map from "xx-small" to "xx-large", is offered for compatibility with eg.: vBulletin-based forums.
+For a more technical rundown check [[https://developer.mozilla.org/en-US/docs/Web/CSS/font-size|CSS font-size property]] (Mozilla Developer Network).
 Text color:
-  [color=red]colored text[/color]             attribute: color name, "browser-color" name, #fff[fff] or rgb(255,255,255); can be optionally quoted
+  [color=red]colored text[/color]
-To learn more about the supported text size and color formats, you can check [[http://ryan.gulix.cl/tests/weatherwax/doku.php/bbcode|the Demo page for the BBCode Testing Branch]] FIXME (courtesy of [[user>ryan.chappelle|Luis Machuca Bezzaza]] //2011/05/28 07:48//).
+Attribute can be:
+  * A CSS base color name, such as ''color=red''
+  * An extended CSS color name ("SVG" or "X11" color names)
+  * A CSS color tuple such as ''color=#fff'' or  ''color=#ffffff''
+  * A CSS color formula such as ''color=rgb(255,255,255)''
+  * Can go quoted or unquoted.
+  * The spellings ''color'' and ''colour'' are allowed.
+For a more technical rundown check [[https://developer.mozilla.org/en-US/docs/Web/CSS/color|CSS color]] (Mozilla Documentation Network) and [[wp>X11_color_names]].
+To learn more about the supported text size and color formats, you can check [[http://ryan.gulix.cl/tests.doku/current_/doku.php/bbcode|the Demo page for the BBCode Testing Branch]] (courtesy of [[user>ryan.chappelle|Luis Machuca Bezzaza]]).
 ===== Known Issues =====
@@ Line 75: / Line 101: @@
 ==== 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.
+**Update ''2017-01-22''**: the updates described below have been long since merged into the official branch, plus now the small-caps mode which somehow eluded me (despite being right there in my testing branch for a //whole year//). There is also a new live demo site (check the top of this page for the link).
+**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:
@@ Line 82: / Line 110: @@
   * A new syntax mode for smallcaps which can be invoked with %%[c]Some Smallcaps Text[/c]%%.
   * Others...
-Useful links:
-^ Demo Page    | FIXME http://ryan.gulix.cl/tests/doku.php/bbcode FIXME |
-^ Git Repo     | https://github.com/lmachucab/plugin-bbcode/tree/bbcode-testing |
-^ Zipball (testing)  | https://github.com/lmachucab/plugin-bbcode/zipball/bbcode-testing  |
 ===== Changes =====