Show source 

LionWiki-t2t

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

Cette syntaxe est assez facile à apprendre, mais elle est également assez stricte : si ce que vous écrivez diffère un peu des règles, les résultats pourraient être imprévisibles et décevants. Essayez surtout de faire attention aux espaces utilisés dans la syntaxe. Pour maîtriser efficacement le balisage txt2tags, nous vous conseillons de lire le manuel qui se trouve ici.

L'aide générale sur lionwiki-t2t est ici.

Entêtes

Exemple :

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

Aucun caractère supplémentaire, à l'exception des espaces (même s'il est conseillé de les éviter et de commencer à écrire les balises au début de la ligne), n'est autorisé avant les balises de l'en-tête. Les espaces ne sont pas nécessaires autour de la partie à marquer comme titre, mais cela pourrait être plus lisible de cette façon.

Heading H2

Heading H3

Heading H4

Listes

Listes non ordonnées

- Fruit
 - Pomme
   - Granny Smith
 - Orange
- Légumes
 - Ail
 - Oignon

Vous devez ajouter exactement un espace après chaque tiret pour activer la liste.

  • Fruit
    • Pomme
      • Granny Smith
    • Orange
  • Légumes
    • Ail
    • Oignon

et passer une ligne après le dernier élément d'un liste pour la terminer (sinon l'indentation restera)

Listes ordonnées

+ Premier élément 
 + Premier sous-élément 
  + Premier sous-sous-élément
  + Deuxième sous-sous-élément
  + Troisième sous-sous-élément
 + Deuxième sous-élément
  1. Premier élément
    1. Premier sous-élément
      1. Premier sous-sous-élément
      2. Deuxième sous-sous-élément
      3. Troisième sous-sous-élément
    2. Deuxième sous-élément

Styles de texte

  • **Gras**Gras (deux étoiles)
  • //Italique//Italique (deux slash)
  • **//Gras et italique//**Gras et italique (combinaison des deux)
  • --Barré--Barré
  • __Souligné__Souligné

Vous ne pouvez pas ajouter d'espaces supplémentaires aux limites de la partie que vous voulez marquer avec les styles ci-dessus. Cette partie peut contenir des espaces (si c'est une phrase), mais pas après la première marque, ni avant la dernière : les marques doivent être collées au contenu.

Tableaux

titre 1 titre 2
élément 1 élément 2
élément 3 élément 4


titre 1 titre 2
élément 1 élément 2
élément 3 élément 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, voire même dans le fichier txt2tags.class.php (mais la première solution sera plus conseillée).

  • Nombres et valeurs aléatoires

    %%rand(1,100)

    va afficher un nombre entier compris entre 1 et 100

    exemple : 25

    %%rand

    va afficher un nombre réel compris entre 0 et 1

    exemple : 0.81788666165335

    %%rand(hibou,oie,merle noir,colombe,mouette)

    va afficher un des éléments de la liste (délimitée par les virgules, sans espace)

    exemple : hibou

  • Barre de progression

    [10%]

    va afficher une barre de progression de 10%

    exemple :

    (10%)

    On peut combiner les 2 techniques précédentes pour réaliser une barre de progression aléatoire : (89%)

    [3/7]

    va afficher une barre de progression de 3 sur 7

    exemple :

    (3/7)

  • Cases à cocher :

    • vides :

      [ ]

    • cochées :

      [v]

    • cochées (à rayer) :

      [x]

      affichera :
      ☐ item
      ☑ item
      item

      Note : Vous devrez éditer le code de la page wiki pour cocher les cases. De plus ce processus automatise certains comportements (pas de liste à puce, retour à la ligne, ligne rayée), si vous souhaitez juste afficher des cases pour un autre usage, utilisez simplement des caractères unicode !

  • Tags :

    (#motclé)

Emails, liens, images

Les liens vers d'autres pages wiki locales peuvent être créés comme suit : [[main]] : main

Pour utiliser une description, utilisez cette syntaxe : [[C'est la page principale | main]]

C'est la page principale

Ce qui est similaire à : [C'est la page principale index.php?page=main]

C'est la page principale

Un lien externe est de la forme :

[C'est le moteur de recherche duck duck go https://ddg.gg]

C'est le moteur de recherche duck duck go

Les courriers électroniques et les liens Web sont automatiquement reconnus :

Vous pouvez également utiliser des liens relatifs (à l'intérieur du wiki) :

Autres

Images

Si vous avez besoin d'un moyen de télécharger des images (ou d'autres fichiers), consultez la page d'upload.

Les images sont sur le même principe que les liens :

[https://duckduckgo.com/assets/icons/meta/DDG-iOS-icon_76x76.png]

ou avec un lien interne au wiki :

[var/upload/lionwiki-t2t_logo_color.png]

Les images au format vectoriel svg sont également possible :

[var/upload/lionwiki-t2t_logo.svg]

Sous pages

Les sous-pages sont utiles lorsque vous devez insérer un contenu commun dans plusieurs pages, par exemple un menu de navigation ou un contenu répété.

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

Contenu multi-lingual

Supposons que vous avez une page nommée "Biography" avec du contenu en allemand et que vous souhaitez en faire une variante française. Renommez la page Biography en Biography.de et créez une page nommée Biography.fr et insérez-y la traduction française. Les visiteurs dont le navigateur identifie la langue principale comme étant le français verront alors Biography.fr. Il est recommandé de créer une redirection de la page Biography vers la variante linguistique par défaut. La limitation évidente est que le nom de la page doit rester le même dans chaque variante linguistique. Ce n'est pas un gros problème avec "Biography", mais cela peut être moins parlant avec d'autres noms.

Il s'agit de la méthode recommandée pour créer du contenu multilingue, mais il existe d'autres moyens de le faire.

Table des matières

Une table des matières générée automatiquement peut être insérée avec %%toc.

Caractères

Certaines séquences de caractères sont automatiquement remplacées :

  • Flèches : --> : ⇨
  • Tirets : --- : —

Code

La syntaxe de code est utile lorsque vous devez conserver l'espacement et la disposition d'origine du texte.

  • Pour du rendu "blockquote", on utilise

    ```
    bloc de texte suite du bloc
    ```

bloc de texte
suite du bloc
  • Pour du rendu "pre", on utilise

    ``` Du code

    Du code

  • Pour du code à l'intérieur d'une phrase

    Voici ``du code`` à l'intérieur d'une phrase.

Voici du code à l'intérieur d'une phrase.

Ligne horizontale

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


code HTML

Voulez-vous insérer une vidéo youtube sur votre site ? Ou tout autre code HTML ? Il suffit de l'insérer entre''du code html''.

Si vous avez besoin d'inclure un bloc entier, entrez-le comme ça :

'''
HTML code
more code
'''

Cela ne fonctionnera pas si la valeur de configuration $NO_HTML est définie sur true dans txt2tags.class.php. Notez qu'il y a un risque de sécurité si vous permettez aux utilisateurs de poster du code HTML dans votre wiki.

Retour à la ligne

LionWiki joint les nouvelles lignes adjacentes ensemble, si vous avez besoin de plus d'une nouvelle ligne, utilisez

[//..].


Commentaires

Vous pouvez insérer des commentaires internes non destinés à être affichés en utilisant un % au début d'une ligne.

Support basique de Markdown

Il y a aussi un support basique de Markdown. Les titres avec le hashtag #, les caractères en gras avec **, les liens, les listes sont gérés car ils risquent peu d'interférer avec le texte. Les titres avec le hashtag n'entreront pas dans la table de matière (cela sera peut-être rajouté dans le futur). L'italique, avec un seul _ ou *, n'est pas géré, car son utilisation est problématique (conflit avec un caractère simple). Nous encourageons à utiliser plutôt la balise txt2tags (//texte en italique//), plus logique.

Exemples :

Les titres :

### Titre niveau 3 en markdown

Titre niveau 3 en markdown

Les liens :

[Lien markdown vers duck duck go](http://ddg.gg)

http://ddg.gg">Lien markdown vers duck duck go

Les listes :

* liste markdown
* liste markdown
  • liste markdown
  • liste markdown

Divers :

> Commentaire façon e-mail

Commentaire façon e-mail

̴̴Texte barré̴̴

Texte barré