====== GandiBlog: Text formating ====== You can write entries using wiki or xhtml syntax. You will need to determine the default syntax in [[en:blogs:user-preferences|your user preferences]]. You can choose to select a different syntax for a specific entry by [[en:blogs:entries#creating-and-editing|choosing the text format]] thanks to the scrolling menu in the right-hand column. The short description below is also available from the entry editing interface, by clicking the {{en:blogs:help.png}} next to the type of text formating. \\ ===== Wiki syntax reference ===== The wiki syntax is a way to enhance your text with a minimal set of tags, studied to cover the basic needs (titles, paragraphs, quotes, lists...). These tags are then interpreted by the blog and converted into xhtml. If you do not master xhtml perfectly and don't use the WYSIWYG mode, it is strongly recommended to use wiki in order to avoid any error which could generate malfunctions in the blog's display. ==== Block elements ==== === Blocks === **wiki :** Leave an empty line between two similar blocks. **Corresponding xhtml :** ''
The first paragraph.
The second paragraph.'' === Titles === **wiki :** !!! title, !! title or ! title for titles of lesser importance **Corresponding xhtml :** * !!!!!Title -> ''
* item 1
** item 1.1
** item 1.2
* item 2
* item 3
*# item 3.1
...
**Corresponding xhtml** for the above example :
preformated lines of text'' === Block quote : === **wiki :** ''>'' before each line of text. **Corresponding xhtml :** ''
'' ==== Formating elements ==== === Emphasis === **wiki :** two apostrophesThe quote's paragraphs.
''text''
**Corresponding xhtml :** ''text''
=== Strong emphasis : ===
**wiki :** two underscores __text__
**Corresponding xhtml :** ''text''
=== New line ===
**wiki :** text.%%%
**Corresponding xhtml :** ''++text++
**Corresponding xhtml :** ''text''
=== Deletion ===
**wiki :** two dashes --text--
**Corresponding xhtml :** ''%%((url|alternative text))
* ((url|alternative text|position))
* ((url|alternative text|position|long description))
The position can be called L (for left) or R (for right) or C (centered).
**Corresponding xhtml :**
* ''''
* '''' (if position : L)
* '''' (if position : R)
=== Anchor ===
**wiki :** ~anchor~
**Corresponding xhtml :** ''''
=== Acronym ===
**wiki :** ??acronym|title??
**Corresponding xhtml :** ''acronym''
=== Inline quotation ===
**wiki :**
* {{quotation}}
* {{quotation|language}}
* {{quotation|language|url}}
**Corresponding xhtml :**
* ''quotation'' * ''
quotation
''
* ''quotation
''
=== Code ===
**wiki :** @@code here@@
**Corresponding xhtml :** ''code here
''
=== Footnotes ===
**wiki :** text$$Note body$$
**Corresponding xhtml :**
text[x]
(...)
Notes
[x] Note body
==== Complementary ====
=== Unformatted text ===
To insert a character without it being recognized as a formatting character, add a backslash ( \ ) in front of it. For example : \[text in brackets which isn't a link\]
=== Inserting HTML code within the wiki syntax ===
You may punctually need to insert HTML code within your wiki-formatted text. To do so, use the following code and leave a blank line before and after the insertion:
///html
my red text
/// \\ ===== Going further ===== * [[http://www.webreference.com/xml/reference/xhtml.html|More XHTML tags]] ----