Difference between revisions of "Bulletin board code"

From Online Manual

Jump to: navigation, search
m (moved BBCodes Introduction to Bulletin Board Code Introduction: Never heard of them called BBCodes. If you want to create a redirect here, go for it.)
m
 
(93 intermediate revisions by 12 users not shown)
Line 1: Line 1:
'''Bulletin Board Codes''' or BBCodes are a way to format posts in SMF and in many other places online. For an explanation of the buttons in the post page, see [[http://docs.simplemachines.org/index.php?topic=57|" class="bbc_link">Basic BBCodes]]. This article explains the important concept of nesting.
+
{{Other languages}}
 +
{{TOCright}}
  
'''Nesting BBCodes'''
+
<translate><!--T:1-->
The general format of a BBCode has three parts, an opening tag, the inside content and a closing tag, as shown below:<div class="codeheader">: <a href="javascript:void(0);" onclick="return smfSelectText(this);" class="codeoperation"></a></div><code>[open]&nbsp; &nbsp; &nbsp; text inside&nbsp; &nbsp; &nbsp; [/close]
+
Bulletin Board Codes or BBCodes are a way to format posts in SMF and in many other places online. For an explanation of the buttons on the ''Post'' page, see {{llink|Basic Bulletin Board Codes|text=Basic Bulletin Board Codes}}. This article explains the important concept of nesting.
[b]&nbsp; &nbsp; &nbsp; &nbsp;  bold text&nbsp; &nbsp; &nbsp; &nbsp; [/b]</code>
 
'''Bold and italic text'''
 
You can place one BBCode tag inside another as long as ''the child tag is closed before the parent tag''. For example, the correct way to make bold and italic text is:<div class="codeheader">: <a href="javascript:void(0);" onclick="return smfSelectText(this);" class="codeoperation"></a></div><code>[b][i]bold &amp; italic text[/i][/b]</code>
 
This is shown more easily when the tags are indented:<div class="codeheader">: <a href="javascript:void(0);" onclick="return smfSelectText(this);" class="codeoperation"></a></div><code>[b]
 
&nbsp; &nbsp; [i]
 
&nbsp; &nbsp; &nbsp; &nbsp; bold &amp; italic text
 
&nbsp; &nbsp; [/i]
 
[/b]</code>
 
The next example is incorrectly nested, which is easily shown with indented tags:<div class="codeheader">: <a href="javascript:void(0);" onclick="return smfSelectText(this);" class="codeoperation"></a></div><code>[b][i]bold &amp; italic text[/b][/i]
 
  
 +
==Nesting BBCodes== <!--T:2-->
 +
 +
<!--T:3-->
 +
The general format of a BBCode tag has three parts: an opening tag, the inside content and a closing tag, as shown below:
 +
{{code|[open]      text inside      [/close]
 +
[b]        bold text        [/b]}}
 +
 +
===When Order Matters, Part 1=== <!--T:8-->
 +
 +
<!--T:9-->
 +
You can place one BBCode tag inside another as long as ''the child tag is closed before the parent tag''. For example, the correct way to make bold and italic text is:
 +
{{code|[b][i]bold & italic text[/i][/b]}}
 +
You can also do it in the following way, which is also valid, with the same tags in reverse order:
 +
 +
<!--T:9.1-->
 +
{{code|[i][b]bold & italic text[/b][/i]}}
 +
 +
<!--T:11-->
 +
The correct method can be visualized more clearly when the tags are indented:
 +
{{code|[b]
 +
    [i]
 +
        bold & italic text
 +
    [/i]
 +
[/b]}}
 +
 +
<!--T:12-->
 +
The next example is incorrectly nested. The last two lines show that the parent tag <nowiki>[b]</nowiki> was closed before the child tag <nowiki>[i]</nowiki>.
 +
{{code|[b][i]bold & italic text[/b][/i]
 
[b]
 
[b]
&nbsp; &nbsp; [i]
+
    [i]
&nbsp; &nbsp; &nbsp; &nbsp; bold &amp; italic text
+
        bold & italic text
 
[/b]
 
[/b]
&nbsp; &nbsp; [/i]</code>
+
    [/i]}}
 +
 
 +
===When Order Matters, Part 2=== <!--T:16-->
 +
 
 +
<!--T:19-->
 +
The order in which tags are nested is important when text-formatting tags such as ''size'', ''bold'', or ''italic'' are paired with the text-alignment tags ''center'', ''left'', ''right'', and ''pre''. Formatting tags must be placed inside alignment tags. For example, for the size tag to change the font, it must be placed as follows:
 +
 
 +
<!--T:20-->
 +
{{code|<nowiki>[center][size=36pt][b][u]text[/u][/b][/size][/center]</nowiki>}}
 +
 
 +
<!--T:21-->
 +
Nesting the size tags as per the example below will result in this tag not working:
 +
 
 +
<!--T:22-->
 +
{{code|<nowiki>[size=36pt][center][b][u]text[/u][/b][/center][/size]</nowiki>}}
 +
 
 +
==See Also== <!--T:23-->
 +
 
 +
<!--T:24-->
 +
* {{llink|Basic Bulletin Board Codes|text=Basic Bulletin Board Codes}}
 +
* {{llink|Alphabetical list of all bulletin board codes|text=Alphabetical list of all bulletin board codes}}
 +
</translate>
 +
{{ {{Localized|As a regular user}}}}

Latest revision as of 17:57, 2 July 2014

Bulletin Board Codes or BBCodes are a way to format posts in SMF and in many other places online. For an explanation of the buttons on the Post page, see Basic Bulletin Board Codes. This article explains the important concept of nesting.

Nesting BBCodes

The general format of a BBCode tag has three parts: an opening tag, the inside content and a closing tag, as shown below:

[open]      text inside      [/close]
[b]         bold text        [/b]

When Order Matters, Part 1

You can place one BBCode tag inside another as long as the child tag is closed before the parent tag. For example, the correct way to make bold and italic text is:

[b][i]bold & italic text[/i][/b]

You can also do it in the following way, which is also valid, with the same tags in reverse order:

[i][b]bold & italic text[/b][/i]

The correct method can be visualized more clearly when the tags are indented:

[b]
    [i]
        bold & italic text
    [/i]
[/b]

The next example is incorrectly nested. The last two lines show that the parent tag [b] was closed before the child tag [i].

[b][i]bold & italic text[/b][/i]
[b]
    [i]
        bold & italic text
[/b]
    [/i]

When Order Matters, Part 2

The order in which tags are nested is important when text-formatting tags such as size, bold, or italic are paired with the text-alignment tags center, left, right, and pre. Formatting tags must be placed inside alignment tags. For example, for the size tag to change the font, it must be placed as follows:

[center][size=36pt][b][u]text[/u][/b][/size][/center]

Nesting the size tags as per the example below will result in this tag not working:

[size=36pt][center][b][u]text[/u][/b][/center][/size]

See Also