Show source 

LionWiki-t2t

Cette page explique la syntaxe de LionWiki-t2t, qui est basée sur txt2tags.

(traduction en cours)

This syntax is quite easy to learn, but it's also quite strict: if what you write differ a bit from the rules, the results might be unpredicable and deceptive. Try to especially take care of the spaces used in the syntax. To master the txt2tags markup efficiently, you are adviced to read the manual which can be found there

Entêtes

Example: 

== Heading H2 ==
=== Heading H3 ===
==== Heading H4 ====

No extra characted, except spaces (even if I personnally advice to avoid them, and instead to start writing the markup at the beginning of the line), are allowed before the heading markup. Spaces are not required around the part to be marked as heading, but it might be more readable this way.

Heading H2

Heading H3

Heading H4

Listes

Listes non ordonnées 

- Fruit
 - Apple
   - Granny smith
 - Orange
- Vegetables
 - Garlic
 - Onion

You must add exactly one space after each dash to enable the list.

  • Fruit
    • Apple
      • Granny smith
    • Orange
  • Vegetables
    • Garlic
    • Onion

Listes ordonnées 

+ First item 
 + First subitem 
  + First subsubitem
  + Second subsubitem
  + Third subsubitem
 + Second subitem
  1. First item
    1. First subitem
      1. First subsubitem
      2. Second subsubitem
      3. Third subsubitem
    2. Second subitem

Styles de texte

  • **Bold** ⇨ Bold (two stars)
  • //Italic// ⇨ Italic (two slash)
  • **//Bold and italic//** ⇨ Bold and italic (combination of the above)
  • --Strikethrough-- ⇨ Strikethrough
  • __Underlined__ ⇨ Underlined

    You can't add extra spaces at the boundaries of the part you want to mark with the styles above. This part can contain spaces (if it's a sentence), but not after the first mark, and not before the last mark : the marks must be glued with the contents.

Tableaux 

title 1  title 2 
item 1 item 2 
item 3 item 4


title 1 title 2
item 1 item 2
item 3 item 4

Syntaxe supplémentaire

En plus de la syntaxe txt2tags, voici quelques balises supplémentaires. Vous pouvez personnaliser, étendre ou configurer la plupart d'entre elles dans le fichier config.t2t à la racine du wiki, ou dans le fichier txt2tags.class.php.

  • Nombres aléatoires 

    %%rand(1,100)

    va afficher un nombre compris entre 1 et 100

    exemple:

    64

  • Barre de progression 

    [10%]

    va afficher une barre de progression de 10%

    exemple:

    (10%) 

    [3%7]

    va afficher une barre de progression de 3 sur 7

    exemple:

    (3/7)

  • Tags :

    (#keyword)

Emails, links, images

Links to other local wiki pages can be created like this: [[main]] ⇨ main

With some label, use this syntax: [[This is the main page|main]]

Which is similar to: [This is the main page index.php?page=main]

Emails and web links are automatically recognized:

You can use also relative links (inside the wiki):

Autres

Images

If you need a way to upload images (or other files), check the upload action

Subpages

Subpages are useful when you need to insert some common content into multiple pages, example could be a navigational menu or some repeated content.

Syntax: %!include:var/pages/latest.txt

Multilingual content

Let's say you have page named "Biography" in German and you would like to make French variant. Rename page Biography to Biography.de and create page named Biography.fr and insert French translation there. Then visitors whose browser identifies primary language as French will see Biography.fr. It's recommended to create a redirect from page Biography to default language variant. The obvious limitation is that page name has to stay the same in every language variant. That's not such a big problem with "Biography", but it can be worse with other names.

This is recommended way to create multilingual content, there are more ways to do it.

Table of contents

Automatically generated table of contents can be inserted with %%toc

Characters

Some sequences of characters are automatically replaced:

  • Arrows : --> : ⇨
  • Dash : --- : —

Code

Code syntax is useful when you need to keep original spacing and layout of text

Horizontal line

--------------------

HTML code

Do you want to insert youtube video to your site? Or any other HTML code? Just insert it between ''some html code''.

If you need to include a whole block, enter it like that:

'''
HTML code
more code
'''

This does not have to work if config value $NO_HTML is set to true. Note that it is serious security risk if you allow users to post HTML code in your wiki.

Newline

LionWiki joins adjacent newlines together, if you need more than one newline, use [//..].


Internal comments

You can insert internal comments not intended to be displayed using a % at the beginning of a line.

Basic Markdown support

There is also a basic Markdown support. Hash heading, strong, links, lists are supported.


#syntax