1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-27 03:57:21 +00:00

fr-FR translation of TableOfContentsMacro documentation

This commit is contained in:
Xavier Cazin 2015-01-05 11:38:32 +01:00
parent 71357a8e39
commit a7d2fd4175
6 changed files with 152 additions and 0 deletions

View File

@ -0,0 +1,14 @@
caption: Développable
created: 20150104182842728
modified: 20150104183013132
tags: table-of-contents-example
title: TableOfContentsMacro Expandable Example
type: text/vnd.tiddlywiki
!! Table des matières développable
<$macrocall $name='wikitext-example-without-html'
src='<div class="tc-table-of-contents">
<<toc-expandable "Contents">>
</div>
'/>

View File

@ -0,0 +1,14 @@
caption: Développable sélectivement
created: 20150104182559211
modified: 20150104183032161
tags: table-of-contents-example
title: TableOfContentsMacro Selective Expandable Example
type: text/vnd.tiddlywiki
!! Table des matières développable sélectivement
<$macrocall $name='wikitext-example-without-html'
src='<div class="tc-table-of-contents">
<<toc-selective-expandable "Contents">>
</div>
'/>

View File

@ -0,0 +1,14 @@
caption: Simple
created: 20150104182258371
modified: 20150104182323524
tags: table-of-contents-example
title: TableOfContentsMacro Simple Example
type: text/vnd.tiddlywiki
!! Table des matières simple
<$macrocall $name='wikitext-example-without-html'
src='<div class="tc-table-of-contents">
<<toc "Contents">>
</div>
'/>

View File

@ -0,0 +1,14 @@
caption: Développable triée
created: 20150104182748334
modified: 20150104182956846
tags: table-of-contents-example
title: TableOfContentsMacro Sorted Expandable Example
type: text/vnd.tiddlywiki
!! Table des matières développable triée
<$macrocall $name='wikitext-example-without-html'
src='<div class="tc-table-of-contents">
<<toc-expandable "Contents" "sort[title]">>
</div>
'/>

View File

@ -0,0 +1,45 @@
caption: Tabbed
created: 20150104183128274
modified: 20150104222928663
tags: table-of-contents-example
title: TableOfContentsMacro Tabbed Example
type: text/vnd.tiddlywiki
!! Table des matières tabulée
La variante tabulée de la macro table des matières affiche une table des matières développable sélectivement à côté d'un panneau qui affiche le tiddler en cours de sélection.
!!! Paramètres
|!Position |!Nom |!Description |!Défaut |
|1^^re^^ |tag |Tag à utiliser pour construire la table des matières | |
|2^^e^^ |sort |Sous-filtre de tri optionnel (par exemple `sort[title]`) | |
|3^^e^^ |selectedTiddler |Titre du tiddler contenant le titre du tiddler en cours d'affichage |"$:/temp/toc/selectedTiddler" |
|4^^e^^ |unselectedText |Texte à afficher lorsqu'aucun tiddler n'est sélectionné | |
|5^^e^^ |missingText |Texte à afficher quand le tiddler sélectionné est manquant | |
|6^^e^^ |template |Titre optionnel d'un tiddler à utiliser comme template pour le rendu du tiddler sélectionné | |
!!! Navigation interne
Cet exemple montre comment construire une table des matières tabulée avec navigation interne, de sorte que cliquer sur les liens du tiddler en cours d'affichage remplacera le tiddler en question.
```
<<toc-tabbed-internal-nav tag:"TableOfContents" selectedTiddler:"$:/temp/toc/selectedTiddler" unselectedText:"Choisissez un sujet dans la table des matières. Cliquez sur la flèche pour développer un sujet.">>
```
!!! Navigation externe
Cet exemple montre comment construire une table des matières tabulée avec navigation externe, de sorte que cliquer sur les liens du tiddler en cours d'affichage ouvrira les tiddlers référencés dans le déroulé principal, selon la manière habituelle.
```
<<toc-tabbed-external-nav tag:"TableOfContents" selectedTiddler:"$:/temp/toc/selectedTiddler" unselectedText:"Choisissez un sujet dans la table des matières. Cliquez sur la flèche pour développer un sujet.">>
```
!! Exemple
Type<<:>> <$select tiddler="TabbedExampleType">
<option value="toc-tabbed-internal-nav">Ouvre les liens du tiddler affiché dans le même espace (toc-tabbed-internal-nav)</option>
<option value="toc-tabbed-external-nav">Ouvre les liens du tiddler affiché hors de son espace (toc-tabbed-external-nav)</option>
</$select>
<$macrocall $name={{TabbedExampleType}} tag="TableOfContents" selectedTiddler="$:/temp/toc/selectedTiddler" unselectedText="<p>Choisissez un sujet dans la table des matières. Cliquez sur la flèche pour développer un sujet.</p>" missingText="<p>Tiddler manquant.</p>"/>

View File

@ -0,0 +1,51 @@
caption: toc
created: 20140919155729620
modified: 20150105102807522
tags: Macros
title: TableOfContentsMacro
type: text/vnd.tiddlywiki
La macro //~TableOfContents// (Table des Matières) produit une arborescence hiérarchique de tiddlers, en se basant sur leurs tags.
Les entrées de premier niveau de la table des matières sont définies par un tag racine. Les sous-entrées de chacune de ces entrées sont taguées avec le titre de l'entrée. Les entrées peuvent être triées à l'aide du champ `list` du tiddler de tag correspondant, comme décrit dans [[Tagging]].
Le libellé utilisé pour chaque entrée est tiré du champ ''caption'' s'il est présent<<;>> dans le cas contraire, c'est le titre (champ ''title'') qui est utilisé.
Les entrées sont affichées sous forme de liens vers le tiddler correspondant, à moins que le tiddler contienne un champ ''toc-link'' avec la valeur ''no''. Dans les exemples ci-dessous, l'entrée SecondThree est configurée ainsi, de manière à ne pas apparaître comme un lien.
Il existe plusieurs variantes de cette macro<<:>>
* `<<toc>>` produit une arborescence hiérarchique de liens simple
* `<<toc-expandable>>` produit une arborescence de liens développable
* `<<toc-selective-expandable>>` produit une arborescence de liens développable où les boutons développer / contracter ne sont affichés que pour les entrées qui possèdent des nœuds fils
Les macros génèrent des listes HTML ordonnées. Les éléments `<ol>` bénéficient de la classe `tc-toc`, ceux de la variante //expandable// bénéficiant également de la classe `tc-toc-expandable` tandis que ceux de la variante //selective expandable// bénéficient de la classe `tc-toc-selective-expandable`.
! Paramètres
|!Position |!Nom |!Description |!Défaut |
|1^^re^^ |tag |Le tag racine qui identifie le premier niveau de la hiérachie | |
|2^^e^^ |sort |Sous-fitre optionnel de tri (par exemple `sort[title]`) | |
Les paramètres ''tag'' et ''sort'' sont combinés pour construire une expression de filtre de la forme<<:>>
```
[tag[$tag$]$sort$]
```
! Exemples
Dans les exemples suivants, les entrées de premier niveau de la table des matières sont définies par leur tag racine ''Contents''. Les sous-entrées sous chacune de ces entrées sont taguées avec le titre de leur parent, ici ''First'', ''Second'', ''Third'', et ''Fourth''. Au niveau du dessous, seul ''~SecondThree'' comporte des sous-entrées.
Voici la structure des tags, affichée à l'aide de pastilles de tag cliquables<<:>>
{{Contents||$:/core/ui/TagTemplate}}
*{{First||$:/core/ui/TagTemplate}}
*{{Second||$:/core/ui/TagTemplate}}
**{{SecondThree||$:/core/ui/TagTemplate}}
*{{Third||$:/core/ui/TagTemplate}}
*{{Fourtth||$:/core/ui/TagTemplate}}
Pour des instructions sur la manière d'ajouter une table des matières dans la barre latérale, voyez<<:>> [[Comment ajouter un nouvel onglet dans la barre latérale|How to add a new tab to the sidebar]].
<<tabs "[tag[table-of-contents-example]]" "TableOfContentsMacro Simple Example">>