tiddlywiki 5.2.0 → 5.2.3

package/editions/fr-FR/tiddlers/{Transclusion_in_WikiText.tid → wikitext/Transclusion in WikiText.tid }

@@ -1,31 +1,31 @@
 caption: Transclusion
 created: 20131205160146648
-fr-title: Transclusion grâce à WikiText
-modified: 20150622084011069
+fr-title: Transclusion en WikiTexte
+modified: 20220417223717492
 tags: WikiText
 title: Transclusion in WikiText
 type: text/vnd.tiddlywiki
 
 ! Introduction
 
-Vous pouvez insérer le contenu d'un tiddler dans un autre en utilisant les marques de transclusion :
+Vous pouvez insérer le contenu d'un tiddler dans un autre en utilisant les marques de <<fr Transclusion>><<:>>
 
 * `{{MonTiddler}}` transclut un seul tiddler
 * `{{MonTiddler||TitreDuGabarit}}` affiche un tiddler via un format spécifié par un [[Gabarit de Tiddler|TemplateTiddlers]]
-* `{{||TitreDuGabarit}}` affiche le [[Tiddler en cours|currentTiddler Variable]] par le gabarit spécifié sans l'altérer 
+* `{{||TitreDuGabarit}}` affiche le gabarit spécifié sans altérer le [[Tiddler en cours|currentTiddler Variable]]
 
 !! Transclure les Références de Texte
 
-Vous pouvez aussi utiliser une [[Référence de Texte|TextReference]] à la place du titre d'un tiddler&nbsp;:
+Vous pouvez aussi utiliser une [[Référence de Texte|TextReference]] à la place du titre d'un tiddler<<:>>
 
 * `{{MonTiddler!!champ}}` transclut un champ spécifique d'un tiddler quelconque
 * `{{!!champ}}` transclut le champ spécifique du tiddler courant
 * `{{MonTiddler##index}}` transclut une propriété indexée spécifique d'un [[Tiddler Data|DataTiddlers]]
 * `{{##index}}` transclut une propriété indéxée spécifique du [[Tiddler Data|DataTiddlers]] courant
 
-!! Transclusion Filtrées
+!! Transclusion Filtrée
 
-Une syntaxe similaire peut être mise en œuvre pour transclure une liste de tiddler selon des critères particuliers définis par un&nbsp;[[Filtre|Filters]] &nbsp;:
+Une syntaxe similaire peut être mise en œuvre pour transclure une liste de tiddlers définie par un [[filtre|Filters]]<<:>>
 
 ```
 {{{ [tag[mécanisme]] }}}
@@ -34,7 +34,7 @@ Une syntaxe similaire peut être mise en œuvre pour transclure une liste de tid
 
 ! Widgets Générés
 
-La syntaxe de transclusion de [[WikiTexte|WikiText]] génère un TiddlerWidget enveloppé dans un TranscludeWidget. Par exemple, `{{MonTiddler||MonGabarit!!monChamp}}` génère cette paire de widgets:
+La syntaxe de transclusion en <<fr WikiText>> génère un <<fr TiddlerWidget>> enveloppé dans un <<fr TranscludeWidget>>. Par exemple, `{{MonTiddler||MonGabarit!!monChamp}}` génère cette paire de widgets<<:>>
 
 {{MonTiddler||MonGabarit!!monChamp}}
 
@@ -46,8 +46,9 @@ La syntaxe de transclusion de [[WikiTexte|WikiText]] génère un TiddlerWidget e
 
 Voir Aussi&nbsp;:
 
-* [[Transclusion, Utilisation basique|Transclusion Basic Usage]]
-* [[Transclusion par Gabarits|Transclusion with Templates]]
-* [[Tiddlers Gabarits|TemplateTiddlers]]
-* [[Widget Transclude|TranscludeWidget]]
-* [[Transclusion and Substitution]]
+* <<fr "Transclusion Basic Usage">>
+* <<fr "Transclusion with Templates">>
+* <<fr "TemplateTiddlers">>
+* <<fr "TranscludeWidget">>
+* <<fr "Transclusion and Substitution">>
+* <<fr "WikiText parser mode: transclusion examples">>

package/editions/fr-FR/tiddlers/{Transclusion_with_Templates.tid → wikitext/Transclusion with Templates.tid }

@@ -1,6 +1,7 @@
+caption: Par Gabarits
 created: 20141129210304238
 fr-title: Transclusion par gabarits
-modified: 20150624091314988
+modified: 20220417224336239
 tags: [[Transclusion in WikiText]]
 title: Transclusion with Templates
 type: text/vnd.tiddlywiki

package/editions/fr-FR/tiddlers/{Typed_Blocks_in_WikiText.tid → wikitext/Typed Blocks in WikiText.tid }

@@ -1,12 +1,12 @@
 caption: Blocs typés
 created: 20131205161051792
-fr-title: Les blocs typés avec WikiText
-modified: 20150601071506502
+fr-title: Blocs typés en WikiTexte
+modified: 20220422133134883
 tags: WikiText
 title: Typed Blocks in WikiText
 type: text/vnd.tiddlywiki
 
-WikiText peut inclure des blocs de textes qui seront renvoyés avec un contenu lié à leur  ContentType, comme cela :
+Le <<fr WikiText>> peut inclure des blocs de texte qui seront interprétés selon le type de leur contenu, aussi appelé <<gf "type MIME">>. Ces blocs sont déclarés ainsi<<:>>
 
 ```
 $$$image/svg+xml
@@ -15,8 +15,7 @@ $$$image/svg+xml
 </svg>
 $$$
 ```
-
-Ce qui affichera&nbsp;::
+affichera ceci<<:>>
 
 $$$image/svg+xml
 <svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
@@ -24,7 +23,8 @@ $$$image/svg+xml
 </svg>
 $$$
 
-Il est aussi possible d'abréger la déclaration du ContentType par son extension. Exemple&nbsp;:
+
+Il est aussi possible de remplacer la déclaration du type de contenu par l'extension de fichier correspondante. Exemple<<:>>
 
 ```
 $$$.svg
@@ -34,7 +34,7 @@ $$$.svg
 $$$
 ```
 
-Ce qui affichera&nbsp;:
+affichera ceci<<:>>
 
 $$$.svg
 <svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
@@ -42,7 +42,7 @@ $$$.svg
 </svg>
 $$$
 
-Les types inconnus s'afficheront comme du texte brut&nbsp;:
+Les types inconnus s'afficheront comme du texte brut<<:>>
 
 ```
 $$$text/unknown
@@ -50,30 +50,35 @@ Du texte brut, qui ne sera pas //mis en forme//.
 $$$
 ```
 
-Ce qui affichera&nbsp;:
+affichera ceci<<:>>
 
 $$$text/unknown
 Du texte brut, qui ne sera pas //mis en forme//.
 $$$
 
-Un rendu spécifique peut-être indiqué, déterminant l'affichage d'un rendu de texte particulier. Par exemple&nbsp;:
+Un format de rendu peut être indiqué en complément, qui sélectionnera un format différent pour le résultat. Par exemple<<:>>
 
 ```
 $$$text/vnd.tiddlywiki>text/html
 Ceci est un ''peu'' de wikitext
 $$$
+```
+et
 
+```
 $$$text/vnd.tiddlywiki>text/plain
 Ceci est un ''peu'' de wikitext
 $$$
 ```
 
-Afficheront respectivement&nbsp;:
+afficheront respectivement<<:>>
 
 $$$text/vnd.tiddlywiki>text/html
 Ceci est un ''peu'' de wikitext
 $$$
 
+et<<:>>
+
 $$$text/vnd.tiddlywiki>text/plain
 Ceci est un ''peu'' de wikitext
 $$$

package/editions/fr-FR/tiddlers/{Variables_in_WikiText.tid → wikitext/Variables in WikiText.tid }

@@ -1,7 +1,7 @@
 caption: Variables
 created: 20141002141231992
-fr-title: Les variables dans WikiTexte
-modified: 20150619174321458
+fr-title: Les variables en WikiTexte
+modified: 20220422140804855
 tags: WikiText
 title: Variables in WikiText
 type: text/vnd.tiddlywiki
@@ -10,10 +10,9 @@ Voir aussi une [[introduction au concept de variables|Variables]].
 
 Pour transclure la valeur d'une variable, utilisez la [[syntaxe d'appel de macro|Macro Calls in WikiText]] sans paramètres. Vous pouvez aussi utiliser un widget <<.wlink MacroCallWidget>>.
 
-Le code d'une [[macro|Macros]] snippet peut contenir une [[zoneréservée|Macro Definitions in WikiText]] `$(name)$` où la valeur d'une variable sera substituée à son nom.
+Le ''code de définition'' d'une [[macro|Macros]] peut contenir une [[ZoneRéservée|Macro Definitions in WikiText]] `$(nom)$` où la valeur d'une variable remplacera son nom.
 
-La valeur d'une variable peut être utilisée comme [[paramètre de filtre|Filter Parameter]], ou comme [[attribut de widget|Widgets in WikiText]]. 
-Ce dernier prenant en charge les paramètres de macro.
+La valeur d'une variable peut être utilisée comme [[paramètre de filtre|Filter Parameter]], ou comme [[attribut de widget|Widgets in WikiText]]. Ce dernier cas prend en charge les paramètres de macro.
 
 !! Exemple<<:>> définition d'une variable
 
@@ -22,9 +21,9 @@ eg="""<$set name=animal value=zèbre>
 <<animal>>
 </$set>"""/>
 
-!! Exemple: définition d'une macro
+!! Exemple<<:>> définition d'une macro
 
-Le pragma `\define` çi-après [[définit une macro|Macros in WikiText]] nommée <<.var tags>>. La macro renvoie la valeur du champ <<.field tags>> du tiddler, et peut être appelé partout dans le tiddler (ou dans tout tiddler qui l'[[importe|ImportVariablesWidget]]).
+Le pragma `\define` ci-dessous [[définit une macro|Macros in WikiText]] nommée <<.var tags-of-current-tiddler>>. La macro renvoie la valeur du champ <<.field tags>> du tiddler, et peut être appelé partout dans le tiddler (ou dans tout tiddler qui l'[[importe|ImportVariablesWidget]]).
 
 <$importvariables filter="$:/editions/tw5.com/macro-examples/tags-of-current-tiddler">
 <$codeblock code={{$:/editions/tw5.com/macro-examples/tags-of-current-tiddler}}/>
@@ -33,6 +32,6 @@ Le pragma `\define` çi-après [[définit une macro|Macros in WikiText]] nommée
 
 !! Exemple<<:>> utilisation de variables comme paramètres de filtre
 
-Cet exemple utilise l'[[opérateur|Filter Operators]] <<.olink backlinks>> pour lister tous les tiddlers liés à celui-çi.
+Cet exemple utilise l'[[opérateur|Filter Operators]] <<.olink backlinks>> pour lister tous les tiddlers contenant des liens vers celui-ci.
 
 <$macrocall $name=".example" n="3" eg="""<<list-links filter:"[<currentTiddler>backlinks[]]">>"""/>

package/editions/fr-FR/tiddlers/wikitext/Widgets in WikiText.tid

@@ -0,0 +1,30 @@
+caption: Widgets
+created: 20131205160840915
+fr-title: Widgets en WikiTexte
+modified: 20220422141848039
+tags: WikiText
+title: Widgets in WikiText
+type: text/vnd.tiddlywiki
+
+Les widgets enrichissent les fonctionnalités du <<fr WikiText>>. Ils ont la même syntaxe que les [[éléments HTML|HTML in WikiText]], mais leur nom de balise commence toujours par `$`. Par exemple<<:>>
+
+```
+<$button message="tm-close-tiddler">Fermez Moi !</$button>
+```
+
+Notez que les widgets héritent de toutes les caractéristiques du <<fr "HTML in WikiText">><<:>>
+
+* Les attributs des widgets peuvent être spécifiés via<<:>>
+** Des chaînes non-cotées (si elles ne contiennent pas d'espace)
+** Des chaînes cotées par simple `'` ou double `"` cotes
+** Des chaînes cotées par des doubles cotés triplées `"""`
+** Des appels de Macro (c-à-d `attr=<<maMacro>>`)
+** Des transclusions (eg, `attr={{MonTiddler!!champ}}`)
+* Le contenu d'un widget est [[analysé|WikiText Parser Modes]] en [[mode en ligne|Inline Mode WikiText]] sauf si la balise d'ouverture est suivie par deux sauts de ligne, ce qui force le [[mode bloc|Block Mode WikiText]].
+** Le [[mode en ligne|Inline Mode WikiText]] signifie que les règles d'analyse en [[mode bloc|Block Mode WikiText]] comme les rubriques, les tables, les listes, ... ne sont pas reconnues.
+
+Voir <<fr "HTML in WikiText">> pour plus de détails.
+
+Les widgets disponibles incluent<<:>>
+
+<<list-links "[tag[Widgets]]">>

package/editions/fr-FR/tiddlers/wikitext/parser/Block Mode WikiText (Examples).tid

@@ -0,0 +1,52 @@
+created: 20220115152811251
+fr-title: WikiTexte en mode bloc (exemples)
+modified: 20220422215120630
+tags: [[Block Mode WikiText]]
+title: Block Mode WikiText (Examples)
+type: text/vnd.tiddlywiki
+
+Les [[paragraphes|Paragraphs in WikiText]] sont la forme la plus courante de <<fr WikiText>>. Il est important de comprendre qu'ils ne se terminent pas avant d'avoir rencontré une ligne vide. Dès qu'un paragraphe commence, l'interpréteur passe en ''mode en ligne''. Jusqu'à ce que cette ligne vide soit rencontrée, les syntaxes de <<fr WikiText>> en ''mode bloc'' sont ignorées<<:>>
+
+<<<
+<<wikitext-example-without-html src:'Voici un paragraphe.
+Seule la syntaxe du __//mode en ligne//__ est reconnue ici.
+La syntaxe du mode bloc est <b>ignorée</b> entre le début
+et la fin du paragraphe (c-à-d la prochaine ligne vide).
+Par exemple :
+* Les listes sont ignorées
+* Tout comme cette ligne horizontale<<:>>
+---
+|les tableaux|sont|ignorés|
+! les titres sont ignorés
+<<<
+les citations multi-lignes sont ignorées
+<<<
+'>>
+<<<
+
+Pour que le <<fr WikiText>> en mode bloc soit reconnu, il faut insérer une ligne vide après la ligne <<gf "Par exemple :">>. La ligne vide constituera une fin de paragraphe, et l'interpréteur commencera à reconnaître la syntaxe du mode bloc à nouveau. Comme ceci<<:>>
+
+<<<
+<<wikitext-example-without-html src:'Voici un paragraphe.
+Seule la syntaxe du __//mode en ligne//__ est reconnue ici.
+La syntaxe de mode bloc est <b>ignorée</b> entre le début
+et la fin du paragraphe (c-à-d la prochaine ligne vide).
+Par exemple, voici une ligne vide :
+
+* grâce à la ligne vide ci-dessus,
+* les listes fonctionnent
+* Tout comme cette ligne horizontale<<:>>
+---
+|!les tableaux|!fonctionnent|
+|cellule 1| cellule 2|
+! les titres fonctionnent
+<<<
+les citations multi-lignes fonctionnent
+<<<
+; Terme
+: Définition de ce terme
+Un autre paragraphe peut commencer ici, mais il ne finira pas avant une ligne vide.
+'>>
+<<<
+
+À part le paragraphe, tous les exemples de <<fr WikiText>> en mode bloc ci-dessus sont écrits une ligne après l'autre sans ligne vide intermédiaire. Ces types de <<fr WikiText>> n'ont pas besoin de ligne vide pour en marquer la fin.

package/editions/fr-FR/tiddlers/wikitext/parser/Block Mode WikiText.tid

@@ -0,0 +1,37 @@
+caption: analyse en mode bloc
+created: 20220110234234616
+fr-title: WikiTexte en mode bloc
+modified: 20220422210106782
+tags: [[WikiText Parser Modes]]
+title: Block Mode WikiText
+type: text/vnd.tiddlywiki
+
+Une partie du <<fr WikiText>> n'est reconnue que quand l'interpréteur est en mode <<gf "bloc">>.
+
+Caractéristiques communes de ce <<fr WikiText>> en mode bloc<<:>>
+
+* Il occupe au moins une ligne entière.
+* Le marqueur de fermeture doit être situé en fin de ligne (dans certains cas la fin de ligne <<.em est>> le marqueur de fermeture)
+
+|!~WikiTexte|!Marqueurs|
+|<<fr "Block Quotes in WikiText">> |Les citations multi-lignes sont encadrées par le texte `<<<` tout seul sur sa ligne<<;>> les citations mono-ligne sont aussi possibles.|
+|<<fr "Code Blocks in WikiText">>|Les blocs de code sont encadrés par le texte <code>&#96;&#96;&#96;</code> tout seul sur sa ligne.|
+|<<fr "Definitions in WikiText">>|Chaque terme est sur sa propre ligne, et chaque définition est sur sa propre ligne.|
+|<<fr "Hard Linebreaks in WikiText">>|Encadrées par le texte `"""` tout seul sur sa ligne.|
+|<<fr "Headings in WikiText">>|Lignes complètes commençant par `!`.|
+|<<fr "Horizontal Rules in WikiText">>|Une ligne ne contenant que le texte `---`.|
+|<<fr "Lists in WikiText">>|Chaque élément de liste est sur sa propre ligne.|
+|<<fr "Paragraphs in WikiText">>|Tout autre texte que le marqueur de début d'une des autres expressions <<fr WikiText>> en mode bloc constitue le début d'un paragraphe. Même un marqueur de début d'expression <<fr WikiText>> en mode en ligne constitue le début d'un paragraphe. L’interpréteur inclut toutes les lignes suivantes dans le paragraphe jusqu'à rencontrer une ligne vide.|
+|<<fr "Styles and Classes in WikiText">>|Encadrés par des lignes commençant par `@@`.|
+|<<fr "Tables in WikiText">>|Chaque ligne du tableau est une ligne de texte qui commence et se termine par `|`.|
+|<<fr "Typed Blocks in WikiText">>|Encadrés par des lignes commençant par `$$`.|
+
+Les expressions <<fr WikiText>> ci-dessus ne sont reconnues qu'en ''mode bloc''. Par contre, le texte <<.em contenu>> à l'intérieur sera interprété en ''mode en ligne'' (les <<fr "Block Quotes in WikiText">> et les <<fr "Styles and Classes in WikiText">> sont les deux expressions pour lesquelles l'interpréteur poursuit l'analyse en ''mode bloc''). L'analyse en ''mode en ligne'' peut amener l'interpréteur à rencontrer un contenu qui le fait [[basculer en mode bloc|WikiText parser mode transitions]].
+
+À la fin de la dernière ligne du bloc, l'interpréteur retourne en ''mode bloc''.
+
+<<.tip 'Note: Les [[fins de ligne forcées|Hard Linebreaks in WikiText]] nécessitent une ligne vide supplémentaire après le `"""` final pour que l&apos;interpréteur retourne en <b>mode bloc</b>.'>>
+
+Si le marqueur de début d'une des expressions de bloc ci-dessus est rencontré alors que l'interpréteur est en ''mode en ligne'', il sera //ignoré// et apparaîtra tel quel dans le résultat.
+
+[[Exemples|Block Mode WikiText (Examples)]]

package/editions/fr-FR/tiddlers/wikitext/parser/Inline Mode WikiText.tid

@@ -0,0 +1,28 @@
+caption: mode d'analyse en ligne
+created: 20220111000108618
+fr-title: WikiTexte en mode « en ligne »
+modified: 20220421231003677
+tags: [[WikiText Parser Modes]]
+title: Inline Mode WikiText
+type: text/vnd.tiddlywiki
+
+Une partie du <<fr WikiText>> n'est reconnue que quand l'interpréteur est en mode <<gf "en ligne">>.
+
+Ces expressions en <<fr WikiText>> n'ont pas besoin d'occuper toute une ligne de texte. Elles n'ont pas besoin non plus de tenir en entier sur une seule ligne, mais <<.em peuvent>> couvrir une ligne complète. De ce fait, plusieurs de ces expressions peuvent apparaître au sein de la même ligne. En d'autres termes, les fins de lignes ne sont pas prises en compte quand l'interpréteur cherche à trouver le début et la fin de ces expressions <<fr WikiText>>. Quand l'interpréteur est en mode <<gf "en ligne">>, il reconnaît les syntaxes des expressions <<fr WikiText>> suivantes<<:>>
+
+* <<fr "Dashes in WikiText">>
+* <<fr "Formatting in WikiText">>
+* <<fr "HTML in WikiText">>
+* <<fr "Images in WikiText">>
+* <<fr "Linking in WikiText">>
+* <<fr "Macro Calls in WikiText">>
+* <<fr "Styles and Classes in WikiText">> (version mono-ligne seulement)
+* <<fr "Transclusion in WikiText">>
+* <<fr "Variables in WikiText">>
+* <<fr "Widgets in WikiText">>
+
+<<.tip """Un [[appel de macro|Macro Calls in WikiText]] ou une  [[transclusion en WikiTexte|Transclusion in WikiText]] sont reconnus en ''mode bloc'' si l'appel de macro ou la transclusion occupent une ligne complète.""">>
+
+<<.tip """Techniquement, les autres expressions <<fr WikiText>> en ''mode en ligne'' ne sont reconnues <<.em que>> quand l'interpréteur est en ''mode en ligne''. Toutefois, leurs balises d'ouverture vont déclencher le début d'un [[paragraphe|Paragraphs in WikiText]], ce qui va automatiquement faire basculer l'interpréteur en ''mode en ligne''. De ce fait, en pratique il est aussi simple de considérer que ces expressions sont reconnues par l'interpréteur aussi bien en ''mode bloc'' qu'en ''mode en ligne''.""">>
+
+Pendant le traitement du texte //inclus// dans certaines de ces expressions <<fr WikiText>>, l'interpréteur [[ignorera les syntaxes WikiTexte|Places where the parser ignores WikiText]]. Mais pour le reste de ces expressions <<fr WikiText>>, l'interpréteur continuera l'analyse en ''mode en ligne'' du texte //inclus//, ce qui peut l'amener à rencontrer un contenu qui le fait [[basculer en mode bloc|WikiText parser mode transitions]].

package/editions/fr-FR/tiddlers/wikitext/parser/Places where the parser ignores WikiText.tid

@@ -0,0 +1,14 @@
+caption: mode d'analyse ignoré
+created: 20220111000929700
+fr-title: Endroits où le WikiTexte est ignoré
+modified: 20220421200127071
+tags: [[WikiText Parser Modes]]
+title: Places where the parser ignores WikiText
+type: text/vnd.tiddlywiki
+
+Le texte contenu dans les constructions suivantes est survolé par l'interpréteur sans analyse du <<fr WikiText>><<:>>
+
+|<<fr "Code Blocks in WikiText">>|L'une des fonctions principales des blocs de code est de supprimer l'analyse du <<fr WikiText>>. Dès que le bloc de code commence l'interpréteur arrête l'analyse du <<fr WikiText>> jusqu'à la fin du bloc.|
+|<<fr "Images in WikiText">>|`[[img|texte littéral de lien image]]` - le texte inclus entre crochets est ignoré, ce qui signifie par exemple que ni les [[transclusions|Transclusion in WikiText]] ni les [[appels de macros|Macro Calls in WikiText]] ne peuvent être utilisés pour construire le lien dynamiquement.|
+|<<fr "Linking in WikiText">>|`[[cible littérale du lien|intitulé littéral du lien]]` - le texte inclus entre crochets est ignoré, ce qui signifie par exemple que ni les [[transclusions|Transclusion in WikiText]] ni les [[appels de macros|Macro Calls in WikiText]] ne peuvent être utilisés pour construire la cible ou l'intitulé du lien dynamiquement.|
+|<<fr "Macro Calls in WikiText">>|`<<maMacro ''pas-en-gras'' "texte littéral" "<<expansion-de-macro-ignorée>>" {{transclusion-ignorée}}>>` - pour traiter le texte inclus dans un appel de macro, l'interpréteur suit des règles particulières de détection des arguments de macros. Ces règles ne permettent pas d'analyser le <<fr WikiText>>, mais après la substitution des arguments dans la définition de la macro, le résultat est analysé à l'aide des [[règles normales|WikiText Parser Modes]]. Le <<fr WikiText>> sera donc interprété ultérieurement dans le résultat.|

package/editions/fr-FR/tiddlers/wikitext/parser/WikiText Parser Modes.tid

@@ -0,0 +1,17 @@
+created: 20220110233944530
+fr-title: Modes d'analyse du WikiTexte
+modified: 20220419233657896
+tags: WikiText
+title: WikiText Parser Modes
+type: text/vnd.tiddlywiki
+
+Pour afficher les tiddlers (généralement le champ <<.field text>>), l'interpréteur de <<fr WikiText>> lit et analyse le contenu, et applique les règles de conversion du <<fr WikiText>>. L'interpréteur a trois modes d'analyse<<:>>
+
+* Le ''mode pragma'' - l'analyseur ne reconnaît que la syntaxe [[WikiTexte du mode pragma|Pragma]]
+* Le ''mode bloc'' - l'analyseur ne reconnaît que la syntaxe [[WikiTexte du mode bloc|Block Mode WikiText]]
+* Le ''mode en ligne'' - l'analyseur ne reconnaît que la syntaxe [[WikiTexte du mode en ligne|Inline Mode WikiText]]
+
+L'interpréteur [[bascule entre ces modes d'analyse|WikiText parser mode transitions]] selon le texte qu'il rencontre. De plus, il existe des [[emplacements où le WikiTexte est ignoré|Places where the parser ignores WikiText]].
+
+<<.tip """Le concept de modes <<gf bloc>> et <<gf "en ligne">> existe aussi pour les éléments HTML standards. En HTML, ces [[deux modes de mise en page|https://www.w3schools.com/html/html_blocks.asp]] ,,(en anglais),, déterminent si le résultat est disposé sur une même ligne ou pas.
+<p>La majorité du <<fr "Block Mode WikiText">> correspond aux [[éléments de bloc HTML|https://developer.mozilla.org/fr-FR/docs/Web/HTML/Block-level_elements]], et la majorité du <<fr "Inline Mode WikiText">> correspond aux [[éléments en ligne HTML|https://developer.mozilla.org/fr-FR/docs/Web/HTML/Inline_elements]]. Néanmoins, en ~WikiTexte les deux modes sont aussi importants pour déterminer la syntaxe utilisable que pour déterminer la présentation du résultat.</p>""">>

package/editions/fr-FR/tiddlers/wikitext/parser/WikiText parser mode HTML examples.tid

@@ -0,0 +1,73 @@
+created: 20220122153235162
+fr-title: Modes d'analyse du WikiTexte : exemples de HTML
+modified: 20220422205843467
+tags: [[WikiText parser mode transitions]]
+title: WikiText parser mode: HTML examples
+type: text/vnd.tiddlywiki
+
+<<wikitext-example-without-html "<div>
+
+* La ligne vide après la balise ouvrante permet
+* aux marqueurs de mode bloc (comme cette liste)
+* d'être reconnus
+</div>
+">>
+
+---
+
+L'astuce de la ligne vide fonctionne aussi au sein des syntaxes reconnues seulement en mode en ligne (comme <<fr "Formatting in WikiText">>)<<:>>
+
+<<wikitext-example-without-html "''<div>
+
+* premier élément de la liste
+* deuxième élément de la liste
+</div>''">>
+
+---
+
+<<wikitext-example-without-html "<div>
+* Une balise ouvrante non suivie d'une ligne vide
+* signifie que la syntaxe en mode bloc (cette liste)
+* ne sera PAS reconnue.
+
+Les paragraphes ne sont reconnus qu'en mode bloc. Même avec des lignes vides, aucun nouveau paragraphe n'est reconnu.
+
+Ceci n'est pas un nouveau paragraphe non plus.
+</div>">>
+
+---
+
+Les <<fr "Tables in WikiText">> sont des éléments pour lesquels l'astuce de la ligne vide ne fonctionne pas. Pour que l'interpréteur reconnaisse une ligne de tableau, elle doit remplir exactement une ligne de texte.
+
+Ajouter une ligne blanche après une balise ouvrante au sein d'une cellule de tableau répartit la ligne de tableau sur plusieurs lignes de texte, et l'interpréteur ne peut plus reconnaître ce texte en tant que ligne de tableau.
+
+<<wikitext-example-without-html "|la ligne de tableau|entièrement sur|une ligne de texte|est reconnue|">>
+
+<<wikitext-example-without-html "|Avec une ligne vide après une balise ouvrante|<div>
+
+* la liste est reconnue
+* mais pas le tableau autour
+</div>|">>
+
+---
+
+Le seul moyen de faire reconnaître la syntaxe de [[mode bloc|Block Mode WikiText]] dans des [[tableaux en WikiTexte|Tables in WikiText]] est d'utiliser un widget <<.wlink TranscludeWidget>> avec l'attribut <<.attr mode>>=<<.value block>>.
+
+<<wikitext-example-without-html '|Tableau imbriqué<<:>>|<$transclude tiddler="table-example" mode=block/>|'>>
+
+Notez que le widget <<.wlink MacroCallWidget>> ne dispose pas d'un attribut <<.attr mode>> similaire, et le contenu des définitions de macros ne peut être analysé qu'en [[mode en ligne|Inline Mode WikiText]].
+
+---
+
+Bien que moins pratiques, les balises html `<table>`, `<tr>`, `<td>` peuvent être utilisées comme un moyen sûr de faire reconnaître les syntaxes en [[mode bloc|Block Mode WikiText]] à l'intérieur d'un tableau.
+
+<<wikitext-example-without-html "<table>
+<tr><td>
+
+* premier élément de la liste
+* deuxième élément de la liste
+</td><td>
+
+|tableau|imbriqué|
+</td></tr>
+</table>">>

package/editions/fr-FR/tiddlers/wikitext/parser/WikiText parser mode transitions.tid

@@ -0,0 +1,59 @@
+created: 20220110235808139
+fr-title: Changements de mode d'analyse du WikiTexte
+modified: 20220421003504381
+tags: [[WikiText Parser Modes]]
+title: WikiText parser mode transitions
+type: text/vnd.tiddlywiki
+
+Voici un diagramme <<.em approximatif>> dont les lignes correspondent globalement aux transitions entre modes d'analyse de l'interpréteur décrites ci-dessous<<:>>
+<$railroad text="""
+{<"mode pragma" >
+{(
+  {<"mode en ligne"> +} |
+  ({<"mode bloc">
+    +("<<<" | "@@" | "$$")
+  }
+  "autre syntaxe de début de bloc")
+  {<"mode en ligne"> +}
+  )
+  +(
+    "syntaxe de fin de bloc" |
+    ("ligne vide" "balise ouvrante html")
+  )}
+  +("widget transclude" | "appel de macro")
+}
+"""/>
+
+!! Mode de démarrage
+
+Par défaut, l'interpréteur démarre en [[mode bloc|Block Mode WikiText]]. Néanmoins, un tiddler peut être transclus en [[mode en ligne|Inline Mode WikiText]] auquel cas le [[WikiTexte du mode bloc|Block Mode WikiText]] ne sera pas reconnu.
+
+Au début du texte seulement, l'interpréteur reconnaît aussi le [[WikiTexte du mode pragma|Pragma]].
+
+!! Transitions depuis le mode pragma
+
+Au début du texte, l'interpréteur cherche des [[pragmas|Pragma]]. S'il n'en trouve aucun il bascule en [[mode en ligne|Inline Mode WikiText]] ou en [[mode bloc|Block Mode WikiText]], en fonction du mode de transclusion. S'il a trouvé un [[pragma|Pragma]], il continue à en chercher d'autres jusqu'à ce qu'il rencontre une ligne vide non suivie par le début d'un nouveau pragma.
+
+!! Transitions depuis le mode bloc
+
+Quand l'interpréteur rencontre la plupart des syntaxes de début de [[mode bloc|Block Mode WikiText]], il bascule en [[mode en ligne|Inline Mode WikiText]], ce qui signifie que le texte compris entre des balises de début et de fin de [[bloc|Block Mode WikiText]] sera interprété en [[mode en ligne|Inline Mode WikiText]].
+
+<<.tip """La <<gf balise>> de début de paragraphe est <<gf invisible>>. Même au sein des paragraphes l'interpréteur bascule en [[mode en ligne|Inline Mode WikiText]].""">>
+
+Il y a toutefois quelques balises de blocs dont le contenu est interprété en [[mode bloc|Block Mode WikiText]]<<:>>
+
+* Les [[citations multi-lignes|Block Quotes in WikiText]]
+* Les [[styles multi-lignes|Styles and Classes in WikiText]]
+* Les [[blocs typés|Typed Blocks in WikiText]]
+
+Pour ces cas particuliers, lorsque la syntaxe de début de bloc est rencontrée, l'interpréteur continue à analyser le texte en [[mode bloc|Block Mode WikiText]].
+
+Les [[lignes horizontales|Horizontal Rules in WikiText]] sont un autre cas particulier<<:>> elles n'incluent pas de texte, donc l'interpréteur n'a pas l'opportunité de basculer en [[mode en ligne|Inline Mode WikiText]].
+
+Les balises d'ouverture de [[widgets|Widgets in WikiText]] ou de [[HTML|HTML in WikiText]] peuvent conduire l'interpréteur à changer de mode. Quand une de ces balises <<.em "n'est pas">> suivie d'une ligne vide, le texte compris entre les balises sera interprété en [[mode en ligne|Inline Mode WikiText]]. Voir les [[exemples HTML|WikiText parser mode: HTML examples]].
+
+!! Transitions depuis le mode en ligne
+
+* L'interpréteur retourne en [[mode bloc|Block Mode WikiText]] après la fin d'une ligne qui termine du [[WikiTexte de mode bloc|Block Mode WikiText]]. En d'autres termes, quand la balise de fin de bloc est rencontrée.
+* Quand une balise d'ouverture de [[widget|Widgets in WikiText]] ou de [[HTML|HTML in WikiText]] est suivie d'une ligne vide, le contenu est analysé en [[mode bloc|Block Mode WikiText]]. Voir les [[exemples HTML|WikiText parser mode: HTML examples]].
+* Le texte transclus et le texte substitué via un appel de macro peuvent faire quitter le [[mode en ligne|Inline Mode WikiText]] à l'interpréteur. Voir les [[exemples de transclusions|WikiText parser mode: transclusion examples]] et les  [[exemples de macros|WikiText parser mode: macro examples]] pour plus de détails.

package/editions/fr-FR/tiddlers/wikitext/parser/WikiText parser mode_ macro examples.tid

@@ -0,0 +1,56 @@
+created: 20220122144742419
+fr-title: Modes d'analyse du WikiTexte : exemples de macros
+modified: 20220419224009995
+tags: [[WikiText parser mode transitions]]
+title: WikiText parser mode: macro examples
+type: text/vnd.tiddlywiki
+
+\define tablebanale()
+|cellule une|cellule deux|
+|cellule trois|cellule quatre|
+\end
+En utilisant la macro `tablebanale` définie ainsi<<:>>
+<$codeblock code=<<tablebanale>>/>
+dans une transclusion, alors<<:>>
+<table><<wikitext-example-table-header>><tbody>
+<<wikitext-example-table-row 1 "* <<tablebanale>>">>
+<<wikitext-example-table-row 2 """* <div>
+
+<<tablebanale>>
+</div>
+""">>
+<<wikitext-example-table-row 3 "* <$macrocall $name=tablebanale/>">>
+<<wikitext-example-table-row 4 "* <$macrocall $name=tablebanale></$macrocall>">>
+<<wikitext-example-table-row 5 """* <$macrocall $name=tablebanale>
+
+</$macrocall>""">>
+</tbody></table>
+
+Dans le code ci-dessus, la syntaxe de liste à puce est reconnue en [[mode bloc|Block Mode WikiText]], puis son contenu est interprété en [[mode en ligne|Inline Mode WikiText]]. Quand l'interpréteur rencontre un [[appel de macro en WikiTexte|Macro Calls in WikiText]] il utilise le mode courant pour analyser le contenu de la macro. La macro d'exemple contient une définition de table qui n'est reconnue qu'en [[mode bloc|Block Mode WikiText]].
+
+De ce fait, dans la ligne n°1 ci-dessus, la syntaxe de table n'est pas reconnue. Dans la ligne n°2, la ligne vide après la balise `<div>` bascule l'interpréteur en [[mode bloc|Block Mode WikiText]] et le contenu de la macro en hérite, donc la table est reconnue.
+
+En utilisant le <<fr MacroCallWidget>>, le mode d'analyse reste le mode en ligne (exemples des lignes n°3 et 4 ci-dessus) jusqu'à ce que la balise ouvrante soit suivie d'une ligne vide (exemple n°5 ci-dessus).
+
+<<.tip """Voir aussi <<fr "WikiText parser mode: transclusion examples">> pour d'autres exemples similaires.""">>
+
+---
+
+Dans les exemples suivants, les appels de macros sont directs, au lieu d'être inclus dans des listes à puces<<:>>
+<table><<wikitext-example-table-header>><tbody>
+<<wikitext-example-table-row 1 "<<tablebanale>>">>
+<<wikitext-example-table-row 2 """<div>
+
+<<tablebanale>>
+</div>
+""">>
+<<wikitext-example-table-row 3 "<$macrocall $name=tablebanale/>">>
+<<wikitext-example-table-row 4 "<$macrocall $name=tablebanale></$macrocall>">>
+<<wikitext-example-table-row 5 """<$macrocall $name=tablebanale>
+
+</$macrocall>""">>
+</tbody></table>
+
+Parmi ces exemples, seuls les deux widgets <<.wlink MacroCallWidget>> dont la balise d'ouverture n'est pas suivie d'une ligne vide (lignes n°3 et 4) sont analysés en [[mode en ligne|Inline Mode WikiText]].
+
+<<.tip """Voir aussi <<fr "WikiText parser mode: transclusion examples">> pour d'autres exemples similaires.""">>