From 864b5ec05dbc0eb2c0eadce040ebe7c6876dff76 Mon Sep 17 00:00:00 2001 From: TW Videos <11172651+TiddlyVee@users.noreply.github.com> Date: Wed, 2 Mar 2022 18:36:53 +0100 Subject: [PATCH 01/19] Improve readability for documentation macros (#6494) --- editions/tw5.com/tiddlers/system/operator-macros.tid | 6 ++++-- editions/tw5.com/tiddlers/system/style-guide-macros.tid | 6 +++++- editions/tw5.com/tiddlers/system/variable-macros.tid | 6 ++++-- editions/tw5.com/tiddlers/system/wikitext-macros.tid | 6 ++++-- 4 files changed, 17 insertions(+), 7 deletions(-) diff --git a/editions/tw5.com/tiddlers/system/operator-macros.tid b/editions/tw5.com/tiddlers/system/operator-macros.tid index 477968945..d24cac016 100644 --- a/editions/tw5.com/tiddlers/system/operator-macros.tid +++ b/editions/tw5.com/tiddlers/system/operator-macros.tid @@ -1,7 +1,7 @@ created: 20150117152607000 -modified: 20150228114306000 -title: $:/editions/tw5.com/operator-macros +modified: 20220227210111054 tags: $:/tags/Macro +title: $:/editions/tw5.com/operator-macros \define .operator-examples(op,text:"Examples") <$link to="$op$ Operator (Examples)">$text$$link> @@ -48,3 +48,5 @@ tags: $:/tags/Macro <$macrocall $name=".note" _="This operator is <<.em not>> available when ~TiddlyWiki is running in a web browser."/> \end + +
<$view field="text"/>\ No newline at end of file diff --git a/editions/tw5.com/tiddlers/system/style-guide-macros.tid b/editions/tw5.com/tiddlers/system/style-guide-macros.tid index 3b505f2ab..abe0750e0 100644 --- a/editions/tw5.com/tiddlers/system/style-guide-macros.tid +++ b/editions/tw5.com/tiddlers/system/style-guide-macros.tid @@ -1,5 +1,7 @@ -title: $:/editions/tw5.com/style-guide-macros +created: 20220227210120989 +modified: 20220227210123695 tags: $:/tags/Macro +title: $:/editions/tw5.com/style-guide-macros \define style-guide(good,bad)
<$view field="text"/>\ No newline at end of file diff --git a/editions/tw5.com/tiddlers/system/variable-macros.tid b/editions/tw5.com/tiddlers/system/variable-macros.tid index aac443017..313f065af 100644 --- a/editions/tw5.com/tiddlers/system/variable-macros.tid +++ b/editions/tw5.com/tiddlers/system/variable-macros.tid @@ -1,7 +1,7 @@ created: 20150228114241000 -modified: 20150228141312000 -title: $:/editions/tw5.com/variable-macros +modified: 20220227210136243 tags: $:/tags/Macro +title: $:/editions/tw5.com/variable-macros \define .variable-examples(v,text:"Examples") <$link to="$v$ Variable (Examples)">$text$$link> \define .macro-examples(m,text:"Examples") <$link to="$m$ Macro (Examples)">$text$$link> @@ -17,3 +17,5 @@ It can be set to <<.value yes>> or <<.value no>> prior to transcluding such a bu The standard page template sets it to the value found in [[$configTiddler$]], with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the <<.controlpanel-tab Settings>> tab of the [[Control Panel|$:/ControlPanel]]. \end + +
<$view field="text"/>\ No newline at end of file diff --git a/editions/tw5.com/tiddlers/system/wikitext-macros.tid b/editions/tw5.com/tiddlers/system/wikitext-macros.tid index 908b8f473..cb5f81bf1 100644 --- a/editions/tw5.com/tiddlers/system/wikitext-macros.tid +++ b/editions/tw5.com/tiddlers/system/wikitext-macros.tid @@ -1,5 +1,5 @@ created: 20150117184156000 -modified: 20220122143551571 +modified: 20220227210152153 tags: $:/tags/Macro title: $:/editions/tw5.com/wikitext-macros type: text/vnd.tiddlywiki @@ -63,4 +63,6 @@ $$$ [[$tiddler$]]: <
<$view field="text"/>\ No newline at end of file From 71df5162ba87163dd8d7b46e7dfd5b973775ff85 Mon Sep 17 00:00:00 2001 From: TW Videos <11172651+TiddlyVee@users.noreply.github.com> Date: Wed, 2 Mar 2022 18:40:23 +0100 Subject: [PATCH 02/19] Improve the docs for the sortan operator (#6495) --- editions/tw5.com/tiddlers/demonstrations/Apple.tid | 7 ++++++- editions/tw5.com/tiddlers/filters/examples/sortan.tid | 6 +++++- 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/editions/tw5.com/tiddlers/demonstrations/Apple.tid b/editions/tw5.com/tiddlers/demonstrations/Apple.tid index b5f86997d..0fb74a853 100644 --- a/editions/tw5.com/tiddlers/demonstrations/Apple.tid +++ b/editions/tw5.com/tiddlers/demonstrations/Apple.tid @@ -1,6 +1,11 @@ created: 20180222072026299 list: [[Apple 6]] [[Apple 7]] [[Apple 8]] [[Apple 9]] [[Apple 10]] [[Apple 20]] [[Apple 30]] [[Apple 100]] -modified: 20211115005421558 +modified: 20220227210835979 tags: Demonstrations title: Apple +<<.this-is-operator-example>> + +It has a <<.field list>> field containing the following items: + +<
$_$
-\define .word(_) "$_$"
-
-\define .preamble(_) :.doc-preamble $_$
-\define .note(_)
-@@.doc-note
-;Note
-: $_$
-@@
-\end
-
-\define .tid(_) $_$
-\define .tag(_) $_$
-\define .field(_) $_$
-\define .value(_) $_$
-\define .op(_) $_$
-\define .var(_) $_$
-\define .wid(_) $$_$
-\define .attr(_) $_$
-\define .param(_) $_$
-
-\define .mtitle(_) $_$ Macro
-\define .otitle(_) $_$ Operator
-\define .vtitle(_) $_$ Variable
-
-\define .link(_,to) <$link to="$to$">$_$$link>
-\define .clink(_,to) <<.link """$_$""" "$to$">>
-\define .dlink(_,to) <$macrocall $name=".link" _=<<.def "$_$">> to="$to$">/>
-\define .dlink-ex(_,to) <<.def "$_$">>
-\define .flink(to) <$macrocall $name=".link" _=<<.field {{$to$!!caption}}>> to="$to$"/>
-\define .mlink(_,to) <$macrocall $name=".link" _=<<.var "$_$">> to=<<.mtitle "$_$">>/>
-\define .mlink2(_,to) <$macrocall $name=".link" _=<<.var "$_$">> to="$to$"/>
-\define .olink(_) <$macrocall $name=".link" _=<<.op "$_$">> to=<<.otitle "$_$">>/>
-\define .olink2(_,to) <$macrocall $name=".link" _=<<.op "$_$">> to=<<.otitle "$to$">>/>
-\define .vlink(_,to) <$macrocall $name=".link" _=<<.var "$_$">> to=<<.vtitle "$_$">>/>
-\define .vlink2(_,to) <$macrocall $name=".link" _=<<.var "$_$">> to="$to$"/>
-\define .wlink(to) <$macrocall $name=".link" _=<<.wid {{$to$!!caption}}>> to="$to$"/>
-\define .wlink2(_,to) <$macrocall $name=".link" _="$_$" to="$to$"/>
-
-\define .key(_) $_$
-\define .combokey(_) <$macrocall $name=".if" cond="$_$" then=<<.key '$_$'>>/>
-\define .keycombo(1,2,3,4) <<.combokey "$1$">><<.if "$2$" +>><<.combokey "$2$">><<.if "$3$" +>><<.combokey "$3$">><<.if "$4$" +>><<.combokey "$4$">>
-
-\define .tab(_) {{$_$!!caption}}
-\define .sidebar-tab(_) <<.tab "$:/core/ui/SideBar/$_$">>
-\define .more-tab(_) <<.tab "$:/core/ui/MoreSideBar/$_$">>
-\define .info-tab(_) <<.tab "$:/core/ui/TiddlerInfo/$_$">>
-\define .controlpanel-tab(_) <<.tab "$:/core/ui/ControlPanel/$_$">>
-\define .advancedsearch-tab(_) <<.tab "$:/core/ui/AdvancedSearch/$_$">>
-\define .toc-tab() <<.tab "TableOfContents">>
-\define .example-tab(_) $_$
-
-\define .button(_)
-
-\define .icon(_)
-
-\define .tip(_)
-\define .warning(_)
-
-\define .state-prefix() $:/state/editions/tw5.com/
-
-\define .lorem()
-Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
-\end
-
-\define .toc-lorem()
-C'est un exemple de tiddler. Voir [[Macros Table des matières (Exemples)|Table-of-Contents Macros (Examples)]].
-
-<<.lorem>>
-\end
-
-\define .example(n,eg,egvar:NO-SUCH-VAR)
-- <$reveal default="$egvar$" type="match" text="NO-SUCH-VAR"> - $eg$ - $reveal> - <$reveal default="$egvar$" type="nomatch" text="NO-SUCH-VAR"> - <<$egvar$>> - $reveal> --$reveal> -$list> -\end - -\define .bad-example(eg) -
⚠ Warning: Don't do it this way! |
-- -$eg$ - | -
<$view field="text"/>\ No newline at end of file diff --git a/editions/fr-FR/tiddlers/$__editions_tw5.com_doc-macros.tid b/editions/fr-FR/tiddlers/$__editions_tw5.com_doc-macros.tid index b613f2eb4..226d0e4d7 100644 --- a/editions/fr-FR/tiddlers/$__editions_tw5.com_doc-macros.tid +++ b/editions/fr-FR/tiddlers/$__editions_tw5.com_doc-macros.tid @@ -1,5 +1,5 @@ created: 20150117152607000 -modified: 20150620212025034 +modified: 20220220000852855 tags: $:/tags/Macro title: $:/editions/tw5.com/doc-macros type: text/vnd.tiddlywiki @@ -37,7 +37,7 @@ type: text/vnd.tiddlywiki \define .link(_,to) <$link to="$to$">$_$$link> \define .clink(_,to) <<.link """$_$""" "$to$">> \define .dlink(_,to) <$macrocall $name=".link" _=<<.def "$_$">> to="$to$">/> -\define .dlink-ex(_,to) <<.def "$_$">> +\define .dlink-ex(_,to) <<.def "$_$">> \define .flink(to) <$macrocall $name=".link" _=<<.field {{$to$!!caption}}>> to="$to$"/> \define .mlink(_,to) <$macrocall $name=".link" _=<<.var "$_$">> to=<<.mtitle "$_$">>/> \define .mlink2(_,to) <$macrocall $name=".link" _=<<.var "$_$">> to="$to$"/> @@ -63,6 +63,8 @@ type: text/vnd.tiddlywiki \define .button(_) +\define .icon(_) + \define .tip(_) \define .warning(_) @@ -81,10 +83,12 @@ C'est un exemple de tiddler. Voir [[Macros Table des matières (Exemples)|Table- \define .example(n,eg,egvar:NO-SUCH-VAR)
⚠ Warning: Don't do it this way! |
++ +$eg$ + | +
<$view field="text"/>\ No newline at end of file diff --git a/editions/fr-FR/tiddlers/Block_Quotes_in_WikiText.tid b/editions/fr-FR/tiddlers/Block_Quotes_in_WikiText.tid index 14b8351f8..5727fb51a 100644 --- a/editions/fr-FR/tiddlers/Block_Quotes_in_WikiText.tid +++ b/editions/fr-FR/tiddlers/Block_Quotes_in_WikiText.tid @@ -1,11 +1,11 @@ created: 20131206154636572 fr-title: Citations en bloc dans WikiText -modified: 20150624090734021 +modified: 20220226225218713 tags: WikiText title: Block Quotes in WikiText type: text/vnd.tiddlywiki -Il existe deux manières de produire des éléments HTML de type citation en bloc avec <
```
(connus en anglais sous le nom de <+``` +Ce texte aura une chasse fixe et ne sera pas `formaté`. +``` ++ +Donnera le résultat suivant<<:>> + +``` +Ce texte aura une chasse fixe et ne sera pas `formaté`. +``` + +Pour être interprétés correctement, les trois accents graves doivent être placés au début d'une ligne et immédiatement suivis d'un retour à la ligne. + +Souvenez-vous que le paragraphe précédent doit s'être terminé correctement, à l'aide de deux retours à la ligne. L'exemple suivant est donc ''faux''<<:>> + +
+Ceci est un paragraphe ordinaire. +``` +Ce texte aura une chasse fixe et ne sera pas `formaté`. +``` ++ +La version correcte est<<:>>
Ceci est un paragraphe ordinaire. @@ -16,18 +41,4 @@ Ce texte aura une chasse fixe et ne sera pas `formaté`. ```- - -; Remarques -* Pour être interprétés correctements, les trois backticks doivent être : -** précédés de deux retours à la ligne (pour terminer correctement le paragraphe précédent) ; -** au début de la ligne ; -** immédiatement suivis d'un retour à la ligne. -* 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
`
suivis d'un espace. Une autre méthode consiste à taper 6 `
d'affilée, puis de bouger le curseur en arrière trois fois pour taper ou coller le contenu du bloc.
+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 `
suivis d'un espace. Une autre méthode consiste à taper 6 `
d'affilée, puis de bouger le curseur en arrière trois fois pour taper ou coller le contenu du bloc.
diff --git a/editions/fr-FR/tiddlers/Creating and editing tiddlers.tid b/editions/fr-FR/tiddlers/Creating and editing tiddlers.tid
index 243fceb77..62d894ec3 100644
--- a/editions/fr-FR/tiddlers/Creating and editing tiddlers.tid
+++ b/editions/fr-FR/tiddlers/Creating and editing tiddlers.tid
@@ -1,13 +1,13 @@
created: 20140904140300000
fr-title: Créer et modifier des tiddlers
-modified: 20150620081426868
+modified: 20220221002250215
tags: [[Working with TiddlyWiki]]
title: Creating and editing tiddlers
type: text/vnd.tiddlywiki
! Créer des tiddlers
-Vous créez un tiddler soit en cliquant sur le bouton {{$:/core/images/new-button}} du menu latéral, soit en cliquant sur un lien vers un tiddler absent. Les liens vers les tiddlers absents sont affichés en [[italique bleu]].
+Vous créez un tiddler soit en cliquant sur le bouton <<.icon $:/core/images/new-button>> du menu latéral, soit en cliquant sur un lien vers un tiddler absent. Les liens vers les tiddlers absents sont affichés en [[italique bleu]].
Voir aussi<<:>>
@@ -15,23 +15,23 @@ Voir aussi<<:>>
! Modifier des tiddlers
-Pour modifier un tiddler existant, cliquez sur le bouton {{$:/core/images/edit-button}} en haut et à droit du tiddler.
+Pour modifier un tiddler existant, cliquez sur le bouton <<.icon $:/core/images/edit-button>> en haut et à droite du tiddler.
!! Mode ébauche
-Quand vous créez un nouveau tiddler ou modifiez un existant, le tiddler passe en mode ébauche. Ce qui propose un panneau de contrôle pour apporter différents types de modifications. Il a plusieurs parties, de bas en haut<<:>>
+Quand vous créez un nouveau tiddler ou modifiez un existant, le tiddler passe en mode ébauche. Ce mode propose un panneau de contrôle pour apporter différents types de modifications. Il a plusieurs parties, de bas en haut<<:>>
*''Le champ titre'' - pour modifier le titre du tiddler
-*''Le sélecteur de tags'' - pour ajouter ou supprimer des tags. Lors de la saisie d'un tag, une liste déroulante affiche les tags correspondant sous forme de complétions. Vous pouvez choisir dans cette liste ou créer un tag entièrement nouveau. Puis cliquez sur le bouton ''ajouter'' pour ajouter le tag au tiddler. Chaque tag est affiché sous forme d'une pilule colorée. Cliquez le "×" d'un pilule pour supprimer le tag
-*''La zone de texte'' - pour modifier le contenu principal du tiddler. Cliquez sur le bouton ''afficher la prévisualiation'' pour visualiser l'apparence des modifications
-*''Le sélecteur de type'' - pour afficher vos tiddlers dans un format spécial, comme une image. Voir ContentType pour la liste des options. Le choix par défaut est `text/vnd.tiddlywiki`, qui indique que le tiddler contient du [[WikiTexte|WikiText]]
-*''Le sélecteur de champ'' - pour ajouter ou supprimer des champs du tiddler. Par exemple, si vous modifiez un tiddler utilisé comme tag par d'autres tiddlers, vous pouvez ajouter un [[champ ''list''|ListField]] pour modifier l'ordre dans lequel ces tiddlers seront listé
+*''Le sélecteur de tags'' - pour ajouter ou supprimer des tags. Lors de la saisie d'un tag, une liste déroulante affiche les tags correspondant sous forme de complétions. Vous pouvez choisir dans cette liste ou créer un tag entièrement nouveau. Puis cliquez sur le bouton ''ajouter'' ou utilisez la touche Entrée pour ajouter le tag au tiddler. Chaque tag est affiché sous forme d'une pilule colorée. Cliquez le "×" d'une pilule pour supprimer le tag
+*''La zone de texte'' - pour modifier le contenu principal du tiddler. Cliquez sur le bouton ''afficher la prévisualiation'' (<<.icon $:/core/images/preview-closed>> / <<.icon $:/core/images/preview-open>>) pour visualiser l'apparence des modifications
+*''Le sélecteur de type'' - pour afficher vos tiddlers dans un format spécial, comme une image. Voir ContentType pour la liste des options. Le choix par défaut est `text/vnd.tiddlywiki`, qui indique que le tiddler contient du <`code`
``code contenant du `code` ``
|`code``code`
``code contenant du `code` ``
|`code``
et les ``
est nécessaire.
+: Si le code inclus est à la fin du code contenant, l'espace entre le `
et les ``
est nécessaire.
diff --git a/editions/fr-FR/tiddlers/GettingStarted.tid b/editions/fr-FR/tiddlers/GettingStarted.tid
index 9fbd71706..b9e327d8f 100644
--- a/editions/fr-FR/tiddlers/GettingStarted.tid
+++ b/editions/fr-FR/tiddlers/GettingStarted.tid
@@ -1,30 +1,32 @@
created: 20131129090249275
fr-title: La mise en route
-modified: 20160526131021571
+modified: 20220217175123712
tags: [[Working with TiddlyWiki]]
title: GettingStarted
type: text/vnd.tiddlywiki
-\define default-platform()
-GettingStarted - $(browser-name)$
-\end
-Instructions pour bien commencer avec <