mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-26 11:37:20 +00:00
115b20ff7b
* Translation updates, new translations, tiddlers renaming * Wrong target tiddler name for tw5.com's doc-macros.tid * Update GettingStarted
120 lines
5.3 KiB
Plaintext
120 lines
5.3 KiB
Plaintext
caption: HTML
|
|
created: 20141017141153174
|
|
fr-title: HTML dans le WikiTexte
|
|
modified: 20220227020401008
|
|
tags: WikiText
|
|
title: HTML in WikiText
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Balises HTML et commentaires
|
|
|
|
Les balises et les commentaires HTML peuvent être utilisées directement en [[WikiTexte|WikiText]]. Par exemple<<:>>
|
|
|
|
<<wikitexte-exemple "<article class='hello'>
|
|
Ceci est un simple bloc de texte. HelloThere
|
|
<!-- Ce commentaire n'apparaîtra pas. -->
|
|
</article>">>
|
|
|
|
; Remarque
|
|
: Par conséquent, un mot écrit entre "chevrons" `< >` sera interprété comme une balise HTML, ce qui peut entraîner des effets de bord (notamment à cause de l'inexistence de la balise fermante).<br>À la place, mieux vaut utiliser le [[code HTML|Codes HTML]] des caractères "chevrons" : `<` et `>`
|
|
|
|
!! Commentaires //Pragma//
|
|
|
|
<<.from-version 5.2.0>> Les commentaires peuvent maintenant être librement entremêlés avec les pragmas ou bien à l'intérieur du corps d'un bloc de wikitexte.
|
|
|
|
```
|
|
<!-- NOUVEAU ! : Commentaire qui décrit la macro -->
|
|
\define test()
|
|
Un peu de texte <!-- commentaire en ligne -->
|
|
\end
|
|
|
|
<<test>>
|
|
```
|
|
|
|
! Important
|
|
|
|
<<.tip """[[Les Widgets utilisent la même syntaxe que les balises HTML|Widgets in WikiText]], donc les informations suivantes s'appliquent aussi à eux.""">>
|
|
|
|
! Mode //bloc// ou mode //texte// ?
|
|
|
|
Pour que le contenu d'un élément HTML soit [[interprété|WikiText Parser Modes]] en [[mode bloc|Block Mode WikiText]], la balise ouvrante doit être suivie par deux retours à la ligne.
|
|
|
|
Sans les deux retours à la ligne, le contenu des balises sera [[interprété|WikiText Parser Modes]] en [[mode texte|Inline Mode WikiText]], ce qui signifie que les formatages de mode bloc tels que les tableaux, les listes et les titres ne seront pas reconnus.
|
|
|
|
Voir aussi <<fr "WikiText parser mode: HTML examples">> et <<fr "WikiText parser mode transitions">>.
|
|
|
|
! Éléments auto-fermants
|
|
|
|
Les balises suivantes sont traitées comme si elles étaient vides, ce qui signifie que `<balise>` est traitée comme si c'était `<balise/>`, et qu'aucune balise de fermeture `</balise>` n'est nécessaire. Mais si la balise fermante existe elle est ignorée et traitée comme du texte.
|
|
|
|
* `<area>`, `<base>`, `<br>`, `<col>`, `<command>`, `<embed>`, `<hr>`, `<img>`, `<input>`, `<keygen>`, `<link>`, `<meta>`, `<param>`, `<source>`, `<track>`, `<wbr>`
|
|
|
|
Si vous ne fermez pas n'importe quelle autre balise HTML, <<tw>> se comportera comme si les balises manquantes étaient déportées à la fin du tiddler.
|
|
|
|
! Attributs
|
|
|
|
Par extension à la syntaxe conventionnelle HTML, les attributs des éléments ou widgets peuvent être écrits de différentes façons<<:>>
|
|
|
|
* en tant que chaîne littérale
|
|
* en tant que transclusion de <<fr TextReference>>
|
|
* en tant que transclusion de [[macro ou de variable|Macros in WikiText]]
|
|
* en tant que résultat d'une [[expression de filtre|Filter Expression]]
|
|
|
|
!! Valeurs littérales d'attributs
|
|
|
|
Les valeurs littérales d'attribut peuvent utiliser différents styles de ponctuation<<:>>
|
|
|
|
* Guillemets simples (c-à-d `attribut='valeur'`)
|
|
* Guillemets doubles (c-à-d `attribut="valeur"`)
|
|
* Triples guillemets doubles (c-à-d `attribut="""valeur"""`)
|
|
* Aucune ponctuation n'est nécessaire pour les valeurs qui ne contiennent pas d'espace (c-à-d `attribut=valeur`)
|
|
|
|
Les valeurs littérales d'attribut peuvent contenir des retours à la ligne. Par exemple<<:>>
|
|
|
|
```
|
|
<div data-address="Maison Souris,
|
|
3 rue des rongeurs,
|
|
Ratville"/>
|
|
```
|
|
|
|
L'utilisation des triples guillemets doubles `"""` permet de spécifier des valeurs d'attributs qui contiennent des caractères "guillemet double"<<:>>
|
|
|
|
```
|
|
<div data-address="""Maison "Souris",
|
|
3 rue des rongeurs,
|
|
Ratville"""/>
|
|
```
|
|
|
|
!! Valeurs d'attributs par transclusion
|
|
|
|
Les valeurs d'attributs par transclusion sont encadrées par des doubles accolades autour d'une <<fr TextReference>>, par exemple<<:>>
|
|
|
|
```
|
|
attr={{tiddler}}
|
|
attr={{!!field}}
|
|
attr={{tiddler!!field}}
|
|
```
|
|
<<.warning "La valeur de l'attribut sera le résultat exact de la transclusion, sans aucune interprétation supplémentaire de <<fr WikiText>>. Toute syntaxe de wiki dans ce résultat sera laissée en l'état.">>
|
|
|
|
!! Valeur d'attribut par variable
|
|
|
|
Les valeurs d'attributs par variable sont encadrées par des doubles crochets autour d'un [[appel de macro|Macro Calls in WikiText]], par exemple<<:>>
|
|
|
|
```
|
|
<div title=<<MaMacro "Jacques">>>
|
|
...
|
|
</div>
|
|
```
|
|
<<.warning "Le texte de la définition de la macro est retrouvé et la substitution des arguments a lieu (c-à-d la syntaxe <<.param $param$>> et <<.param $(...)$>>). Le texte résultant est affecté à la valeur de l'attribut. Toute syntaxe wiki dans ce texte, y-compris d'autres appels de macros ou des références de variables, sera laissée en l'état.">>
|
|
|
|
!! Valeurs d'attributs par filtre
|
|
|
|
Les valeurs d'attributs par filtre sont encadrées par des accolades triples autour d'une [[expression de filtre|Filter Expression]]. Le premier élément de la liste renvoyée par le filtre est affecté à l'attribut, ou une chaîne vide si la liste est vide.
|
|
|
|
Cet exemple montre comment ajouter un préfixe à une valeur<<:>>
|
|
|
|
```
|
|
<$text text={{{ [<currentTiddler>addprefix[$:/myprefix/]] }}} />
|
|
```
|
|
<<.warning "La valeur de l'attribut sera le résultat exact du premier élément de la liste renvoyée par le filtre, sans aucune interprétation du <<fr WikiText>>. Toute syntaxe de wiki dans ce résultat sera laissée telle quelle.">>
|