Merge branch 'tiddlywiki-com'
This commit is contained in:
jeremy@jermolene.com
commit
1a377a485b
|
|
@ -1,15 +0,0 @@
|
|||
caption: {{$:/language/SideBar/Open/Caption}}
|
||||
created: 20141119223515194
|
||||
modified: 20141127160706002
|
||||
tags: $:/tags/SideBar
|
||||
title: $:/core/ui/SideBar/Open
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
\define lingo-base() $:/language/CloseAll/
|
||||
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
|
||||
|
||||
<$button message="tm-close-tiddler" tooltip={{$:/language/Buttons/Close/Hint}} aria-label={{$:/language/Buttons/Close/Caption}} class="tc-btn-invisible tc-btn-mini">×</$button> <$link to={{!!title}}><$transclude field="fr-title"><$view field="title"/></$transclude></$link>
|
||||
|
||||
</$list>
|
||||
|
||||
<$button message="tm-close-all-tiddlers" class="tc-btn-invisible tc-btn-mini"><<lingo Button>></$button>
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
caption: Ligne horizontale
|
||||
created: 20141017091105859
|
||||
modified: 20141116092622611
|
||||
tags: WikiText
|
||||
title: Horizontal Rules in WikiText
|
||||
fr-title: Lignes horizontales en WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Une ligne horizontale se crée avec trois caractères "moins" ou plus `---`, seuls sur une ligne :
|
||||
|
||||
<<wikitexte-exemple "Paragraphe précédent.
|
||||
|
||||
---
|
||||
Paragraphe suivant.">>
|
||||
|
||||
; Remarque
|
||||
* La ligne vide avant la ligne horizontale est nécessaire pour que cette dernière soit interprétée correctement, et non comme un [[tiret|Dashes in WikiText]].
|
||||
|
|
@ -1,22 +0,0 @@
|
|||
caption: Appel de Macro
|
||||
created: 20150220182252000
|
||||
fr-title: L'appel des macros dans WikiTexte
|
||||
modified: 20150621151328844
|
||||
title: Macro Calls in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Pour appeler une [[macro|Macros]], placez des `<<`parenthèses en double équerres`>>` autour de son nom et des valeurs de ses paramètres. ex<<:>> `<<macro val1 val2 ... valn>>`
|
||||
|
||||
Par défaut, les paramètres sont passés dans l'ordre fixé lors de la définition de la macro. Un paramètre peut être identifié par son nom, pour plus de clarté ou pour pouvoir en modifier l'ordre.
|
||||
|
||||
Si aucune valeur n'est passée en paramètre, la valeur fixée lors de la définition de la macro est assignée. (Si aucune valeur n'est définie par défaut, le paramètre est tout simplement vide.)
|
||||
|
||||
Chaque valeur de paramètre peut être passée par des `'cotes unique'`, des `"double cotes"`, des `"""double cotes triplés"""` ou des `[[doubles crochets]]`. Les double cotes triplés permettent de passer à peu près toutes les valeurs. Si une valeur ne contient ni espace, ni simple ou double cotes, les délimiteurs sont inutiles.
|
||||
|
||||
Une description [[description|Macro Call Syntax]] plus formelle de cette syntaxe est aussi disponible.
|
||||
|
||||
La syntaxe courante est une forme abrégée du widget <<.wlink MacroCallWidget>>. Ce widget permet, par lui-même, une plus grande flexibilité, incluant la capacité de [[transclure|Transclusion]] des valeurs en paramètres ou de les générer via des macros additionnelles .
|
||||
|
||||
Comme les macros sont de simples [[variables|Variables]] paramétrées, des valeurs de variables peuvent être intègrées en faisant appel aux mêmes techniques.
|
||||
|
||||
[[Exemples|Macro Calls in WikiText (Examples)]]
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
caption: Pragma
|
||||
created: 20150219175930000
|
||||
modified: 20150622113059920
|
||||
tags: Concepts
|
||||
title: Pragma
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Un <<.def pragma>> est un composant spécial de WikiText qui permet de contrôler la façon dont la suite du texte est analysée.
|
||||
|
||||
Les Pragmas occupent les lignes débutants par `\`. Ils peuvent juste prendre place au début d'un texte, mais des lignes vides sont permises entre eux. Si un pragma apparait dans le corps principal d'un texte, il est considéré comme du texte ordinaire.
|
||||
|
||||
Les pragmas suivants sont disponibles<<:>>
|
||||
|
||||
;`\define`
|
||||
: définit une [[macro|Macros]]
|
||||
;`\rules`
|
||||
: permet d'ajuster l'ensemble des règles d'analyse d'un texte
|
||||
|
|
@ -1,102 +0,0 @@
|
|||
caption: Tableaux
|
||||
created: 20130914132100000
|
||||
fr-title: Tableaux avec WikiText
|
||||
modified: 20150601094401171
|
||||
tags: WikiText
|
||||
title: Tables in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! Concepts de base
|
||||
|
||||
TiddlyWiki5 forme les tableaux au moyen du signe barre verticale `|`, de cette façon :
|
||||
|
||||
```
|
||||
|!Cell1 |!Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
```
|
||||
|
||||
Le point d'exclamation marque l'entête des cellules:
|
||||
|
||||
|!Cell1 |!Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
|
||||
! L'alignement horizontal
|
||||
|
||||
L’alignement horizontal des cellules du tableau est contrôlé par l'insertion d'un espace avant/après le contenu de la cellule. Par exemple:
|
||||
|
||||
```
|
||||
|Contenu aligné à gauche |
|
||||
| Contenu aligné à droite|
|
||||
| Contenu centré |
|
||||
|+++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++|
|
||||
```
|
||||
|
||||
Cet exemple donne ceci :
|
||||
|
||||
|Contenu aligné à gauche |
|
||||
| Contenu aligné à droite|
|
||||
| Contenu centré |
|
||||
|+++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++|
|
||||
|
||||
! L'alignement vertical
|
||||
|
||||
L’alignement vertical des cellules du tableau est contrôlé par l'insertion, comme premier caractère de la cellule, soit d'un `^` pour un alignement en haut ou un `,` pour un alignement en bas. La combinaison avec l'alignement horizontal reste valable.
|
||||
|
||||
Exemple :
|
||||
|
||||
```
|
||||
|^haut gauche |^ haut centré |^ haut droit|
|
||||
|milieu gauche | milieu centré | milieu droit|
|
||||
|,bas gauche |, bas centré |, bas droit|
|
||||
```
|
||||
|
||||
Ce qui affiche :
|
||||
|
||||
| ::<br>:: |^haut gauche |^ haut centre |^ haut droit|
|
||||
| ::<br>::<br>:: |milieu gauche | milieu centre | milieu droit|
|
||||
| ::<br>::|,bas gauche |, bas centré |, bas droit|
|
||||
|
||||
Si vous voulez afficher un `^`or a `,` comme premier caractère d'une cellule alignée à gauche, vous ferez appel au html-escaping/ échappement-html. Voir, à ce sujet [[la Mise en forme avec WikiText|Formatting in WikiText]].
|
||||
|
||||
| `^` | &#94; |
|
||||
| `,` | &#44; |
|
||||
|
||||
! La fusion des cellules
|
||||
|
||||
Pour fusionner le contenu de la cellule située au dessus utiliser `~`. Pour fusionner avec celle de gauche `<` et `>` pour celle de droite. Par exemple:
|
||||
|
||||
```
|
||||
|Cell1 |Cell2 |Cell3 |Cell4 |
|
||||
|Cell5 |Cell6 |Cell7 |<|
|
||||
|Cell5 |~|Cell7 |Cell8 |
|
||||
|>|Cell9 |Cell10 |Cell11 |
|
||||
```
|
||||
|
||||
affiche:
|
||||
|
||||
|Cell1 |Cell2 |Cell3 |Cell4 |
|
||||
|Cell5 |Cell6 |Cell7 |<|
|
||||
|Cell5 |~|Cell7 |Cell8 |
|
||||
|>|Cell9 |Cell10 |Cell11 |
|
||||
|
||||
! Classes de tableau, légendes, en-têtes et pieds de tableau
|
||||
|
||||
Des classes CSS, des légendes, des en-têtes et pieds de tableau peuvent être spécifiés comme pseudo-lignes spéciales :
|
||||
|
||||
```
|
||||
|maclasse autreClass|k
|
||||
|Ceci est une légende |c
|
||||
|Cell1 |Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
|Entête|Entête|h
|
||||
|Pied|Pied|f
|
||||
```
|
||||
|
||||
affiche :
|
||||
|
||||
|maclasse autreClass|k
|
||||
|Ceci est une légende |c
|
||||
|Cell1 |Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
|Entête|Entête|h
|
||||
|Pied|Pied|f
|
||||
|
|
@ -1,73 +0,0 @@
|
|||
caption: transclude
|
||||
created: 20130824142500000
|
||||
modified: 20150622210004977
|
||||
tags: Widgets
|
||||
title: TranscludeWidget
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! Introduction
|
||||
|
||||
Le TranscludeWidget importe dynamiquement le contenu d'un autre tiddler.
|
||||
|
||||
! Attributs
|
||||
|
||||
|!Attribut |!Description |
|
||||
|tiddler |Le titre du tiddler à transclure (par défaut le tiddler courant) |
|
||||
|field |Le nom du champ du tiddler courant (par défaut "text"<<;>> si présent, a priorité sur l'attribut index) |
|
||||
|index |L'index d'une propriété d'un [[Data Tiddler|DataTiddlers]] |
|
||||
|subtiddler |Titre optionnel d'un SubTiddler quand le tiddler cible est un [[plugin|Plugins]] (voir infra) |
|
||||
|mode |change le mode d'analyse par défaut du texte transclu à "block" ou à "inline" |
|
||||
|
||||
Le TranscludeWidget traite tout contenu avec les solutions par défaut si la cible de transclusion n'est pas complètement définie (ex<<:>> un tiddler ou un champ manquant)
|
||||
|
||||
! Modes d'analyse
|
||||
|
||||
TiddlyWiki analyse le texte par deux modes<<:>>
|
||||
|
||||
* le mode ''inline'' reconnaît les formats de caractères comme l'emphase, les liens
|
||||
* le mode ''bloc'' reconnaît tous les formats ''inline'', et le complète des formats bloc comme les tableaux, les listes et les rubriques
|
||||
|
||||
Habituellement, le mode, bloc ou en ligne, est déterminé automatiquement par le widget transclude lui-même au moment de l'analyse. Ceci peut être ajusté par l'attribut `mode`.
|
||||
|
||||
Par exemple, considérons un tiddler "A" avec ce contenu<<:>>
|
||||
|
||||
```
|
||||
|
||||
# Article un
|
||||
#<$transclude tiddler="B"/>
|
||||
# Article deux
|
||||
```
|
||||
|
||||
Et un tiddler "B" avec ce contenu<<:>>
|
||||
|
||||
```
|
||||
|
||||
# Article un - a
|
||||
# Article un - b
|
||||
```
|
||||
|
||||
Le résultat donnera quelque chose comme<<:>>
|
||||
|
||||
# Article un
|
||||
# # Article un - a # Article un - b
|
||||
# Article deux
|
||||
|
||||
Cela peut être corrigé en modifiant le tiddler "A"<<:>>
|
||||
|
||||
```
|
||||
|
||||
# Article un
|
||||
#<$transclude tiddler="B" mode="block"/>
|
||||
# Article deux
|
||||
```
|
||||
|
||||
! Accès au SubTiddler
|
||||
|
||||
Le transclude widget permet l'accès aux tiddlers individuels mémorisés dans un [[plugin|Plugins]].
|
||||
|
||||
L'exemple suivant transclura la version initiale d'un tiddler noyau [[$:/DefaultTiddlers]] même si il a été modifié<<:>>
|
||||
|
||||
<<wikitext-example-without-html '
|
||||
<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
|
||||
|
||||
'>>
|
||||
|
|
@ -1,30 +0,0 @@
|
|||
caption: Widgets
|
||||
created: 20131205160840915
|
||||
fr-title: Widgets de WikiText
|
||||
modified: 20150622081957197
|
||||
tags: WikiText
|
||||
title: Widgets in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Les widgets enrichissent les fonctionnalités du 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<<dp>>
|
||||
|
||||
```
|
||||
<$button message="tm-close-tiddler">Fermez Moi !</$button>
|
||||
```
|
||||
|
||||
Notez que les widgets héritent de toutes les caractéristiques du [[HTML dans WikiText|HTML in WikiText]]:
|
||||
|
||||
* Les attributs des Widgets peuvent être spécifiés via<<:>>
|
||||
** Des chaines non-cotées (sans aucun espace)
|
||||
** Des chaines cotées par simple ou double cotes
|
||||
** Des chaines cotées par des doubles cotés triplées
|
||||
** Des invocations de Macro (eg `attr=<<maMacro>>`)
|
||||
** Des transclusions (eg, `attr={{MonTiddler!!champ}}`)
|
||||
* Le contenu d'un widget est analysé en mode en ligne jusqu'à ce que l'ouverture d'une balise soit suivie par deux sautsdeligne, ce qui force le mode bloc
|
||||
** Le 'mode Enligne' indique que les règles d'analyse en 'mode bloc' de rubriques, tables, listes, ... ne sont pas reconnues
|
||||
|
||||
Voir [[HTML dans WikiText|HTML in WikiText]] pour plus de détails.
|
||||
|
||||
Les widgets disponibles inclus<<:>>
|
||||
|
||||
<<list-links "[tag[Widgets]]">>
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
caption: Pragma
|
||||
created: 20150219175930000
|
||||
modified: 20220421233711464
|
||||
tags: Concepts [[WikiText Parser Modes]]
|
||||
title: Pragma
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Un <<.def pragma>> est un composant spécial du <<fr WikiText>> qui permet de contrôler la façon dont la suite du texte est analysée.
|
||||
|
||||
Les ''pragmas'' occupent des lignes débutant par un `\`. Ils ne peuvent être placés qu'au début d'un texte, mais des lignes vides sont autorisées entre eux. Si une ligne de pragma apparaît plus loin dans le corps du texte, il n'est pas pris en compte et apparaît comme du texte ordinaire.
|
||||
|
||||
''NDT''<<:>> <<.from-version "5.2.0">> Les commentaires HTML `<!-- texte de commentaire -->` sont aussi autorisés avant et entre les ''pragmas'', ce qui facilite la documentation du code <<fr WikiText>>.
|
||||
|
||||
Les ''pragmas'' suivants sont disponibles<<:>>
|
||||
|
||||
;`\define`
|
||||
: introduit une définition de [[macro|Macros]]
|
||||
;`\rules`
|
||||
: permet d'ajuster l'ensemble des règles d'analyse du texte
|
||||
;`\whitespace trim` ou `\whitespace notrim`
|
||||
: <<.from-version "5.1.15">> contrôle si les caractères d'espacement sont retirés du début et de la fin de morceaux de texte (la valeur par défaut ''notrim'' n'entraîne aucun retrait). Ce paramètre est utile lorsque l'indentation ou les caractères d'espacement générés par les retours à la ligne perturbent la mise en forme du résultat.
|
||||
;`\import <expression-de-filtre>`
|
||||
: <<.from-version "5.1.18">> permet d'importer des définitions de macros à partir des tiddlers sélectionnés par une expression de filtre.
|
||||
|
|
@ -1,15 +1,17 @@
|
|||
caption: WikiText
|
||||
created: 20141016134519861
|
||||
fr-title: WikiTexte
|
||||
modified: 20150622111631346
|
||||
modified: 20220422222111475
|
||||
tags: Concepts Reference
|
||||
title: WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Le ~WikiText est le langage de balisage de TiddlyWiki, qui permet d'écrire de manière concise et expressive une grande variété de formatages de texte, de liens hypertextes et de fonctionnalités interactives. Il permet de se concentrer sur l'écriture, sans l'interférence d'une interface complexe. Il est conçu pour être familier aux utilisateurs de [[Markdown]], tout en étant plus focalisé sur les liens et les fonctionnalités interactives.
|
||||
Le WikiTexte est le langage de balisage de TiddlyWiki, qui permet d'écrire de manière concise et expressive une grande variété de formatages de texte, de liens hypertextes et de fonctionnalités interactives. Il permet de se concentrer sur l'écriture, sans l'interférence d'une interface complexe. Il est conçu pour être familier aux utilisateurs de [[Markdown]], tout en étant plus focalisé sur les liens et les fonctionnalités interactives.
|
||||
|
||||
Voir [[Formater du texte dans TiddlyWiki|Formatting text in TiddlyWiki]] pour une introduction au ~WikiText.
|
||||
La <<fr "Editor toolbar">> permet d'insérer des balises de ~WikiTexte dans le texte du tiddler en cours d'édition.
|
||||
|
||||
Les syntaxes suivantes sont intégrées nativement dans ~TiddlyWiki :
|
||||
Voir <<fr "Formatting text in TiddlyWiki">> pour une introduction au ~WikiTexte.
|
||||
|
||||
Les syntaxes suivantes sont intégrées nativement dans <<tw>><<:>>
|
||||
|
||||
<<list-links "[tag[WikiText]]">>
|
||||
|
|
@ -1,23 +1,25 @@
|
|||
caption: Un mini-guide de TiddlyWiki
|
||||
created: 20150325170720682
|
||||
fr-title: Un mini-guide de TiddlyWiki
|
||||
modified: 20150531183440068
|
||||
modified: 20220417204641215
|
||||
tags: HelloThere
|
||||
title: A Gentle Guide to TiddlyWiki
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
<<tw>> est un outil incroyablement souple et polyvalent, conçu et mis au point d'une façon très différente que la plupart des logiciels. Cela peut paraître très difficile à comprendre jusqu'au moment où les premiers click le font devenir un extension directe de votre cerveau.
|
||||
<<tw>> est un outil incroyablement souple et polyvalent, conçu et mis au point d'une façon très différente de la plupart des logiciels. Cela peut paraître très difficile à comprendre, jusqu'à ce qu'en un claquement de doigts, il devienne une extension directe de votre cerveau.
|
||||
|
||||
Pour commencer par les bases, <<tw>> est une application web dédiée à la prise de notes, que vous pouvez obtenir gratuitement, stocker n'importe où, et personnaliser selon vos souhaits. Elle vous servira à conserver, organiser, et partager vos notes de manière inédite en comparaison des traitements de texte et autres outils habituels de prise de notes.
|
||||
|
||||
<<tw>> privilégie la non-linéarité : le contenu se structure à l'aide de déroulés, de tags, d'hyperliens, et d'autres fonctionnalités spécifiques. Vous pouvez organiser vos notes et y accéder selon votre manière de penser, sans vous sentir contraint par une structure d'organisation prédéfinie.
|
||||
<<tw>> privilégie la non-linéarité<<:>> le contenu se structure à l'aide de déroulés, de tags, d'hyperliens, et d'autres fonctionnalités spécifiques. Vous pouvez organiser vos notes et y accéder selon votre manière de penser, sans vous sentir contraint par une structure d'organisation prédéfinie.
|
||||
|
||||
Vous pouvez utiliser <<tw>> sous forme de fichier autonome, affichable et éditable depuis n'importe quel navigateur web, que vous soyez connecté ou déconnecté. Vous pouvez aussi vous en servir comme une [[application Node.js|TiddlyWiki on Node.js]], à même de synchroniser chacune de vos notes dans un fichier séparé.
|
||||
|
||||
Comment faire fonctionner <<tw>> chez vous ? Notre conseil est de commencer par lire les textes de présentation ci-dessous, puis de naviguer dans la [[table des matières|TableOfContents]] présente dans l'onglet //{{TableOfContents!!caption}}// de la barre latérale. Ou si vous préférez, contentez-vous de suivre [[nos instructions de démarrage|GettingStarted]] et jetez-vous à l'eau !
|
||||
Comment faire fonctionner <<tw>> chez vous ? Notre conseil est de commencer par lire les textes de présentation ci-dessous, puis de naviguer dans la <<fr TableOfContents>> présente dans l'onglet //{{TableOfContents!!caption}}// de la barre latérale. Ou si vous préférez, vous pouvez suivre [[nos instructions de démarrage|GettingStarted]] et vous jeter à l'eau !
|
||||
|
||||
<<list-links "[tag[HelloThere]]">>
|
||||
|
||||
Voir aussi<<:>>
|
||||
|
||||
* <<fr '"Grok TiddlyWiki" by Soren Bjornstad'>>
|
||||
* <<fr "TiddlyWiki Video Tutorials by Francis Meetze">>
|
||||
* [ext[Developer Documentation|https://tiddlywiki.com/dev/index.html]] (en anglais)
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
created: 20131129094353704
|
||||
fr-title: TiddlyWiki sur Node.js
|
||||
modified: 20220402105820520
|
||||
tags: Editions Configurations
|
||||
modified: 20220417143845088
|
||||
tags: Platforms
|
||||
title: TiddlyWiki on Node.js
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,7 @@
|
|||
caption: Serveur PHP
|
||||
created: 20140111091844267
|
||||
fr-title: Enregistrer sur serveur PHP
|
||||
modified: 20220402105820520
|
||||
modified: 20220417143800691
|
||||
tags: Saving PHP
|
||||
title: Saving on a PHP Server
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
created: 20140103134551508
|
||||
fr-title: Sauvegarder avec TiddlyFox sur Android
|
||||
modified: 20220402105820520
|
||||
fr-title: Enregistrer avec TiddlyFox sur Android
|
||||
modified: 20220417143919185
|
||||
tags: [[Saving with TiddlyFox]]
|
||||
title: Saving with TiddlyFox on Android
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
|
|||
|
|
@ -4,9 +4,9 @@ community-author: Jeremy Ruston
|
|||
created: 20131221085742684
|
||||
delivery: Browser Extension
|
||||
description: Extension pour les anciennes versions de Firefox
|
||||
fr-title: Sauvegarder avec TiddlyFox
|
||||
fr-title: Enregistrer avec TiddlyFox
|
||||
method: save
|
||||
modified: 20220402105820520
|
||||
modified: 20220417143943429
|
||||
tags: Saving Firefox
|
||||
title: Saving with TiddlyFox
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
|
|||
|
|
@ -0,0 +1,40 @@
|
|||
caption: {{$:/language/SideBar/Open/Caption}}
|
||||
created: 20141119223515194
|
||||
modified: 20220417143300015
|
||||
tags: $:/tags/SideBar
|
||||
title: $:/core/ui/SideBar/Open
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
\whitespace trim
|
||||
\define lingo-base() $:/language/CloseAll/
|
||||
|
||||
\define drop-actions()
|
||||
<$action-listops $tiddler=<<tv-story-list>> $subfilter="+[insertbefore<actionTiddler>,<currentTiddler>]"/>
|
||||
\end
|
||||
|
||||
\define placeholder()
|
||||
<div class="tc-droppable-placeholder"/>
|
||||
\end
|
||||
|
||||
\define droppable-item(button)
|
||||
\whitespace trim
|
||||
<$droppable actions=<<drop-actions>> enable=<<tv-allow-drag-and-drop>> tag="div">
|
||||
<<placeholder>>
|
||||
<div>
|
||||
$button$
|
||||
</div>
|
||||
</$droppable>
|
||||
\end
|
||||
|
||||
<div class="tc-sidebar-tab-open">
|
||||
<$list filter="[list<tv-story-list>]" history=<<tv-history-list>> storyview="pop">
|
||||
<div class="tc-sidebar-tab-open-item">
|
||||
<$macrocall $name="droppable-item" button="""<$button message="tm-close-tiddler" tooltip={{$:/language/Buttons/Close/Hint}} aria-label={{$:/language/Buttons/Close/Caption}} class="tc-btn-invisible tc-btn-mini tc-small-gap-right">{{$:/core/images/close-button}}</$button><$link to={{!!title}}><$transclude field="fr-title"><$view field="title"/></$transclude></$link>"""/>
|
||||
</div>
|
||||
</$list>
|
||||
<$tiddler tiddler="">
|
||||
<div>
|
||||
<$macrocall $name="droppable-item" button="""<$button message="tm-close-all-tiddlers" class="tc-btn-invisible tc-btn-mini"><<lingo Button>></$button>"""/>
|
||||
</div>
|
||||
</$tiddler>
|
||||
</div>
|
||||
|
|
@ -1,7 +1,5 @@
|
|||
created: 20141108184809586
|
||||
creator: 127.0.0.1
|
||||
modified: 20141212092801073
|
||||
modifier: 127.0.0.1
|
||||
modified: 20220419215154259
|
||||
tags: $:/tags/Macro
|
||||
title: $:/editions/fr-FR/util-macros
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -36,4 +34,6 @@ type: text/vnd.tiddlywiki
|
|||
<!-- NO-BREAK SPACE Unicode: U+00A0, UTF-8: C2 A0, ISO-8859-1: A0 -->
|
||||
« $text$ »
|
||||
\end
|
||||
\define fr(cible) <$link to="$cible$"><$view tiddler="$cible$" field="fr-title">{{$cible$!!title}}</$view></$link>
|
||||
\define fr(cible) <$link to="""$cible$"""><$view tiddler="""$cible$""" field="fr-title">{{$cible$!!title}}</$view></$link>
|
||||
|
||||
<pre><$view field="text"/></pre>
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
created: 20150531155638729
|
||||
modified: 20220304175111424
|
||||
modified: 20220417224935943
|
||||
tags: $:/tags/Macro
|
||||
title: $:/editions/tw5.com/wikitext-macros
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -7,13 +7,17 @@ type: text/vnd.tiddlywiki
|
|||
\define wikitext-example(src)
|
||||
<div class="doc-example">
|
||||
|
||||
<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>
|
||||
|
||||
```
|
||||
$src$
|
||||
```
|
||||
|
||||
Affichera ceci :
|
||||
|
||||
$$$text/vnd.tiddlywiki
|
||||
$src$
|
||||
$$$
|
||||
|
||||
Code HTML correspondant :
|
||||
|
||||
|
|
@ -26,22 +30,39 @@ $$$
|
|||
\define wikitext-example-without-html(src)
|
||||
<div class="doc-example">
|
||||
|
||||
<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>
|
||||
|
||||
```
|
||||
$src$
|
||||
```
|
||||
|
||||
Affichera ceci :
|
||||
|
||||
$$$text/vnd.tiddlywiki
|
||||
$src$
|
||||
$$$
|
||||
</div>
|
||||
\end
|
||||
|
||||
\define wikitext-example-table-header() <thead><tr><th/><th>ce [[WikiTexte|WikiText]]</th><th>affichera ceci</th></tr></thead>
|
||||
|
||||
\define wikitext-example-table-row(id, code)
|
||||
<tr>
|
||||
<th><<__id__>></th><td><$codeblock code=<<__code__>>/></td><td>
|
||||
|
||||
<<__code__>>
|
||||
</td>
|
||||
</tr>
|
||||
\end
|
||||
|
||||
\define tw-code(tiddler)
|
||||
<$codeblock language={{$tiddler$!!type}} code={{$tiddler$}}/>
|
||||
\end
|
||||
|
||||
\define tw-code-link(tiddler)
|
||||
[[$tiddler$]]:
|
||||
[[$tiddler$]] :
|
||||
|
||||
<<tw-code $tiddler$>>
|
||||
\end
|
||||
\end
|
||||
|
||||
<pre><$view field="text"/></pre>
|
||||
|
|
@ -0,0 +1,72 @@
|
|||
caption: transclude
|
||||
created: 20130824142500000
|
||||
fr-title: Widget Transclude
|
||||
modified: 20220418115006451
|
||||
tags: Widgets
|
||||
title: TranscludeWidget
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! Introduction
|
||||
|
||||
Le Widget Transclude importe dynamiquement le contenu d'un autre tiddler.
|
||||
|
||||
! Attributs
|
||||
|
||||
|!Attribut |!Description |
|
||||
|tiddler |Le titre du tiddler à transclure (par défaut le tiddler courant) |
|
||||
|field |Le nom du champ du tiddler (par défaut "text"<<;>> si présent, a priorité sur l'attribut index) |
|
||||
|index |L'index d'une propriété d'un [[Tiddler Data|DataTiddlers]] |
|
||||
|subtiddler |Titre optionnel d'un sous-tiddler quand le tiddler cible est un [[plugin|Plugins]] (voir infra) |
|
||||
|mode |Force le mode d'analyse du texte transclus à "block" ou à "inline" (voir infra) |
|
||||
|
||||
Le Widget Transclude traite son propre contenu comme cible par défaut si la cible de transclusion n'est pas complètement définie (ex<<:>> un tiddler ou un champ manquant)
|
||||
|
||||
! Modes d'analyse
|
||||
|
||||
<<tw>> analyse le <<fr WikiText>> dans [[deux modes|WikiText Parser Modes]]<<:>>
|
||||
|
||||
* le [[mode « en ligne »|Inline Mode WikiText]] (//inline//) reconnaît les formats de ''caractères'', tels que l'emphase, les liens
|
||||
* le [[mode « bloc »|Block Mode WikiText]] (//block//) reconnaît tous les formats ''en ligne'', et ajoute les formats de ''blocs'' comme les tableaux, les listes et les titres
|
||||
|
||||
Habituellement, le mode bloc ou en ligne est déduit automatiquement du mode dans lequel le Widget Transclude lui-même a été analysé. Il peut toutefois être ajusté avec l'attribut `mode`.
|
||||
|
||||
Par exemple, considérons un tiddler <<gf "A">> avec ce contenu<<:>>
|
||||
|
||||
```
|
||||
# Article un
|
||||
#<$transclude tiddler="B"/>
|
||||
# Article deux
|
||||
```
|
||||
|
||||
Et un tiddler <<gf "B">> avec ce contenu<<:>>
|
||||
|
||||
```
|
||||
# Article un - a
|
||||
# Article un - b
|
||||
```
|
||||
|
||||
Le résultat donnera quelque chose comme<<:>>
|
||||
|
||||
# Article un
|
||||
# # Article un - a # Article un - b
|
||||
# Article deux
|
||||
|
||||
Cela peut être corrigé en modifiant le tiddler <<gf "A">><<:>>
|
||||
|
||||
```
|
||||
# Article un
|
||||
#<$transclude tiddler="B" mode="block"/>
|
||||
# Article deux
|
||||
```
|
||||
Voir aussi ces [[autres exemples|WikiText parser mode: transclusion examples]].
|
||||
|
||||
! Accès aux sous-tiddlers
|
||||
|
||||
Le Widget Transclude permet l'accès aux tiddlers individuels inclus dans un [[plugin|Plugins]].
|
||||
|
||||
L'exemple suivant transclura la version initiale du tiddler noyau [[$:/DefaultTiddlers]] même s'il a été modifié<<:>>
|
||||
|
||||
<<wikitext-example-without-html '
|
||||
<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
|
||||
|
||||
'>>
|
||||
|
|
@ -1,6 +1,7 @@
|
|||
caption: Citations en bloc
|
||||
created: 20131206154636572
|
||||
fr-title: Citations en bloc dans WikiText
|
||||
modified: 20220226225218713
|
||||
fr-title: Citations en bloc en WikiTexte
|
||||
modified: 20220417214816463
|
||||
tags: WikiText
|
||||
title: Block Quotes in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
caption: Blocs de code
|
||||
created: 20141016143834720
|
||||
fr-title: Blocs de code en WikiText
|
||||
modified: 20220226232420710
|
||||
fr-title: Blocs de code en WikiTexte
|
||||
modified: 20220420233001221
|
||||
tags: WikiText
|
||||
title: Code Blocks in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -41,4 +41,4 @@ Ce texte aura une chasse fixe et ne sera pas `formaté`.
|
|||
```
|
||||
</pre>
|
||||
|
||||
Certains claviers traitent le backtick comme une [[touche morte|http://fr.wikipedia.org/wiki/Touche_morte]], le rendant difficile à taper. L'astuce est de taper 3 <code>`</code> suivis d'un espace. Une autre méthode consiste à taper 6 <code>`</code> d'affilée, puis de bouger le curseur en arrière trois fois pour taper ou coller le contenu du bloc.
|
||||
Certains claviers traitent l'accent grave comme une [[touche morte|http://fr.wikipedia.org/wiki/Touche_morte]], le rendant difficile à saisir tout seul. L'astuce consiste à saisir 3 <code>`</code> suivis d'un espace. Une autre méthode consiste à saisir 6 <code>`</code> d'affilée, puis de bouger le curseur en arrière trois fois pour saisir ou coller le contenu du bloc.
|
||||
|
|
@ -1,12 +1,12 @@
|
|||
caption: Tirets
|
||||
created: 20141016153634338
|
||||
modified: 20141116092606603
|
||||
fr-title: Tirets en WikiTexte
|
||||
modified: 20220422135611636
|
||||
tags: WikiText
|
||||
title: Dashes in WikiText
|
||||
fr-title: Tirets en WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Les [[tirets|Tirets]] se font avec :
|
||||
En <<fr WikiText>>, les [[tirets|Tirets]] se font avec :
|
||||
|
||||
* deux caractères "moins" `--` pour le tiret moyen ou semi-cadratin : --
|
||||
* trois caractères "moins" `---` pour le tiret long ou cadratin : ---
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
caption: Définitions
|
||||
created: 20131205160424246
|
||||
fr-title: Définitions dans WikiText
|
||||
modified: 20150601094201146
|
||||
fr-title: Définitions en WikiTexte
|
||||
modified: 20220422000443083
|
||||
tags: WikiText
|
||||
title: Definitions in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -1,12 +1,12 @@
|
|||
caption: Formatage
|
||||
created: 20141016142259705
|
||||
fr-title: Mise en forme avec WikiText
|
||||
modified: 20220226233811803
|
||||
fr-title: Mise en forme en WikiTexte
|
||||
modified: 20220420234926288
|
||||
tags: WikiText
|
||||
title: Formatting in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Voici les formatages de caractères disponibles en [[WikiTexte|WikiText]]<<:>>
|
||||
Voici les formats de caractères disponibles en <<fr WikiText>><<:>>
|
||||
|
||||
|Format |Résultat |Icône |h
|
||||
|<code>`code`</code><br><code>``code contenant du `code` ``</code> |`code`<br>``code contenant du `code` `` |<<.icon $:/core/images/mono-line>> |
|
||||
|
|
@ -17,7 +17,6 @@ Voici les formatages de caractères disponibles en [[WikiTexte|WikiText]]<<:>>
|
|||
|`^^exposant^^` |texte en ^^exposant^^ |<<.icon $:/core/images/superscript>> |
|
||||
|`,,indice,,` |texte en ,,indice,, |<<.icon $:/core/images/subscript>> |
|
||||
|
||||
Voir aussi<<:>> [[WikiTexte : blocs de code|Code Blocks in WikiText]]
|
||||
Voir aussi<<:>> <<fr "Code Blocks in WikiText">>
|
||||
|
||||
; Remarque
|
||||
: Si le code inclus est à la fin du code contenant, l'espace entre le <code>`</code> et les <code>``</code> est nécessaire.
|
||||
<<.tip """Dans l'exemple de <code>``code contenant du `code` ``</code>, notez qu'à la fin, l'espace entre le <code>`</code> et les <code>``</code> est obligatoire.""">>
|
||||
|
|
@ -1,6 +1,7 @@
|
|||
caption: Fins de lignes forcées
|
||||
created: 20141017123553069
|
||||
fr-title: Fins de Ligne
|
||||
modified: 20150623065025718
|
||||
fr-title: Fins de lignes forcées en WikiTexte
|
||||
modified: 20220422010528643
|
||||
tags: WikiText
|
||||
title: Hard Linebreaks in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -13,7 +14,7 @@ Ce comportement n'est pas pratique pour du texte qui intègre des retours à la
|
|||
|
||||
Un bloc de contenu délimité par trois caractères "guillemets doubles" `"""` permet d'indiquer que les fins de ligne doivent y être forcées :
|
||||
|
||||
<<wikitexte-exemple '"""
|
||||
<<wikitext-example-without-html '"""
|
||||
Ceci est une ligne
|
||||
et ceci est une nouvelle ligne
|
||||
tandis que cela est encore une autre ligne
|
||||
|
|
@ -29,9 +30,9 @@ excepté celle-ci
|
|||
|
||||
Les fins de lignes ne devraient pas être forcées dans un texte courant, car cela peut déformer l'affichage sur des terminaux mobiles.
|
||||
|
||||
Cependant, dans des cas exceptionnels, la balise [[HTML|WikiTexte : HTML]] `<br>` peut être utilisée pour revenir à la ligne sans créer de nouveau paragraphe :
|
||||
Cependant, dans des cas exceptionnels, la balise [[HTML|HTML in WikiText]] `<br>` peut être utilisée pour revenir à la ligne sans créer de nouveau paragraphe :
|
||||
|
||||
<<wikitexte-exemple "Ceci est une première ligne.<br>
|
||||
<<wikitext-example-without-html "Ceci est une première ligne.<br>
|
||||
Ceci est une deuxième ligne.<br>Et cela est une troisième ligne.">>
|
||||
|
||||
; Remarque
|
||||
|
|
@ -1,14 +1,14 @@
|
|||
caption: Titres de rubriques
|
||||
created: 20141017093039992
|
||||
fr-title: Titres de rubriques dans WikiText
|
||||
modified: 20220226234057628
|
||||
fr-title: Titres de rubriques en WikiTexte
|
||||
modified: 20220422010744063
|
||||
tags: WikiText
|
||||
title: Headings in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Un titre de rubrique est codé par un à 6 caractères <<gf "point d'exclamation">> `!` au début d'une ligne<<:>>
|
||||
|
||||
<<wikitexte-exemple "! Titre de niveau 1
|
||||
<<wikitext-example-without-html "! Titre de niveau 1
|
||||
!! Titre de niveau 2
|
||||
!!! Titre de niveau 3
|
||||
!!!! Titre de niveau 4
|
||||
|
|
@ -17,6 +17,6 @@ Un titre de rubrique est codé par un à 6 caractères <<gf "point d'exclamation
|
|||
|
||||
Des [[styles et des classes CSS|Styles and Classes in WikiText]] peuvent être assignés individuellement aux titres :
|
||||
|
||||
<<wikitexte-exemple "!! Titre
|
||||
<<wikitext-example-without-html "!! Titre
|
||||
!!@@background-color:#00ffff; Titre stylisé@@
|
||||
!!.monStyle Titre stylisé avec une classe">>
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
caption: Ligne horizontale
|
||||
created: 20141017091105859
|
||||
fr-title: Lignes horizontales en WikiTexte
|
||||
modified: 20220421000313978
|
||||
tags: WikiText
|
||||
title: Horizontal Rules in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Vous pouvez insérer une ligne horizontale à l'aide d'une série d'au moins trois tirets tout seuls sur une ligne<<:>>
|
||||
|
||||
<<wikitext-example-without-html "Paragraphe précédent.
|
||||
|
||||
---
|
||||
Paragraphe suivant.">>
|
||||
|
||||
; Remarque
|
||||
* La ligne vide avant les `---` est nécessaire pour que la ligne horizontale soit interprétée correctement, et pas comme un [[tiret|Dashes in WikiText]].
|
||||
|
|
@ -1,14 +1,14 @@
|
|||
caption: Listes
|
||||
created: 20131205160257619
|
||||
fr-title: Les listes de WikiText
|
||||
modified: 20150601074427119
|
||||
tags: WikiText
|
||||
fr-title: Listes en WikiTexte
|
||||
modified: 20220417215924211
|
||||
tags: Lists WikiText
|
||||
title: Lists in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! Listes non-ordonnées
|
||||
! Listes à puces
|
||||
|
||||
Vous pouvez créer des listes non ordonnées en préfixant du caractère `*`<<:>>
|
||||
Vous pouvez créer des listes à puces à l'aide du caractère `*` (<<.icon $:/core/images/list-bullet>>)<<:>>
|
||||
|
||||
<<wikitext-example src:"* Premier élément d'une liste
|
||||
* Deuxième éléments d'un liste
|
||||
|
|
@ -18,28 +18,28 @@ Vous pouvez créer des listes non ordonnées en préfixant du caractère `*`<<:>
|
|||
|
||||
! Listes ordonnées
|
||||
|
||||
Les listes ordonnées utilisent `#` au lieu de `*`:
|
||||
Les listes ordonnées utilisent `#` au lieu de `*` (<<.icon $:/core/images/list-number>>)<<:>>
|
||||
|
||||
<<wikitext-example src:"# Premier élément
|
||||
# Deuxième élément
|
||||
# Troisième élément
|
||||
">>
|
||||
|
||||
Vous pouvez combiner des listes non-ordonnées et des listes ordonnées :
|
||||
Vous pouvez combiner des listes à puces et des listes ordonnées :
|
||||
|
||||
<<wikitext-example src:"* À faire ce jour
|
||||
*# Manger
|
||||
* Chercher qlq chose à faire
|
||||
* À faire faire
|
||||
*# Ceci
|
||||
*# Cela
|
||||
*## Et le reste
|
||||
">>
|
||||
|
||||
L'exemple inverse, avec les nombres en premier niveau :
|
||||
L'exemple inverse, avec les nombres en premier niveau<<:>>
|
||||
|
||||
<<wikitext-example src:"# À faire ce jour
|
||||
#* Manger
|
||||
# Chercher qlq chose à faire
|
||||
# À faire faire
|
||||
#* Ceci
|
||||
#* Cela
|
||||
#** Et le reste
|
||||
|
|
@ -47,16 +47,16 @@ L'exemple inverse, avec les nombres en premier niveau :
|
|||
|
||||
! Les classes CSS
|
||||
|
||||
Vous pouvez affecter une classe CSS à un des membres de la liste en procédant ainsi :
|
||||
Vous pouvez affecter une classe CSS à l'un des membres de la liste en procédant ainsi<<:>>
|
||||
|
||||
<<wikitext-example src:"* Liste Un
|
||||
*.MyClass Liste Deux
|
||||
*.MaClasse Liste Deux
|
||||
* Liste Trois
|
||||
">>
|
||||
|
||||
! Combiner listes et blocs
|
||||
! Combiner listes et citations en blocs
|
||||
|
||||
Noter que [[les blocs avec WikiText]] peuvent être mixés aux listes. Par exemple<<:>>
|
||||
Noter que les <<fr "Block Quotes in WikiText">> peuvent être combinées aux listes. Par exemple<<:>>
|
||||
|
||||
<<wikitext-example src:"* Liste Une
|
||||
** Liste deux
|
||||
|
|
@ -67,9 +67,9 @@ Noter que [[les blocs avec WikiText]] peuvent être mixés aux listes. Par exemp
|
|||
|
||||
! Les paragraphes dans les listes
|
||||
|
||||
Les entrées d'une liste sont séparées par des sauts de ligne, rendant impossible d'y inclure des sauts de lignes, sans passer à l'entrée suivante. Il y a deux façons de passer outre.
|
||||
Les entrées d'une liste sont séparées par des sauts de ligne, rendant impossible d'y inclure des sauts de lignes sans passer à l'entrée suivante. Deux contournements sont possibles.
|
||||
|
||||
En un, vous pouvez transclure dans le paragraphe le contenu d'un autre tiddler. Par exemple :
|
||||
En un, vous pouvez transclure dans le paragraphe le contenu d'un autre tiddler. Par exemple<<:>>
|
||||
|
||||
```
|
||||
* Première entrée
|
||||
|
|
@ -77,18 +77,18 @@ En un, vous pouvez transclure dans le paragraphe le contenu d'un autre tiddler.
|
|||
* Troisième
|
||||
```
|
||||
|
||||
En deux, vous pouvez utiliser le tag HTML "div" pour inclure un contenu multiligne. Par exemple :
|
||||
En deux, vous pouvez utiliser la balise HTML "div" pour inclure un contenu multiligne. Par exemple<<:>>
|
||||
|
||||
```
|
||||
# Étape 1
|
||||
# Étape 2
|
||||
# Étape 3<div>
|
||||
|
||||
Ici, le premier parmi plusieurs paragraphes. Noter que le double saut de ligne précédant ce paragraphe est pris en compte.
|
||||
Ici, le premier parmi plusieurs paragraphes. Notez que le double saut de ligne précédant ce paragraphe est pris en compte.
|
||||
|
||||
Et ici, le deuxième parmi plusieurs paragraphes.
|
||||
</div>
|
||||
# Étape 4
|
||||
# Étape 5
|
||||
# Étape 6
|
||||
```
|
||||
```
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
caption: Appel de Macro
|
||||
created: 20150220182252000
|
||||
fr-title: Appel de macro en WikiTexte
|
||||
modified: 20220422225844802
|
||||
tags: WikiText
|
||||
title: Macro Calls in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Pour appeler une [[macro|Macros]], placez des `<<`doubles parenthèses en équerre`>>` autour de son nom et des valeurs de ses paramètres. ex<<:>> `<<maMacro val1 val2 ... valn>>`
|
||||
|
||||
Par défaut, les paramètres sont passés dans l'ordre fixé lors de la définition de la macro. Un paramètre peut être identifié par son nom, pour plus de clarté ou pour pouvoir les utiliser dans le désordre.
|
||||
|
||||
Si aucune valeur n'est fournie pour un paramètre, la valeur par défaut fixée lors de la définition de la macro est utilisée (si aucune valeur par défaut n'est définie, le paramètre est tout simplement vide).
|
||||
|
||||
Chaque valeur de paramètre peut être délimitée par des `'`simples cotes`'`, des `"`doubles cotes`"`, des `"""`doubles cotes triplées`"""` ou des `[[`doubles crochets`]]`. Les doubles cotes triplées permettent de passer à peu près toutes les valeurs. Si une valeur ne contient ni espace, ni simple ou double cotes, les délimiteurs sont inutiles.
|
||||
|
||||
Une [[description|Macro Call Syntax]] plus formelle de cette syntaxe est aussi disponible.
|
||||
|
||||
Cette syntaxe est une forme abrégée du widget <<.wlink MacroCallWidget>>. Le widget en lui-même permet une plus grande flexibilité, incluant la capacité de [[transclure|Transclusion]] des valeurs de paramètres ou de les générer via des macros additionnelles.
|
||||
|
||||
Comme les macros sont de simples [[variables|Variables]] paramétrées, des valeurs de variables peuvent être insérées en faisant appel aux mêmes techniques.
|
||||
|
||||
[[Des exemples|Macro Calls in WikiText (Examples)]] et [[d'autres exemples|WikiText parser mode: macro examples]] sont à votre disposition.
|
||||
|
||||
!! Paramètres nommés ou anonymes
|
||||
|
||||
En <<fr WikiText>>, nommer les paramètres lors de l'appel aux macros est toujours le choix le plus sûr par rapport à l'utilisation de valeurs anonymes. Ne pas utiliser le nom des paramètres peut avoir des effets indésirables perturbants. Imaginez par exemple que le premier paramètre d'une macro serve à spécifier le nom d'un [[tiddler d'état|StateMechanism]], et que le second soit destiné à préciser un [[tiddler gabarit|Transclusion with Templates]]. Si vous deviez par mégarde oublier de définir la valeur du premier paramètre ou vous tromper dans l'ordre des paramètres, au prochain appel de la macro (qui pourrait même avoir lieu en prévisualisant votre tiddler) votre gabarit pourrait être malencontreusement écrasé avec le contenu destiné au tiddler d'état.
|
||||
|
|
@ -1,24 +1,25 @@
|
|||
caption: Paragraphes
|
||||
created: 20141017122121853
|
||||
modified: 20141116092111983
|
||||
fr-title: Paragraphes en WikiTexte
|
||||
modified: 20220422011108016
|
||||
tags: WikiText
|
||||
title: Paragraphs in WikiText
|
||||
fr-title: Paragraphes
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Pour marquer la fin d'un paragraphe, il faut appuyer deux fois sur la touche `Entrée` pour créer deux retours à la ligne :
|
||||
Pour marquer la fin d'un paragraphe, il faut appuyer deux fois sur la touche `Entrée` pour créer deux retours à la ligne<<:>>
|
||||
|
||||
<<wikitexte-exemple "Ceci est un premier paragraphe.
|
||||
<<wikitext-example-without-html "Ceci est un premier paragraphe.
|
||||
|
||||
Et ceci est un deuxième paragraphe.">>
|
||||
|
||||
; Remarque
|
||||
* Peu importe le nombre de retours à la lignes supplémentaires, l'espacement entre les paragraphes reste le même.
|
||||
|
||||
Au sein d'un paragraphe, un retour à la ligne seul est ignoré :
|
||||
Au sein d'un paragraphe, un retour à la ligne seul est ignoré<<:>>
|
||||
|
||||
<<wikitexte-exemple "Ceci est un
|
||||
<<wikitext-example-without-html "Ceci est un
|
||||
paragraphe constitué
|
||||
de plusieurs
|
||||
lignes courtes.">>
|
||||
|
||||
Pour les situations où ce comportement n'est pas pratique, voir aussi : [[WikiTexte : Fin de ligne|Hard Linebreaks in WikiText]].
|
||||
Pour les situations où ce comportement n'est pas pratique, voir aussi<<:>> <<fr "Hard Linebreaks in WikiText">>.
|
||||
|
|
@ -0,0 +1,69 @@
|
|||
caption: Tableaux
|
||||
created: 20130914132100000
|
||||
fr-title: Tableaux en WikiTexte
|
||||
modified: 20220422134839855
|
||||
tags: WikiText
|
||||
title: Tables in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! Concepts de base
|
||||
|
||||
TiddlyWiki5 forme les tableaux au moyen du signe barre verticale `|`, de cette façon<<:>>
|
||||
|
||||
```
|
||||
|!Cell1 |!Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
```
|
||||
|
||||
Le point d'exclamation marque les cellules d'entête<<:>>
|
||||
|
||||
|!Cell1 |!Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
|
||||
! L'alignement horizontal
|
||||
|
||||
L’alignement horizontal des cellules du tableau est contrôlé par l'insertion d'un espace avant/après le contenu de la cellule. Par exemple:
|
||||
|
||||
<<wikitext-example-without-html
|
||||
"""|Contenu aligné à gauche |
|
||||
| Contenu aligné à droite|
|
||||
| Contenu centré |
|
||||
|+++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++|""">>
|
||||
|
||||
! L'alignement vertical
|
||||
|
||||
L’alignement vertical des cellules du tableau est contrôlé par l'insertion, comme premier caractère de la cellule, soit d'un `^` pour un alignement en haut ou un `,` pour un alignement en bas. La combinaison avec l'alignement horizontal reste valable.
|
||||
|
||||
Exemple<<:>>
|
||||
|
||||
<<wikitext-example-without-html
|
||||
"""| ::<br>:: |^haut gauche |^ haut centré |^ haut droit|
|
||||
| ::<br>::<br>:: |milieu gauche | milieu centré | milieu droit|
|
||||
| ::<br>::|,bas gauche |, bas centré |, bas droit|""">>
|
||||
|
||||
Si vous voulez afficher un `^`ou un `,` comme premier caractère d'une cellule alignée à gauche, vous devez utiliser la technique de l'<<gf "échappement html">>. Voir, à ce sujet<<:>> <<fr "Formatting in WikiText">>.
|
||||
|
||||
| `^` | &#94; |
|
||||
| `,` | &#44; |
|
||||
|
||||
! La fusion des cellules
|
||||
|
||||
Pour fusionner le contenu de la cellule située au dessus utiliser `~`. Pour fusionner avec celle de gauche `<` et `>` pour celle de droite. Par exemple<<:>>
|
||||
|
||||
<<wikitext-example-without-html
|
||||
"""|Cell1 |Cell2 |Cell3 |Cell4 |
|
||||
|Cell5 |Cell6 |Cell7 |<|
|
||||
|Cell5 |~|Cell7 |Cell8 |
|
||||
|>|Cell9 |Cell10 |Cell11 |""">>
|
||||
|
||||
! Classes de tableau, légendes, en-têtes et pieds de tableau
|
||||
|
||||
Des classes CSS, des légendes, des en-têtes et pieds de tableau peuvent être spécifiés comme pseudo-lignes spéciales<<:>>
|
||||
|
||||
<<wikitext-example-without-html
|
||||
"""|maclasse autreClass|k
|
||||
|Ceci est une légende |c
|
||||
|Cell1 |Cell2 |
|
||||
|Cell3 |Cell4 |
|
||||
|Entête|Entête|h
|
||||
|Pied|Pied|f""">>
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
created: 20141018090608643
|
||||
fr-title: Transclusion et substitution
|
||||
modified: 20220419002739469
|
||||
tags: WikiText
|
||||
title: Transclusion and Substitution
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
La puissance du <<fr WikiText>> vient de sa capacité à utiliser le contenu d'un tiddler dans un autre. Cette capacité prend plusieurs formes qu'on peut facilement confondre.
|
||||
|
||||
La principale différence réside entre la transclusion et la substitution de texte<<:>>
|
||||
|
||||
* Une transclusion est remplacée dynamiquement avec l'une ou l'autre de ces valeurs<<:>>
|
||||
** un champ de tiddler
|
||||
** une variable
|
||||
* Une substitution de texte est réalisée dans le texte de la définition de la macro avant son utilisation.
|
||||
|
||||
! Transclusion de champ de tiddler
|
||||
|
||||
<<fr "Transclusion in WikiText">> décrit les bases de la transclusion. Par exemple<<:>>
|
||||
|
||||
```
|
||||
{{MonTiddler}}
|
||||
```
|
||||
|
||||
Comme décrit dans <<fr "HTML in WikiText">>, vous pouvez aussi transclure des valeurs de champs de tiddlers dans des attributs de balises HTML et de widgets. Par exemple<<:>>
|
||||
|
||||
```
|
||||
<$text text={{MonTiddler}}/>
|
||||
```
|
||||
|
||||
Comme décrit dans <<fr "Introduction to filter notation">>, vous pouvez aussi transclure des valeurs de champs de tiddlers dans des opérandes de filtres. Par exemple<<:>>
|
||||
|
||||
```
|
||||
{{{ [tag{TiddlerContenantMonTag}] }}}
|
||||
```
|
||||
|
||||
! Transclusion de variable/macro
|
||||
|
||||
Les définitions de variables qui comportent des paramètres ou des substitutions sont nommées des <<gf macros>>. Vous pouvez transclure la valeur d'une variable/macro grâce à la syntaxe<<:>>
|
||||
|
||||
```
|
||||
<<maMacro param:"Valeur d'attribut">>
|
||||
```
|
||||
|
||||
Comme décrit dans <<fr "HTML in WikiText">>, vous pouvez aussi transclure des valeurs de variables dans des attributs de balises HTML et de widgets. Par exemple<<:>>
|
||||
|
||||
```
|
||||
<$text text=<<myMacro>>/>
|
||||
```
|
||||
|
||||
Comme décrit dans <<fr "Introduction to filter notation">>, vous pouvez aussi transclure des valeurs de variables dans des opérandes de filtres. Par exemple<<:>>
|
||||
|
||||
```
|
||||
{{{ [tag<maMacro>] }}}
|
||||
```
|
||||
|
||||
! Substitution de texte
|
||||
|
||||
La substitution de texte a lieu quand la valeur d'une macro/variable est utilisée. Ce mécanisme est décrit dans <<fr "Macros in WikiText">>.
|
||||
|
||||
La différence principale entre la substitution et la transclusion est que la substitution a lieu ''avant'' l'analyse du <<fr WikiText>>, ce qui signifie que vous pouvez utiliser la substitution pour construire des assemblages de <<fr WikiText>>. Au contraire, les transclusions sont traitées indépendamment et ne peuvent pas être combinées avec du texte adjacent pour construire des assemblages de <<fr WikiText>>.
|
||||
|
|
@ -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 :
|
||||
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 [[Filtre|Filters]] :
|
||||
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 :
|
||||
|
||||
* [[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">>
|
||||
|
|
@ -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
|
||||
|
|
@ -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 ::
|
||||
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 :
|
||||
|
||||
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 :
|
||||
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 :
|
||||
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 :
|
||||
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 :
|
||||
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 :
|
||||
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
|
||||
$$$
|
||||
|
|
@ -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[]]">>"""/>
|
||||
|
|
@ -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]]">>
|
||||
|
|
@ -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.
|
||||
|
|
@ -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>```</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'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)]]
|
||||
|
|
@ -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]].
|
||||
|
|
@ -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.|
|
||||
|
|
@ -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>""">>
|
||||
|
|
@ -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>">>
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.""">>
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
created: 20220122145022547
|
||||
fr-title: Modes d'analyse du WikiTexte : exemples de transclusions
|
||||
modified: 20220419224014907
|
||||
tags: [[WikiText parser mode transitions]]
|
||||
title: WikiText parser mode: transclusion examples
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
|
||||
En utilisant le tiddler [[table-example]] qui contient<<:>>
|
||||
<$codeblock code={{table-example}}/>
|
||||
dans une transclusion, alors<<:>>
|
||||
<table><<wikitext-example-table-header>><tbody>
|
||||
<<wikitext-example-table-row 1 "* {{table-example}}">>
|
||||
<<wikitext-example-table-row 2 """* <div>
|
||||
|
||||
{{table-example}}
|
||||
</div>
|
||||
""">>
|
||||
<<wikitext-example-table-row 3 "* <$transclude tiddler=table-example/>">>
|
||||
<<wikitext-example-table-row 4 "* <$transclude tiddler=table-example></$transclude>">>
|
||||
<<wikitext-example-table-row 5 """* <$transclude tiddler=table-example>
|
||||
|
||||
</$transclude>""">>
|
||||
<<wikitext-example-table-row 6 "* <$transclude tiddler=table-example mode=block/>">>
|
||||
</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 une <<fr "Transclusion in WikiText">> il utilise le mode courant pour analyser le contenu du tiddler transclus. Le tiddler 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 transclus en hérite, donc la table est reconnue.
|
||||
|
||||
En utilisant le <<fr TranscludeWidget>>, 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 """Pour voir d'autres exemples similaires, consultez <<fr "WikiText parser mode: macro examples">>. La seule différence est qu'ici l'exemple de la ligne n°6 utilise l'attribut <<.attr mode>> du widget <<.wlink TranscludeWidget>> pour forcer explicitement le mode d'analyse plutôt que de de laisser le contenu de la balise le déterminer.""">>
|
||||
|
||||
---
|
||||
|
||||
Dans les exemples suivants, les transclusions sont directes, au lieu d'être incluses dans des listes à puces<<:>>
|
||||
|
||||
<table><<wikitext-example-table-header>><tbody>
|
||||
<<wikitext-example-table-row 1 "{{table-example}}">>
|
||||
<<wikitext-example-table-row 2 """<div>
|
||||
|
||||
{{table-example}}
|
||||
</div>
|
||||
""">>
|
||||
<<wikitext-example-table-row 3 "<$transclude tiddler=table-example/>">>
|
||||
<<wikitext-example-table-row 4 "<$transclude tiddler=table-example></$transclude>">>
|
||||
<<wikitext-example-table-row 5 """<$transclude tiddler=table-example>
|
||||
|
||||
</$transclude>""">>
|
||||
<<wikitext-example-table-row 6 "<$transclude tiddler=table-example mode=inline/>">>
|
||||
</tbody></table>
|
||||
|
||||
Parmi ces exemples, seuls les deux widgets <<.wlink TranscludeWidget>> dont la balise d'ouverture n'est pas suivie d'une ligne vide ainsi que l'appel qui comporte l'attribut <<.attr mode>>=<<.value inline>> (lignes n°3, 4 et 6) sont analysés en [[mode en ligne|Inline Mode WikiText]].
|
||||
|
||||
<<.tip """Voir aussi <<fr "WikiText parser mode: macro examples">> pour d'autres exemples similaires.""">>
|
||||
|
|
@ -0,0 +1,8 @@
|
|||
created: 20220118023452157
|
||||
modified: 20220419184729921
|
||||
tags: [[WikiText parser mode transitions (Examples)]]
|
||||
title: table-example
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
|cellule une|cellule deux|
|
||||
|cellule trois|cellule quatre|
|
||||
|
|
@ -20,8 +20,13 @@ code-body: yes
|
|||
}
|
||||
|
||||
.tc-sites-menu ol li a {
|
||||
padding-top: 0.25em;
|
||||
padding-bottom: 0.25em;
|
||||
display: block;
|
||||
padding: 0.25em 14px 0.25em 14px;
|
||||
width: 100%;
|
||||
text-align: left;
|
||||
color: #333333;
|
||||
line-height: 1.4;
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.tc-sites-menu ol li .tc-sites-menu-disabled {
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ By default, TiddlyWiki displays a blank screen while it is loading. You can add
|
|||
|
||||
Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
|
||||
|
||||
In order for the splash screen to be displayed before TiddlyWiki is initialised it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]].
|
||||
In order for the splash screen to be displayed before TiddlyWiki is initialised or [[decrypted|Encryption]], it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]], or any of the other system tags beginning with $:/tags/RawMarkup.
|
||||
|
||||
In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class `tc-remove-when-wiki-loaded`. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,7 @@
|
|||
created: 20220426221124514
|
||||
modified: 20220426221240671
|
||||
tags: [[Working with TiddlyWiki]]
|
||||
title: How to update TiddlyWiki to the latest version
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
{{Upgrading}}
|
||||
|
|
@ -6,7 +6,7 @@ delivery: App
|
|||
description: Android app for saving changes locally to device storage
|
||||
method: save
|
||||
modified: 20200507103926292
|
||||
tags: Saving Android
|
||||
tags: Saving Android [[Standalone App]]
|
||||
title: Saving on Android
|
||||
type: text/vnd.tiddlywiki
|
||||
url: https://github.com/donmor/Tiddloid
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ created: 20220221080637764
|
|||
delivery: App
|
||||
description: Desktop application for serving and syncing TiddlyWiki
|
||||
method: save
|
||||
tags: Saving Mac Windows Linux
|
||||
tags: Saving Mac Windows Linux [[Standalone App]]
|
||||
title: Saving on TidGi Desktop
|
||||
type: text/vnd.tiddlywiki
|
||||
url: https://github.com/tiddly-gittly/TidGi-Desktop/releases/latest
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ delivery: App
|
|||
description: Custom desktop application for working with TiddlyWiki
|
||||
method: save
|
||||
modified: 20200507104332791
|
||||
tags: Saving Mac Windows Linux
|
||||
tags: Saving Mac Windows Linux [[Standalone App]]
|
||||
title: Saving on TiddlyDesktop
|
||||
type: text/vnd.tiddlywiki
|
||||
url: https://github.com/TiddlyWiki/TiddlyDesktop/releases
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ delivery: App
|
|||
description: iPad/iPhone app for working with TiddlyWiki
|
||||
method: save
|
||||
modified: 20201007205336209
|
||||
tags: Saving iOS
|
||||
tags: Saving iOS [[Standalone App]]
|
||||
title: Saving on iPad/iPhone
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
created: 20140912140651119
|
||||
modified: 20220401151525812
|
||||
saving-browser: Firefox Chrome Edge [[Internet Explorer]] Safari Opera
|
||||
saving-browser: Firefox Chrome Edge [[Internet Explorer]] Safari Opera [[Standalone App]]
|
||||
saving-os: Windows Mac Linux Android iOS
|
||||
tags: [[Working with TiddlyWiki]]
|
||||
title: Saving
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
caption: transclude
|
||||
created: 20130824142500000
|
||||
modified: 20220122190609396
|
||||
modified: 20220513114759336
|
||||
tags: Widgets
|
||||
title: TranscludeWidget
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -65,7 +65,4 @@ The transclude widget allows access to the individual tiddlers stored within a [
|
|||
|
||||
The following example will transclude the core version of the tiddler [[$:/DefaultTiddlers]] even if it has been overridden:
|
||||
|
||||
<<wikitext-example-without-html '
|
||||
<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
|
||||
|
||||
'>>
|
||||
<<wikitext-example-without-html """<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>""">>
|
||||
|
|
|
|||
|
|
@ -1,14 +1,13 @@
|
|||
caption: Code Blocks
|
||||
created: 20131205160047557
|
||||
modified: 20160606140326254
|
||||
modified: 20220513120302826
|
||||
tags: WikiText
|
||||
title: Code Blocks in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
You can use triple backticks <code>```</code> to mark code blocks (<<.icon $:/core/images/mono-block>>):
|
||||
|
||||
<pre>
|
||||
```
|
||||
<pre>```
|
||||
This will be monospaced
|
||||
```
|
||||
</pre>
|
||||
|
|
@ -23,8 +22,7 @@ To be interpreted correctly, the three backticks need to be at the start of the
|
|||
|
||||
Be aware that any preceding paragraph content should be properly terminated with a double line break, too. So, this example is wrong:
|
||||
|
||||
<pre>
|
||||
This is an ordinary paragraph
|
||||
<pre>This is an ordinary paragraph
|
||||
```
|
||||
This will be monospaced
|
||||
```
|
||||
|
|
@ -32,8 +30,7 @@ This will be monospaced
|
|||
|
||||
The correct version is:
|
||||
|
||||
<pre>
|
||||
This is an ordinary paragraph
|
||||
<pre>This is an ordinary paragraph
|
||||
|
||||
```
|
||||
This will be monospaced
|
||||
|
|
|
|||
|
|
@ -1,8 +1,12 @@
|
|||
caption: Dashes
|
||||
created: 20131205160641986
|
||||
modified: 20131205160653909
|
||||
modified: 20220513111920644
|
||||
revision: 0
|
||||
tags: WikiText
|
||||
title: Dashes in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
caption: Dashes
|
||||
|
||||
You can create an n-dash with a double hyphen `--` and an m-dash with a triple hyphen `---`. For example -- this is an example --- and so is this
|
||||
You can create an n-dash with a double hyphen -- and an m-dash with a triple hyphen `---`.
|
||||
|
||||
<<wikitext-example src:"""* -- n-dash example
|
||||
* --- m-dash example --- have fun!""">>
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
caption: Formatting
|
||||
created: 20131205155959399
|
||||
modified: 20160606135946509
|
||||
modified: 20220513120211686
|
||||
tags: WikiText
|
||||
title: Formatting in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
@ -8,12 +8,12 @@ type: text/vnd.tiddlywiki
|
|||
Available character formatting includes:
|
||||
|
||||
* <code>`backticks`</code> for `code` (<<.icon $:/core/images/mono-line>>)
|
||||
** Alternatively, <code>``double backticks allows `embedded` backticks``</code>
|
||||
* `''bold''` for ''bold text'' (<<.icon $:/core/images/bold>>)
|
||||
* `//italic//` for //italic text// (<<.icon $:/core/images/italic>>)
|
||||
* `__underscore__` for __underscored text__ (<<.icon $:/core/images/underline>>)
|
||||
* `^^superscript^^` for ^^superscripted^^ text (<<.icon $:/core/images/superscript>>)
|
||||
* `,,subscript,,` for ,,subscripted,, text (<<.icon $:/core/images/subscript>>)
|
||||
** Alternatively, <code>``double backticks allows `embedded` backticks``</code><br><br>
|
||||
* `''bold''` for ''bold text'' (<<.icon $:/core/images/bold>>)<br><br>
|
||||
* `//italic//` for //italic text// (<<.icon $:/core/images/italic>>)<br><br>
|
||||
* `__underscore__` for __underscored text__ (<<.icon $:/core/images/underline>>)<br><br>
|
||||
* `^^superscript^^` for ^^superscripted^^ text (<<.icon $:/core/images/superscript>>)<br><br>
|
||||
* `,,subscript,,` for ,,subscripted,, text (<<.icon $:/core/images/subscript>>)<br><br>
|
||||
* `~~strikethrough~~` for ~~strikethrough~~ text (<<.icon $:/core/images/strikethrough>>)
|
||||
|
||||
See also: [[Code Blocks in WikiText]]
|
||||
|
|
|
|||
|
|
@ -1,9 +1,9 @@
|
|||
caption: Headings
|
||||
created: 20131205161234909
|
||||
modified: 20190412000000000
|
||||
modified: 20220513110830487
|
||||
tags: WikiText
|
||||
title: Headings in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
caption: Headings
|
||||
|
||||
Headings are specified with one up to six leading `!` characters:
|
||||
|
||||
|
|
@ -17,4 +17,4 @@ Headings are specified with one up to six leading `!` characters:
|
|||
|
||||
CSS classes can be assigned to individual headings like this:
|
||||
|
||||
<<wikitext-example src:"" "!!.myStyle This heading has the class `myStyle`">>
|
||||
<<wikitext-example src:"""!!.myStyle This heading has the class `myStyle`""">>
|
||||
|
|
|
|||
|
|
@ -1,12 +1,10 @@
|
|||
caption: Horizontal Rules
|
||||
created: 20131205160706975
|
||||
modified: 20131205160719633
|
||||
modified: 20220513111257531
|
||||
tags: WikiText
|
||||
title: Horizontal Rules in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
caption: Horizontal Rules
|
||||
|
||||
You can include a horizontal rule with three or more dashes on their own on a line:
|
||||
|
||||
<<wikitext-example src:"
|
||||
---
|
||||
">>
|
||||
<<wikitext-example src:"---">>
|
||||
|
|
|
|||
|
|
@ -1,41 +1,31 @@
|
|||
caption: Tables
|
||||
created: 20130914132100000
|
||||
modified: 20140125144616046
|
||||
modified: 20220513115945053
|
||||
tags: WikiText
|
||||
title: Tables in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
caption: Tables
|
||||
|
||||
! Basics
|
||||
|
||||
TiddlyWiki5 formats tables using vertical bar characters like so:
|
||||
TiddlyWiki5 formats tables using vertical bar `|` characters. Exclamation marks `!` are used to indicate header cells.
|
||||
|
||||
```
|
||||
|!Cell1 |!Cell2 |
|
||||
<<wikitext-example-without-html src:"""|!Cell1 |!Cell2 |
|
||||
|Cell3 |Cell3 |
|
||||
```
|
||||
""">>
|
||||
|
||||
Exclamation marks are used to indicate header cells. The example renders as:
|
||||
|
||||
|!Cell1 |!Cell2 |
|
||||
|Cell3 |Cell3 |
|
||||
|
||||
! Cell Alignment
|
||||
|
||||
Table cell alignment is controlled by inserting space characters before and/or after the cell content. For example:
|
||||
|
||||
```
|
||||
|Left aligned content |
|
||||
<<wikitext-example-without-html src:"""|Left aligned content |
|
||||
| Right aligned content|
|
||||
| Centred content |
|
||||
|+++ a very wide column so we can see the alignment +++|
|
||||
```
|
||||
""">>
|
||||
|
||||
The example renders as:
|
||||
|
||||
|Left aligned content |
|
||||
| Right aligned content|
|
||||
| Centred content |
|
||||
|+++ a very wide column so we can see the alignment +++|
|
||||
|
||||
! Cell vertical Alignment
|
||||
|
||||
|
|
@ -60,23 +50,19 @@ If you need to have a `^`or a `,` as the first character of a left aligned cell,
|
|||
| `^` | &#94; |
|
||||
| `,` | &#44; |
|
||||
|
||||
|
||||
|
||||
! Cell Merging
|
||||
|
||||
To merge a table cell with the one above, use the special cell text `~`. To merge a cell with the one to its left use the text `<`. To merge one to its right use `>`. For example:
|
||||
|
||||
```
|
||||
|Cell1 |Cell2 |Cell3 |Cell4 |
|
||||
<<wikitext-example-without-html src:"""|Cell1 |Cell2 |Cell3 |Cell4 |
|
||||
|Cell5 |Cell6 |Cell7 |<|
|
||||
|Cell5 |~|Cell7 |Cell8 |
|
||||
|>|Cell9 |Cell10 |Cell11 |
|
||||
```
|
||||
""">>
|
||||
|
||||
Renders as:
|
||||
|
||||
|Cell1 |Cell2 |Cell3 |Cell4 |
|
||||
|Cell5 |Cell6 |Cell7 |<|
|
||||
|Cell5 |~|Cell7 |Cell8 |
|
||||
|>|Cell9 |Cell10 |Cell11 |
|
||||
|
||||
! Table Classes, Captions, Headers and Footers
|
||||
|
||||
|
|
@ -87,20 +73,10 @@ Table CSS classes, captions, headers and footers can be specified as special pse
|
|||
* adds a header row of cells with the text "Header"
|
||||
* adds a footer row of cells with the text "Footer"
|
||||
|
||||
```
|
||||
|myclass anotherClass|k
|
||||
|This is a caption |c
|
||||
|Cell1 |Cell2 |
|
||||
|Cell3 |Cell3 |
|
||||
|Header|Header|h
|
||||
|Footer|Footer|f
|
||||
```
|
||||
|
||||
Renders as:
|
||||
|
||||
|myclass anotherClass|k
|
||||
<<wikitext-example-without-html src:"""|myclass anotherClass|k
|
||||
|This is a caption |c
|
||||
|Cell1 |Cell2 |
|
||||
|Cell3 |Cell3 |
|
||||
|Header|Header|h
|
||||
|Footer|Footer|f
|
||||
""">>
|
||||
|
|
|
|||
|
|
@ -1,15 +1,15 @@
|
|||
caption: Widgets
|
||||
created: 20131205160840915
|
||||
modified: 20220122193129241
|
||||
modified: 20220513113347606
|
||||
tags: WikiText
|
||||
title: Widgets in WikiText
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Widgets provide rich functionality within WikiText. They have the same syntax as [[HTML elements|HTML in WikiText]], but the tag name always starts with `$`. For example:
|
||||
|
||||
```
|
||||
<$button message="tm-close-tiddler">Close Me!</$button>
|
||||
```
|
||||
<$macrocall $name=".example" n="1"
|
||||
eg="""<$button message="tm-navigate" to="HelloThere">Open ~HelloThere</$button>
|
||||
"""/>
|
||||
|
||||
Note that widgets inherit all the features of [[HTML in WikiText]]:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
created: 20220110233944530
|
||||
modified: 20220202022415581
|
||||
modified: 20220513112653029
|
||||
tags: WikiText
|
||||
title: WikiText Parser Modes
|
||||
type: text/vnd.tiddlywiki
|
||||
|
|
|
|||
|
|
@ -489,3 +489,5 @@ Eskha, @es-kha, 2022/03/04
|
|||
Guang Li, @oflg, 2022/03/12
|
||||
|
||||
Dam S., @damscal, 2022/03/24
|
||||
|
||||
Max Schillinger, @MaxGyver83, 2022/05/11
|
||||
|
|
|
|||
Loading…
Reference in New Issue