kopia lustrzana https://github.com/miklobit/TiddlyWiki5
fr-FR translation of TableOfContentsMacro documentation
Xavier Cazin
rodzic
71357a8e39
commit
a7d2fd4175
|
|
@ -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>
|
||||
'/>
|
||||
|
|
@ -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>
|
||||
'/>
|
||||
|
|
@ -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>
|
||||
'/>
|
||||
|
|
@ -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>
|
||||
'/>
|
||||
|
|
@ -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>"/>
|
||||
|
|
@ -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">>
|
||||
Ładowanie…
Reference in New Issue