- Web page addresses and e-mail addresses turn into links automatically.
BBCode allows you to specify formatting rules for your text, even if you are not allowed to use HTML in your posts. BBCode originated from the forum software named PHPBB, and this site has a special implementation of it.
In BBCode terms, you use "tags" to add formatting to your text. Every tag is enclosed in [ and ] brackets. If you want to mark some region in your text, you need to use an opening tag and a closing tag. Closing tags start with [/, as you will see in the examples below. If you mistype a tag or forget to close it, you will not get the desired formatting.
Simple text formatting
BBCode allows you to make some parts of your texts stand out from the context by adding [b]old, [i]talic, [u]nderlined and [s]trikeout formatting to them. The [color], [size] and [font] tags allow you to change the color, size and font of portions of the text you enclose with these tags. Both require a parameter (which colour, how big, what font) that is suffixed to the name of the tag by an equals sign (example below). You should not repeat the parameter in the closing tag!
You can specify any recognized color name (red, blue, green, white, etc.) or a hexadecimal color value (#CDCDCD, #FFFFFF, etc.) as the parameter of a [color] tag. The [size] tag allows you to set the font size between 6 and 48, 6 being the smallest size. Note that using very large text is considered by many to be annoying, and it is seldom a good idea to try to attract more attention to your post in this way. The [font] tag can be set to any valid font face, such as Arial, Arial Black, Courier, Courier New, Helvetica, Impact, Times New Roman, Verdana, etc.
usage display I [b]need to do[/b] this by the weekend I need to do this by the weekend John said that [i]we should[/i] ask her John said that we should ask her I [u]would not like to[/u] offend you I would not like to offend you Let's correct this [s]mispelled[/s] misspelled word Let's correct this mispelledmisspelled word Jane was at [color=blue]the coast[/color] Jane was at the coast Joe was in [color=#FF0000]the forest[/color] Joe was in the forest You said: [size=30]HEY![/size] You said: HEY! She said: [font=Courier]What?[/font] She said: What?
You have multiple options to specify links to other destinations in your posts.
URLs (Uniform Resource Locators) starting with "www" or "ftp" (eg. www.example.com) are automatically recognized and replaced with links. You can also use the [url] tag with a parameter to specify a link with meaningful text to click on. If you use the url tag without the parameter, the enclosed text is assumed to be a URL, and a link is created to that destination.
Email addresses in posts are also automatically converted to email links. For compatibility with common BBCode implementations, an [email] tag is provided.
usage display For more examples, visit www.example.com For more examples, visit www.example.com For more examples, visit http://example.com For more examples, visit http://example.com If you have questions ask me at firstname.lastname@example.org If you have questions ask me at email@example.com If you have questions ask me at [email]firstname.lastname@example.org[/email] If you have questions ask me at email@example.com We use [url=http://example.com/]the example site[/url] in these examples We use the example site in these examples We use [url]http://example.com/[/url] in these examples We use http://example.com/ in these examples
The [img] tag allows you to display an image in your post. You need to specify a URL to the image, so it needs to be accessible somewhere on the internet. Beware of adding very large images to your text, or the page will load very slowly!
If you enclose a URL in an [img] tag, then it will be replaced with code to display the image. For example
A good screenshot: [img]http://example.com/screenshot.png[/img]will show you the screenshot (if it exists).
You can also specify the desired display dimensions of the image by adding a dimension parameter to the [img] tag.
A good screenshot: [img=640x480]http://example.com/screenshot.png[/img]will display the image in 640x480 (though the full image will be downloaded). Do not use this to show a thumbnail of an image!
You are free to link an image to an external destination by enclosing the [img] tag with a [url] tag:
Ordered and unordered lists
The simplest list type is the unordered list, which means that there is no numbering applied to the elements. You can make such a list by enclosing the list elements in [list] opening and closing tags. Specify the start of one element with the [*] list element marker, which has no closing tag pair.
To create an ordered list, you should add a parameter to the [list] list tag specifying what type of ordered list you would like to see. The possible parameters are "i", "I", "1", "a", "A", "c", "d" and "s" which all correspond to the display of the first list element.
I love [list] [*]Oranges [*]Apples [*]Bananas [/list]
I love [list=I] [*]Oranges [*]Apples [*]Bananas [/list]
I love [list=1] [*]Oranges [*]Apples [*]Bananas [/list]
Fixed-width text and block formatting
You can use the [code] tag to add an inline fixed-width formatted part or to add a block of (usually program) code. If there is any newline present between the opening and closing tags, then a block will be displayed.
Similarly, the [php] tag can be used to post PHP code. PHP code will automatically be syntax highlighted for easier readability.
usage display Edit your [code]robots.txt[/code] file Edit your
An HTML title example:
An HTML title example:
Some PHP code:
echo "Hello World!";
Some PHP code:
echo "Hello World!";
Text and block alignment
You can also set the alignment of the text by using [left], [right] and [center] tags. The [float] tag can be used to place floating boxes in the text (especially handy for images). You can specify the direction of the floating with [float=left] and [float=right]. The [justify] tag can be used justify text on both sides of the page.
Other supported tags
It is possible to quote something that has already been posted, by just putting [quote][/quote] tags around it. To quote a specific person, use something like [quote=John]. Quote tags can be nested.
The [sub] and [sup] tags can be used to add subscript and superscript text. For example, H[sub]2[/sub]O gives H2O, while X[sup]3[/sup] gives X3.
The [acronym] tag allow you to identify text as an acronym and provide a description when users move their mouse over the tag. For example, [acronym=Structured Query Language]SQL[/acronym] produces SQL.
The [abbr] tag allow you to identify text as an abbreviation and provide a description when users move their mouse over the tag. For example, [abbr=World Wide Web]WWW[/abbr] produces WWW.
The [notag] tags prevent text inside the tags from being parsed. This allows you to give examples of BBcode and not have it converted to HTML. For example: [notag]These [b]tags[/b] are not rendered[/notag] will produce "These [b]tags[/b] are not rendered".
The [hr] tag draws a horizontal line across the page. Handy for separating chunks of text.
Using multiple formatting tags
You can apply more than one formatting specification to a portion of some text.
I was at [b][i]the coast[/i][/b]will be rendered as
I was at the coast.
Make sure that you take care of the proper order of the opening and closing tags. You should close the tags in the opposite order in which you opened them. Otherwise you might get very strange rendering results. Also check your post with the preview function before submitting it, in case there are formatting errors due to improper BBCode usage.
You may surround a section of text with "[collapse]" and "[/collapse]" to it into a collapsible section.
You may use "[collapse]" tags within other "[collapse]" tags for nested collapsing sections.
If you start with "[collapsed]" or "[collapse collapsed]", the section will default to a collapsed state.
You may specify a title for the section in two ways. You may add a "title=" parameter to the opening tag, such as "[collapse title=<your title here>]". In this case, you should surround the title with double-quotes. If you need to include double-quotes in the title, use the html entity """. For example: '[collapse title=""Once upon a time""]'. If a title is not specified in the "[collapse]" tag, the title will be taken from the first heading found inside the section. A heading is specified using the "<hX>" html tag, where X is a number from 1-6. The heading will be removed from the section in order to prevent duplication. If a title is not found using these two methods, a default title will be supplied.
For advanced uses, you may also add a "class=" option to specify CSS classes to be added to the section. The CSS classes should be surrounded by double-quotes, and separated by spaces; e.g. '[collapse class="class1 class2"]'.
You may combine these options in (almost) any order. The "collapsed" option should always come first; things will break if it comes after "title=" or "class=". If you need to have it come after the other options, you must specify it as 'collapsed="collapsed"'; e.g. '[collapse title="foo" collapsed="collapsed"]'.
If you wish to put the string "[collapse" into the document, you will need to prefix it with a backslash ("\"). The first backslash before any instance of "[collapse" or "[/collapse" will be removed, all others will remain. Thus, if you want to display "[collapse stuff here", you should enter "\[collapse stuff here". If you wish to display "\[collapse other stuff", you will need to put in "\\[collapse other stuff". If you prefix three backslashes, two will be displayed, etc.
If you prefer, you can use angle brackets ("<>") instead of straight brackets (""). This module will find any instance of "<collapse" and change it to "[collapse" (also fixing the end of the tags and the closing tags).
You may override the settings of the filter on an individual basis using a "[collapse options ...]" tag. The possible options now are 'form="form"' or 'form="noform"', and 'default_title="..."'. For example, '[collapse options form="noform" default_title="Click me!"]'. Only the first options tag will be looked at, and the settings apply for the entire text area, not just the "[collapse]" tags following the options tag. Note that surrounding <p> and <br> tags will be removed.
This module supports some historical variants of the tag as well. The following are not recommended for any new text, but are left in place so that old uses still work. The "class=" option used to called "style=", and "style=" will be changed into "class=". If you don't put a double-quote immediately after "class=", everything up to the end of the tag or the string "title=" will be interpreted as the class string. Similarly, if you don't have a double-quote immediately following "title=", everything up to the end of the tag will be used as the title. Note that in this format, "style=" must precede "title=".
- You can insert footnotes directly into texts with
[fn]This text becomes a footnote.[/fn]. This will be replaced with a running number (the footnote reference) and the text within the [fn] tags will be moved to the bottom of the page (the footnote).
SWF Tools Filter
The basic syntax for embedding a flash file (.swf), flash movie (.flv) or audio file (.mp3) is:
If you would like to override SWF Tools and flash player default settings, you can specify additional parameters. For example:
[swf file="song.mp3" flashvars="backcolor=#AABBCC&&forecolor=#11AA11"]
If you would like to output a list of files then the format is:
SWF Tools Filter will accept following:
- params : You can specify values for parameters to be passed to Flash
to control the appearance of the output. Typical values are
bgcolor and wmode. Example:
params="wmode=true&&bgcolor="#00FF00"Alternatively you can supply each parameter individually without using
- flashvars : You can specify values for output as flashvars, which
become available to the Flash movie that is playing. This is often done
to control a media player. Refer to the documentation of the flash player
you are using to know what flashvar options are available.
- methods : Optional information about how to display the file. The most
common usage is to specify a particular media player and
thus override the default specified on the settings page.
WARNING: with params, flashvars and othervars, pass multiple values separated by &&.
- params : You can specify values for parameters to be passed to Flash to control the appearance of the output. Typical values are bgcolor and wmode. Example: