This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

TiddlerFiles

19 octobre 2014 à 10h14

Les tiddlers peuvent être conservés dans des fichiers texte dans plusieurs formats différents. Les fichiers contenant un seul tiddler peuvent aussi avoir un fichier .meta auxiliaire formaté comme une suite de paires nom:valeur :

title: LeTitre

Fichiers .tid à la TiddlyWeb

Ces fichiers consistent en une séquence de paires nom:valeur, suivie d'une ligne blanche, puis du texte du tiddler. Par exemple :

title: MonTiddler

Voici le texte de mon tiddler.

Notez que de nombreux éditeurs de texte imposent que les fichiers se terminent par un caractère de « nouvelle ligne ». Si vous voulez éviter qu'une ligne soit ajoutée à la fin de votre texte, vous pouvez utiliser cette autre syntaxe :

title: MonTiddler
text: Voici le texte de mon tiddler.

Le ContentType application/x-tiddler est utilisé en interne pour ces fichiers

Fichiers <DIV> avec l'extension .tiddler

Les fichiers *.tiddler modernes ressemblent à ça :

<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">
<pre>Notez qu'il y a une balise <pre> embarquée, et que les retours à la ligne ne sont pas échappés.

Et bizarrement, aucun codage HTML dans le corps du tiddler.</pre>
</div>

Ces fichiers *.tiddler ne sont donc pas vraiment similaires aux tiddlers trouvés à l'intérieur d'un fichier HTML TiddlyWiki, dans lequel le corps du texte est encodé en HTML comme attendu.

Les anciens fichiers *.tiddler étaient plus proches du format de stockage utilisé par TiddlyWiki à l'époque :

<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">Voici un fichier tiddler à l'ancienne, sans balise &lt;pre&gt; embarquée. \nVoyez comme le corps du tiddler est &quot;codé en HTML&quot; et les sauts de ligne échappés par \\n</div>

Le ContentType application/x-tiddler-html-div est utilisé en interne pour ces fichiers

Fichiers JSON de type TiddlyWeb

Ces fichiers sont des tableaux de hachages sans fioritures contenant des champs sous la forme name:value. À présent seuls ces champs standards sont traités : title, text, created, creator, modified, modifier, type et tags.

Le ContentType application/json est utilisé en interne pour ces fichiers

Fichiers TiddlyWiki HTML

Les fichiers TiddlyWiki HTML contiennent une collection de tiddlers encodés au format <DIV>.

Pour qu'un fichier HTML soit importable comme un fichier TW non crypté, il faut au minimum qu'il contienne un <div id="storeArea"> juste avant les DIVs des tiddlers, eux-mêmes suivis immédiatement par un </div>. Par exemple :

<div id="storeArea">
<div created="20130302085406905" modified="20130302084548184" tags="Exemples" title="Un titre de tiddler">
<pre>Texte d'un tiddler encodé en HTML
</pre>
</div>
<div created="20140315085406905" modified="20140321084548184" tags="Un Deux [[Trois avec espace]]" title="Un autre titre" champperso="valeur du champ">
<pre>Texte de ce tiddler
</pre>
</div>