GandiBlog: Text formating

You can write entries using wiki or xhtml syntax. You will need to determine the default syntax in your user preferences. You can choose to select a different syntax for a specific entry by 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 next to the type of text formating.

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.

wiki : Leave an empty line between two similar blocks.

Corresponding xhtml : <p>The first paragraph.</p></p>The second paragraph.</p>

wiki : !!! title, !! title or ! title for titles of lesser importance

Corresponding xhtml :

• !!!!!Title → <h1>Title</h1>
• !!!!Title → <h2>Title</h2>
• !!!Title → <h3>Title</h3>
• !!Title → <h4>Title</h4>
• !Title → <h5>Title</h5>

wiki : —- (four dashes, alone, on one single line)

Corresponding xhtml : <hr />

wiki : lines beginning by * for bullet point lists or # for numbered lists.

You can mesh lists together by mixing list codes. For example :

  * item 1
  ** item 1.1
  ** item 1.2
  * item 2
  * item 3
  *# item 3.1
  ...

Corresponding xhtml for the above example :

<ul>
  <li>item 1
  <ul>
    <li>item 1.1</li>
    <li>item 1.1</li>
  </ul></li>
  <li>item 2</li>
  <li>item 3
  <ol>
    <li>item 3.1</li>
  </ol></li>
</ul>

wiki : A space before each line of text.

Corresponding xhtml : <pre>preformated lines of text </pre>

wiki : > before each line of text.

Corresponding xhtml : <blockquote><p>The quote's paragraphs.</p></blockquote>

wiki : two apostrophes

''text''

Corresponding xhtml : <em>text</em>

wiki : two underscores

__text__

Corresponding xhtml : <em>text</em>

wiki :

text.%%%

Corresponding xhtml : <br />

wiki : two pluses

++text++

Corresponding xhtml : <ins>text</ins>

wiki : two dashes

--text--

Corresponding xhtml : <del>text</del>

wiki :

• [url]
• [name|url]
• [name|url|language]
• [name|url|language|title]

Corresponding xhtml :

• <a href=“url-target”>url-target</a>
• <a href=“url-target”>name</a>
• <a href=“url-target” lang=“en”>name</a>
• <a href=“url-target” lang=“en” title=“titre”>name</a>

wiki :

• ((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 :

• <img src=“url” alt=“alternative text” />
• <img src=“url” alt=“alternative text” style=“display:block; float:left; margin:0 1em 1em 0” /> (if position : L)
• <img src=“url” alt=“alternative text” style=“display:block; float:right; margin:0 0 1em 1em” longdesc=“long description” /> (if position : R)

wiki : ~anchor~

Corresponding xhtml : <a name=“anchor”></a>

wiki : ??acronym|title??

Corresponding xhtml : <acronym title=“title”>acronym</acronym>

wiki :

• {{quotation}}

• {{quotation|language}}

• {{quotation|language|url}}

Corresponding xhtml :

• <q>quotation</q>
• <q lang=“en”>quotation</q>
• <q lang=“en” cite=“url”>quotation</q>

wiki : @@code here@@

Corresponding xhtml : <code>code here</code>

wiki : text$$Note body$$

Corresponding xhtml :

text<sup>[<a href="url-blog#pnote-xxx-x" id="rev-pnote-xxx-x">x</a>]</sup>
(...)
<div class="footnotes"><h4>Notes</h4>
<p>[<a href="blog-url/#rev-pnote-xxx-x" id="pnote-xxx-x">x</a>] Note body</p></div>

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\]

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
  <p style="color:red">my red text</p>
  ///

• More XHTML tags