====== Input syntaxes ======

You can type your entries using the wiki or xhtml syntaxes. The default syntax is specified in the [[user-preferences|User preferences]]. You may change it for an individual entry by [[entries#choisir-le-type-de-saisie|selecting the syntax]] from the small drop-down menu in the right column of the entry edition interface.

A summary of the description below is available in the Help panel of the entry edition interface. To display the Help panel, click on the blue Help button on the top right corner of the page.


===== Wiki syntax and XHTML equivalent =====

**Presentation :** Based on simple tags, the wiki syntax allows you to enhance the layout of your text without the need for specific skills. These tags are then interpreted by the blog engine and converted into xhtml. If you don't have a good knowledge of xhtml and you don't use the [[:glossary#wysiwyg|wysiwyg]] mode, you are strongly recommended to use wiki to avoid any error that might cause problems in the blog's layout.

==== Block-level elements ====

=== Blocks ===

**wiki :** Leaves an empty line between each block of same nature.


=== Paragraphs ===

**wiki :**  free text, ending with an empty line if followed by another paragraph.

**xhtml equivalent :** ''<p>First paragraph.</p></p>Second paragraph.</p>''

=== Titles ===

**wiki :** !!! title, !! title or ! title for more or less important titles.

**xhtml equivalent :**
  * !!!!!Title -> ''<h1>Title</h1>''
  * !!!!Title -> ''<h2>Title</h2>''
  * !!!Title -> ''<h3>Title</h3>''
  * !!Title -> ''<h4>Title</h4>''
  * !Title -> ''<h5>Title</h5>''

<note>
the <h1> level is already used for the blog title and the <h2> level for the entry titles, so you should only use <h3> level and below within your entries.
</note>

=== Horiontal line ===

**wiki :** ---- (four hyphens isolated on one line)

**xhtml equivalent :** ''<hr />''

=== Lists ===

**wiki :** lines starting with * for bulleted lists or # for numbered lists

You can create embedded lists by mixing list codes. For example:
<code>
  * item 1
  ** item 1.1
  ** item 1.2
  * item 2
  * item 3
  *# item 3.1
  ...
</code>

**xhtml equivalent** fo the sample above :
  <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>

=== Preformatted text ===

**wiki :** one space before every line of text.

**xhtml equivalent :** ''<pre>preformatted lines of text</pre>''


=== Quotation blocks : ===

**wiki :** ''>'' before each line of text.

**xhtml equivalent :** ''<blockquote><p>Quotation paragraphs.</p></blockquote>''



==== Style tags ====

=== Emphasis ===

**wiki :** two simple quote marks <code>''text''</code>

**xhtml equivalent :** ''<em>text</em>''

=== Strong emphasis : ===

**wiki :** two underscores <code>__text__</code>

**xhtml equivalent :** ''<strong>text</strong>''

=== Forced line break ===

**wiki :** <code>text.%%%</code>

**xhtml equivalent :** ''<br />''

=== Insertion ===

**wiki :** two plus signs <code>++text++</code>

**xhtml equivalent :** ''<ins>text</ins>''

=== Deletion ===

**wiki :** two hyphens <code>--text--</code>

**xhtml equivalent :** ''%%<del>text</del>%%''

=== Links ===

**wiki :** 
  * [url]
  * [nom|url]
  * [nom|url|language]
  * [nom|url|language|title]

**xhtml equivalent :**
  * ''<a href="target-url">target-url</a>''
  * ''<a href="target-url">name</a>''
  * ''<a href="target-url" lang="en">name</a>''
  * ''<a href="target-url" lang="en" title="title">name</a>''

=== Images ===
**wiki** :
  * <code>((url|alt text))</code>
  * <code>((url|alt text|position))</code>
  * <code>((url|alt text|position|long description))</code>
The values for "position" can be L or G (left), R or D (right) or C (centered).

**xhtml equivalent :**
  * ''<img src="url" alt="alt text" />''
  * ''<img src="url" alt="alt text" style="display:block; float:left; margin:0 1em 1em 0" />'' (if position : L or G)
  * ''<img src="url" alt="alt text" style="display:block; float:right; margin:0 0 1em 1em" longdesc="long description" />'' (if position : R or D)

=== Anchor ===

**wiki :** ~anchor~

**xhtml equivalent :** ''<a name="anchor"></a>''

=== Acronym ===

**wiki :** ??acronym|title??

**xhtml equivalent :** ''<acronym title="title">acronym</acronym>''

=== Inline quote ===

**wiki :** 
  * <code>{{quote}}</code>
  * <code>{{quote|language}}</code>
  * <code>{{quote|language|url}}</code>

**xhtml equivalent :**
  * ''<q>quote</q>''
  * ''<q lang="en">quote</q>''
  * ''<q lang="en" cite="url">quote</q>''

=== Code ===

**wiki :** @@a bit of code@@

**xhtml equivalent :** ''<code>a bit of code</code>''

=== Footnot ===

**wiki :** texte$$Note content$$

**xhtml equivalent :**
<code>
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="url-blog/#rev-pnote-xxx-x" id="pnote-xxx-x">x</a>] Note content</p></div>
</code>

==== Extras ====

=== Preventing text formatting ===

To insert a character that you don't want to be interpreted as a formatting character, add a \ before it. For example \[this text between brackets is not a link\]

=== Inserting HTML within wiki syntax ===

You may need to insert HTML code within your wiki formatted text from time to time. To do that, use the following code and leave an empty line before and after this portion:

    ///html
    <p style="color:red">my text in red</p>
    ///



===== To go further =====

  * [[http://www.w3schools.com/tags/default.asp|All xhtml tags]]
  * [[http://validator.w3.org/|XHTML validator]]