BBCode Guide

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.

Creating links

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.

Displaying images

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: See [url=http://example.com][img]http://example.com/screenshot.png[/img][/url].

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.

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 H₂O, while X[sup]3[/sup] gives X³.

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.

Toegelaten HTML-tags: <a><p><span><div><h1><h2><h3><h4><h5><h6><img><map><area><hr><br><br/><ul><ol><li><dl><dt><dd><table><tr><td><em><b><u><i><strong><font><del><ins><sub><sup><quote><blockquote><pre><address><code><cite><embed><object><strike><caption>

Op deze site kan HTML worden gebruikt. Terwijl het leren van de volledige HTML-code overweldigend kan zijn, is het leren van een beperkte aantal basis HTML-'tags' veel eenvoudiger. Deze tabel geeft een aantal voorbeelden van iedere tag die op deze site kan worden gebruikt.

Voor meer informatie zie de HTML-specificaties van W3C of gebruik uw favoriete zoekmachine om een site te te vinden die uitleg over HTML geeft.

Voorgeformateerd

De meest gebruikelijke karakters kunnen direct ingegeven worden zonder problemen.

Indien u wel problemen ondervindt, probeer dan eens HTML-karaters te gebruiken. Een standaard voorbeeld is &amp; voor een ampersand &-karakter. Voor een volledige lijst van karakters: zie HTML's entititeiten-pagina. Een aantal van de beschikbare karakters zijn:

Gebruikt aangepast PHP-code

In sommige inhoudstypen, waaronder berichten en blokken, kan eigen PHP-code geplaatst worden. Wanneer dit door een betrouwbare gebruiker met PHP-ervaring wordt gedaan biedt dit krachtige en flexibele functionaiteit, maar het is ook een groot veiligheidsrisico wanneer het onjuist gebruikt wordt. Zelfs een kleine vergissing bij het plaatsen van PHP-code kan inbreuk doen op uw site.

Als u onbekend bent met PHP, SQL of Drupal maak dan geen gebruik van eigen PHP-code in berichten. Experimenten met PHP kunnen uw database beschadigen, uw site onbruikbaar maken of de veiligheid sterk verminderen.

Aantekeningen:

• Controleer iedere regel op syntax en logische fouten voordat u deze opslaat.
• Statements dienen met puntkomma's te worden afgesloten.
• Globale variabelen die gebruikt worden in uw PHP-code behouden hun waarden nadat uw script is uitgevoerd.
• register_globals is uitgeschakeld. Als u formulieren wil gebruiken, maak dan gebruik van de beschikbare functies in de Drupal Form API.
• Gebruik print of return in uw code om inhoud naar het scherm te schrijven.
• Ontwikkel en test uw PHP-code met behulp van test-scripts en voorbeeld database-gegevens voordat de code op een productiesite wordt toegepast.
• Overweeg om uw PHP-code in een site-specifieke module of in het template.php-bestand op te nemen in plaats van deze direct in een pagina of een blok te plaatsen.
• Met het PHP-filter kan PHP-code aan de website-inhoud worden toegevoegd. Let op: wanneer deze module is uitgeschakeld of verwijderd zal de toegevoegde PHP-code als tekst worden weergegeven en als PHP-code worden uitgevoerd.

Een eenvoudig voorbeeld: Een 'welkomblok' maken dat bezoekers met een eenvoudige tekst begroet.

• Voeg een nieuw blok genaamd 'Welkom', toe aan uw site. Stel het invoerformaat in op 'PHP code' (of elk ander formaat dat PHP invoer ondersteunt) en voeg dit toe aan de berichttekst van het blok:

  print t('Welkom! Dank voor uw bezoek.');
  

• Om de naam van een geregistreerde gebruiker weer te geven gebruikt u:

  global $user;
  if ($user->uid) {
    print t('Welkom @name! Dank voor uw bezoek.', array('@name' => $user->name));
  }
  else {
    print t('Welkom! Dank voor uw bezoek.');
  }
  

Drupal.org biedt enige voorbeeld-PHP-knipsels, of u kunt uw eigen maken met enige PHP ervaring en kennis van het Drupal systeem.

Video Filter

You may insert videos from popular video sites by using a simple tag [video:URL].

Examples:

• Single video:
  [video:http://www.youtube.com/watch?v=uN1qUeId]
• Random video out of multiple:
  [video:http://www.youtube.com/watch?v=uN1qUeId1,http://www.youtube.com/watch?v=uN1qUeId2]
• Override default autoplay setting: [video:http://www.youtube.com/watch?v=uN1qUeId autoplay:1]
• Override default width and height:
  [video:http://www.youtube.com/watch?v=uN1qUeId width:X height:Y]
• Align the video:
  [video:http://www.youtube.com/watch?v=uN1qUeId align:right]

Supported sites: YouTube, Google Video, Tangle, DailyMotion, Eyespot, Revver, Vimeo, Flickr Slideshows, Flickr Video, Game Videos, Meta Cafe, Game Trailers, College Humor, MySpace, Capped, Blip.tv, Slideshare, Picasa Slideshows.

Special instructions:

• Slideshare:
  You need to construct your own URL, using the "Wordpress Embed" code from Slideshare, extract the "id" and "doc" parts, and form the URL like this: slideshare.net/?id=1759622&doc=usingdrupal-090723103440-phpapp01.
• Picasa Slideshows:
  You must use the URL of the RSS feed for the Picasa album:
  1. View the album in Picasa (you should see thumbnails, not a slideshow).
  2. Find the "RSS" link and click it.
  3. Copy the resulting URL from the browser address bar. Example:
     [video: http://picasaweb.google.com/data/feed/base/user/USER_NAME/albumid/5568104935784209834?alt=rss&kind=photo&hl=en_US]