Plugins et configurations pour TiddlyWiki
Voici un petit résumé des différents plugins et configuration que j’ai accumulé après avoir fouiné sur le net.
Je mets un exemplaire du TiddlyWiki avec les plugins et quelques macros choisis. Vous pouvez soit le consulter en ligne, soit le télécharger, ou retrouver les évolutions sur Github si j’en fais une version ultérieure. Avec la version téléchargé, vous pouvez commencer un nouveau TiddlyWiki, ou importer les plugins
Importer les plugins
- Avec une version téléchargé, mettez votre wiki et le téléchargé dans le même répertoire, c’est important sinon ça ne fonctionnera pas.
- Cliquez sur « backstage » tout en haut à droite.
- Cliquez sur « import »
- Entrez le chemin absolu du wiki téléchargé
- cliquez sur « open »
- Choisissez les plugins à importer
- Cliquez sur « importer »
Alternativement, vous pouvez manuellement importer un plugin en copiant son
contenu dans un nouveau tiddler taggé systemConf.
Les plugins
- FrenchTranslationPlugin
Fournis les traductions des messages et texte.
- InlineJavascriptPlugin
Permet d’exécuter du code JavaScript directement dans un tiddler, vous n’en avait pas forcément besoin, sauf si vous commencez à jouer un peu avec TiddlyWiki et JavaScript.
- FullScreenPlugin
Permet de rajouter dans la barre d’outil de chaque tiddle un lien pour passer en mode plein écran, qui a pour effet d’éliminer les sidebars de droite et de gauche.
Vous devez rajouter fullscreen dans le tiddler ToolbarCommands.
- checkboxPlugin
Permet d’avoir des checkboxs avec [ ] et [x].
SiteMapMacroPlugin
Utile pour se retrouver parmi tout les tiddlers en affichant de façon hiérarchisé les tiddlers rattaché à un tag donné.
On peut créer par exemple quelque chose comme ça :
programmation>><<siteMap blog>><<siteMap linux>>|<<siteMap
systemConfig>>|
- CollapseTiddlersPlusPlugin
Permet d’avoir un replis d’un tiddler sur son titre, et ainsi n’afficher que son titre, pouvant être pratique pour organiser et naviguer dans une suite de tiddler. Il faut impérativement installer CollapsedTemplate avec.
Pour l’utiliser, vous pouvez raouter dans le ToolbarCommands les éléments
suivant:
- NestedSlidersPlugin
Permet d’avoir un replis sur une partie du tiddler, très pratique lorsque vous avez par exemple un gros morceau de code ou texte, que vous ne voulez pas afficher systématiquement dans le tiddler pour en faciliter sa lecture. Il affichera un bouton pour plier/déplier la partie de texte correspondante.
un morceau de code collé +++
long code
===
un autre morceau de code +++>
code code code
===
La différence entre les deux, c’est que le deuxième sera déplié par défaut.
- RearrangeTiddlersPlugin
Permet de réarranger à la volé les tiddlers dans son espace par glissé-déposé. Vraiment très pratique.
- YourSearchPlugin
Permet d’avoir un système de recherche plus poussé que l’original. Utile puisque l’intérêt de TiddlyWiki repose beaucoup sur la capacité à rechercher dans ses notes.
- CalendarPlugin
Permet d’affiche un calendrier en rajoutant <<calendar thismonth>> dans le MainMenu par
exemple, ou ailleurs.
- SyntaxHighlighterPlugin3
Permet d’obtenir la coloration syntaxique pour quelques langages, il faut inclure les plugins et CSS suivante:
ShThemeDefault.css ShBrushXml.js ShBrushJScript.js ShBrushPlain.js ShCore.css ShBrushCSS.js
Pour inclure les CSS il faut le rajouter dans StyleSheet de la façon
suivante :
[[ShCore.css]]
Macros
- HighlightTextMacro
C’est la macro expliqué dans le précédent billet. Je les ai regroupé dans
une macro renommé HighlightTextMacro. Il permet de mettre en valeur en colorisant un texte
sous trois degrés possible avec un effet gradient.
<<note>>My note message>>
<<warn>>My importante warning message>>
- AutoClearMessageMacro
Permet d’effacer le popup de message automatiquement au bout de 2 secondes. Pratique pour ne pas avoir de boite qui traine à chaque sauvegarde, surtout que j’active la sauvegarde automatique…
- ToggleSideBarMacro
Permet de replier la sidebar de droite, en rajoutant <<toggleSideBar>>.
Divers
- EditTemplate
Je préfère avoir la barre de saisis du tag juste en dessous de celle du titre, je trouve ça beaucoup plus pratique.
-cancelTiddler deleteTiddler'></div>
<div class='title' macro='view title'></div>
<div class='editor' macro='edit title'></div>
<div class="editLabel"> </div>
<div class='editor' macro='edit tags'></div><div class='editorFooter'><span
macro='message views.editor.tagPrompt'></span><span
macro='tagChooser'></span></div>
<div class='editor' macro='edit text'></div>
- StyleSheet
Ce que j’ai trouvé de plus important, c’est de réduire la taille du header, car
il prends beaucoup trop de place. C’est ce que fait le code suivant, placé dans StyleSheet.
.siteTitle {font-size:1.5em;}
.headerShadow {position:relative; padding:1em 0em 1em 1em; left:-1px;
top:-1px;}
.headerForeground {position:absolute; padding:1em 0em 1em 1em; left:0px;
top:0px;}
J’ai placé également le code suivant, surtout pour avoir les tiddlers dans une couleur différente que celle du fond, afin de mieux différencer chacun.
border-top: 1px solid #ccc;
border-left: 1px solid #ccc;
border-bottom: 3px solid #ccc;
border-right: 3px solid #ccc;
margin: 0.5em;
background:#fff;
padding: 0.5em;
-moz-border-radius: 0.5em;
-moz-box-shadow: 3px 3px 2px #888;
-webkit-box-shadow: 3px 3px 2px #888;
box-shadow: 3px 3px 2px #888;
}
Voici les plugins que j’ai pu glaner à gauche et à droite, pouvant donner des idées à certains ou donner une base complète à d’autre si vous choisissez de partir du TiddlyWiki modifié.
