TiddlyWiki5/editions/tw5.com/tiddlers/deserializers/TiddlerFiles.tid

title: TiddlerFiles
modifier: JeremyRuston
tags: internals

Tiddlers can be stored in text files in several different formats. Files containing single tiddlers can also have an auxiliary `.meta` file formatted as a sequence of name:value pairs:

```
title: TheTitle
modifier: someone
```

!! ~TiddlyWeb-style .tid files

These files consist of a sequence of lines containing name:value pairs, a blank line and then the text of the tiddler. For example:

```
title: MyTiddler
modifier: Jeremy

This is the text of my tiddler.
```

//The ContentType `application/x-tiddler` is used internally for these files//

!! TiddlyWiki `<DIV>` .tiddler files

Modern `*.tiddler` files look like this:

```
<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">
<pre>Note that there is an embedded <pre> tag, and line feeds are not escaped.
	
And, weirdly, there is no HTML encoding of the body.</pre>
</div>
```

These `*.tiddler` files are therefore not quite the same as the tiddlers found inside a TiddlyWiki HTML file, where the body is HTML encoded in the expected way.

Older `*.tiddler` files more closely matched the store format used by TiddlyWiki at the time:

```
<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">This is an old-school .tiddler file, without an embedded &lt;pre&gt; tag.\nNote how the body is &quot;HTML encoded&quot; and new lines are escaped to \\n</div>
```

//The ContentType `application/x-tiddler-html-div` is used internally for these files//

!! ~TiddlyWeb-style JSON files

These files are a straightforward array of hashmaps of name:value fields. Currently only these known fields are processed: `title`, `text`, `created`, `creator`, `modified`, `modifier`, `type` and `tags`.

//The ContentType `application/json` is used internally for these files//

!! TiddlyWiki HTML files

TiddlyWiki HTML files contain a collection of tiddlers encoded in `<DIV>` format.
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`title: TiddlerFiles`
			`modifier: JeremyRuston`
Docs updates 2012-05-20 17:47:11 +00:00			`tags: internals`
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00
			Tiddlers can be stored in text files in several different formats. Files containing single tiddlers can also have an auxiliary `.meta` file formatted as a sequence of name:value pairs:
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Formatting update 2013-03-04 18:04:26 +00:00			```
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`title: TheTitle`
			`modifier: someone`
Formatting update 2013-03-04 18:04:26 +00:00			```
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`!! ~TiddlyWeb-style .tid files`

			`These files consist of a sequence of lines containing name:value pairs, a blank line and then the text of the tiddler. For example:`
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Formatting update 2013-03-04 18:04:26 +00:00			```
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`title: MyTiddler`
			`modifier: Jeremy`

			`This is the text of my tiddler.`
Formatting update 2013-03-04 18:04:26 +00:00			```
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
More docs updating 2012-06-10 16:48:23 +00:00			//The ContentType `application/x-tiddler` is used internally for these files//
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			!! TiddlyWiki `<DIV>` .tiddler files

			Modern `*.tiddler` files look like this:
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Formatting update 2013-03-04 18:04:26 +00:00			```
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">`
			`<pre>Note that there is an embedded <pre> tag, and line feeds are not escaped.`

			`And, weirdly, there is no HTML encoding of the body.</pre>`
			`</div>`
Formatting update 2013-03-04 18:04:26 +00:00			```
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			These `*.tiddler` files are therefore not quite the same as the tiddlers found inside a TiddlyWiki HTML file, where the body is HTML encoded in the expected way.

			Older `*.tiddler` files more closely matched the store format used by TiddlyWiki at the time:
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Formatting update 2013-03-04 18:04:26 +00:00			```
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">This is an old-school .tiddler file, without an embedded <pre> tag.\nNote how the body is "HTML encoded" and new lines are escaped to \\n</div>`
Formatting update 2013-03-04 18:04:26 +00:00			```
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
More docs updating 2012-06-10 16:48:23 +00:00			//The ContentType `application/x-tiddler-html-div` is used internally for these files//
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`!! ~TiddlyWeb-style JSON files`

			These files are a straightforward array of hashmaps of name:value fields. Currently only these known fields are processed: `title`, `text`, `created`, `creator`, `modified`, `modifier`, `type` and `tags`.

More docs updating 2012-06-10 16:48:23 +00:00			//The ContentType `application/json` is used internally for these files//
Fixed docs to work with new wikitext parser Which turns out to be entirely a matter of inserting additional blank lines, which has the beneficial effect of making the wikitext a lot more readable 2012-06-04 11:25:54 +00:00
Introduce plugin module mechanism See the readme for details 2012-04-30 11:23:03 +00:00			`!! TiddlyWiki HTML files`

			TiddlyWiki HTML files contain a collection of tiddlers encoded in `<DIV>` format.