]> git.mxchange.org Git - friendica.git/blob - doc/BBCode.md
Merge remote-tracking branch 'upstream/develop' into 1604-cookie
[friendica.git] / doc / BBCode.md
1 Friendica BBCode tags reference
2 ========================
3
4 * [Home](help)
5
6 Inline
7 -----
8
9
10 <pre>[b]bold[/b]</pre> : <strong>bold</strong>
11
12 <pre>[i]italic[/i]</pre> : <em>italic</em>
13
14 <pre>[u]underlined[/u]</pre> : <u>underlined</u>
15
16 <pre>[s]strike[/s]</pre> : <strike>strike</strike>
17
18 <pre>[color=red]red[/color]</pre> : <span style="color:  red;">red</span>
19
20 <pre>[url=http://www.friendica.com]Friendica[/url]</pre> : <a href="http://www.friendica.com" target="external-link">Friendica</a>
21
22 <pre>[img]http://friendica.com/sites/default/files/friendika-32.png[/img]</pre> : <img src="http://friendica.com/sites/default/files/friendika-32.png" alt="Immagine/foto">
23
24 <pre>[size=xx-small]small text[/size]</pre> : <span style="font-size: xx-small;">small text</span>
25
26 <pre>[size=xx-large]big text[/size]</pre> : <span style="font-size: xx-large;">big text</span>
27
28 <pre>[size=20]exact size[/size] (size can be any number, in pixel)</pre> :  <span style="font-size: 20px;">exact size</span>
29
30
31
32
33
34
35
36 Block
37 -----
38
39 <pre>[code]code[/code]</pre>
40
41 <code>code</code>
42
43 <p style="clear:both;">&nbsp;</p>
44
45 <pre>[quote]quote[/quote]</pre>
46
47 <blockquote>quote</blockquote>
48
49 <p style="clear:both;">&nbsp;</p>
50
51 <pre>[quote=Author]Author? Me? No, no, no...[/quote]</pre>
52
53 <strong class="author">Author wrote:</strong><blockquote>Author? Me? No, no, no...</blockquote>
54
55 <p style="clear:both;">&nbsp;</p>
56
57 <pre>[center]centered text[/center]</pre>
58
59 <div style="text-align:center;">centered text</div>
60
61 <p style="clear:both;">&nbsp;</p>
62
63 <pre>You should not read any further if you want to be surprised.[spoiler]There is a happy end.[/spoiler]</pre>
64
65 You should not read any further if you want to be surprised.<br />*click to open/close*
66
67 (The text between thhe opening and the closing of the spoiler tag will be visible once the link is clicked. So *"There is a happy end."* wont be visible until the spoiler is uncovered.)
68
69 <p style="clear:both;">&nbsp;</p>
70
71 **Table**
72 <pre>[table border=1]
73  [tr] 
74    [th]Tables now[/th]
75  [/tr]
76  [tr]
77    [td]Have headers[/td]
78  [/tr]
79 [/table]</pre>
80
81 <table border="1"><tbody><tr><th>Tables now</th></tr><tr><td>Have headers</td></tr></tbody></table>
82
83 <p style="clear:both;">&nbsp;</p>
84
85 **List**
86
87 <pre>[list]
88  [*] First list element
89  [*] Second list element
90 [/list]</pre>
91 <ul class="listbullet" style="list-style-type: circle;">
92 <li> First list element<br>
93 </li>
94 <li> Second list element</li>
95 </ul>
96
97 [list] is equivalent to [ul] (unordered list). 
98
99 [ol] can be used instead of [list] to show an ordered list:
100
101 <pre>[ol]
102  [*] First list element
103  [*] Second list element
104 [/ol]</pre>
105 <ul class="listdecimal" style="list-style-type: decimal;"><li> First list element<br></li><li> Second list element</li></ul>
106
107 For more options on ordered lists, you can define the style of numeration on [list] argument:
108 <pre>[list=1]</pre> : decimal
109
110 <pre>[list=i]</pre> : lover case roman
111
112 <pre>[list=I]</pre> : upper case roman
113
114 <pre>[list=a]</pre> : lover case alphabetic
115
116 <pre>[list=A] </pre> : upper case alphabetic
117
118
119
120
121 Embed
122 ------
123
124 You can embed video, audio and more in a message.
125
126 <pre>[video]url[/video]</pre>
127 <pre>[audio]url[/audio]</pre>
128
129 Where *url* can be an url to youtube, vimeo, soundcloud, or other sites wich supports oembed or opengraph specifications.
130 *url* can be also full url to an ogg  file. HTML5 tag will be used to show it.
131
132 <pre>[url]*url*[/url]</pre>
133
134 If *url* supports oembed or opengraph specifications the embedded object will be shown (eg, documents from scribd).
135 Page title with a link to *url* will be shown.
136
137 Map
138 ---
139
140 <pre>[map]address[/map]</pre>
141 <pre>[map=lat,long]</pre>
142
143 You can embed maps from coordinates or addresses. 
144 This require "openstreetmap" addon version 1.3 or newer.
145
146 -----------------------------------------------------------
147
148 Abstract for longer posts
149 -------------------------
150
151 If you want to spread your post to several third party networks you can have the problem that these networks have (for example) a length limitation. 
152 (Like on Twitter)
153
154 Friendica is using a semi intelligent mechanism to generate a fitting abstract. 
155 But it can be interesting to define an own abstract that will only be displayed on the external network. 
156 This is done with the [abstract]-element. 
157 Example:
158
159 <pre>[abstract]Totally interesting! A must-see! Please click the link![/abstract]
160 I want to tell you a really boring story that you really never wanted 
161 to hear.</pre>
162
163 Twitter would display the text "Totally interesting! A must-see! Please click the link!". 
164 On Friendica you would only see the text after "I want to tell you a really ..."
165
166 It is even possible to define abstracts for separate networks:
167
168 <pre>
169 [abstract]Hi friends Here are my newest pictures![abstract]
170 [abstract=twit]Hi my dear Twitter followers. Do you want to see my new 
171 pictures?[abstract]
172 [abstract=apdn]Helly my dear followers on ADN. I made sone new pictures 
173 that I wanted to share with you.[abstract]
174 Today I was in the woods and took some real cool pictures ...
175 </pre>
176
177 For Twitter and App.net the system will use the defined abstracts.
178 For other networks (e.g. when you are using the "statusnet" connector that is used to post to GNU Social) the general abstract element will be used.
179
180 If you use (for example) the "buffer" connector to post to Facebook or Google+ you can use this element to define an abstract for a longer blogpost that you don't want to post completely to these networks.
181
182 Networks like Facebook or Google+ aren't length limited. 
183 For this reason the [abstract] element isn't used. 
184 Instead you have to name the explicit network:
185
186 <pre>
187 [abstract]These days I had a strange encounter ...[abstract]
188 [abstract=goog]Helly my dear Google+ followers. You have to read my 
189 newest blog post![abstract]
190 [abstract=face]Hello my Facebook friends. These days happened something 
191 really cool.[abstract]
192 While taking pictures in the woods I had a really strange encounter ... </pre>
193
194 The [abstract] element isn't working with the native OStatus connection or with connectors where we post the HTML. 
195 (Like Tumblr, Wordpress or Pump.io)
196
197 Special
198 -------
199
200 If you need to put literal bbcode in a message, [noparse], [nobb] or [pre] are used to escape bbcode:
201
202 <pre>[noparse][b]bold[/b][/noparse]</pre> : [b]bold[/b]