mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-29 19:40:28 +00:00
98 lines
2.7 KiB
Plaintext
98 lines
2.7 KiB
Plaintext
|
created: 20150103184022184
|
||
|
|
modified: 20150621143842068
|
||
|
|
title: $:/plugins/tiddlywiki/railroad/syntax
|
||
|
|
type: text/vnd.tiddlywiki
|
||
|
|
|
||
|
|
Le widget railroad utilise une notation spéciale pour construire les composants définis çi-après.
|
||
|
|
|
||
|
|
Ici, `x` et `y` remplacent tout composant.
|
||
|
|
|
||
|
|
Les noms (contrairement aux chaines cotées) ne sont composés que de valeurs débutant par une lettre et contenant seulement lettres, chiffres, soulignements, points et traits d'union.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; série
|
||
|
|
: <$railroad text=""" ["<-"] {x} ["->"] """/>
|
||
|
|
* Une série de composants
|
||
|
|
* Les délimiteurs `<-` et `->` permettent d'obliger un composant unique à être traité comme une série. C'est parfois utile pour mettre en valeur un diagramme
|
||
|
|
---
|
||
|
|
|
||
|
|
; optionnel
|
||
|
|
: <$railroad text=""" "[" [":"] x "]" """/>
|
||
|
|
* Un composant qui peut être omis
|
||
|
|
* Les deux points font qu'`x` soit en tout premier
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; répété
|
||
|
|
: <$railroad text=""" "{" x [:"+" y] "}" """/>
|
||
|
|
* Une liste d'un ou plusieurs `x`
|
||
|
|
* Le suffixe `+` ajoute `y` comme séparateur entre tout `x` et le suivant
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; répétition optionnelle
|
||
|
|
: <$railroad text=""" "[{" [":"] x [:"+" y] "}]" """/>
|
||
|
|
* Une liste optionnelle de `x`, i.e. une liste de zéro ou plusieurs `x`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; choix
|
||
|
|
: <$railroad text=""" "(" {[:":"] x +"|"} ")" """/>
|
||
|
|
* Un ensemble d'alternatives
|
||
|
|
* Les deux points indiquent quelle branche arrive en tout premier. Par défaut, c'est la première branche
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; chaine / terminal
|
||
|
|
: <$railroad text={{$:/plugins/tiddlywiki/railroad/syntax-string}}/>
|
||
|
|
* Un composant littéral ou terminal
|
||
|
|
* Ci-après les règles ~TiddlyWiki normales pour les chaines cotées
|
||
|
|
---
|
||
|
|
|
||
|
|
; nonterminal
|
||
|
|
: <$railroad text=""" (nom | "<" chaine ">") """/>
|
||
|
|
* Un composant nonterminal, i.e. le nom d'un autre diagramme
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; commentaire
|
||
|
|
: <$railroad text=""" "/" chaine "/" """/>
|
||
|
|
* Un commentaire
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; dummy
|
||
|
|
: <$railroad text=""" "-" """/>
|
||
|
|
* L'absence de composant
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; lien
|
||
|
|
: <$railroad text=""" "[[" x "|" (nom|chaine) "]]" """/>
|
||
|
|
* Un lien vers le titre d'un tiddler ou l'URI donné par la chaine ou le nom
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; transclusion
|
||
|
|
: <$railroad text=""" "{{" (nom|chaine) "}}" """/>
|
||
|
|
* Interprète le contenu d'un autre tiddler comme un diagramme syntaxique et le transclut dans le diagramme courant
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; pragma arrow
|
||
|
|
: <$railroad text=""" "\flêche" ("oui" | "non") """/>
|
||
|
|
* Contrôle si les chemins répétés ont une flêche ou pas
|
||
|
|
* Peut être réglé sur oui ou non dans un diagramme intermédiaire, si désiré
|
||
|
|
---
|
||
|
|
|
||
|
|
; pragma debug
|
||
|
|
: <$railroad text=""" "\debug" """/>
|
||
|
|
* Provoque l'affichage du diagramme syntaxique d'un diagramme
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
; pragma start/end
|
||
|
|
: <$railroad text=""" ("\start" |: "\end") ("aucun" |: "simple" | "double") """/>
|
||
|
|
* Règle le style des diagrammes startpoint ou endpoint
|