62 lines
2.5 KiB
Plaintext
62 lines
2.5 KiB
Plaintext
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>>.
|