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
- Heading H2
- Listes
- Styles de texte
- Tableaux
- Syntaxe supplémentaire
- Emails, liens, images
- Images
- Sous pages
- Contenu multi-lingual
- Table des matières
- Caractères
- Code
- Ligne horizontale
- code HTML
- Retour à la ligne
- Commentaires
- Support basique de Markdown
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
- Pomme
- 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
- 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
- Premier 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
☒itemNote : 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 !
- vides :
- Bouton :
@@
BUTTON(http://ddg.gg)@@
- 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]]
Ce qui est similaire à :
[C'est la page principale index.php?page=main]
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 :
http://www.homepage.td
⇨ http://www.homepage.tdlionwiki@example.com
⇨ lionwiki@example.com
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é
|
||