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

created: 20140209143652456
tags: deserializers dev
title: MultiTiddlerFiles

MultiTiddlerFiles allow multiple tiddlers to be concisely represented in a single text file.

The goals of this format are:

* To be easy to type and easy to read
* Optimised for single line strings
* To allow common fields or tags to be shared within groups of tiddlers
* To be simple to process with external tools

MultiTiddlerFiles have the extension `tids`. The file is structured as a block of shared fields followed by a blank line. The rest of the file is a sequence of comments and tiddlers. Tiddlers are specified by their title, followed by a colon, at least one space character, and then the rest of the line is the text field for the tiddler.

For axample:

```
title: $:/language/ControlPanel/
tags: strings
modifier: JoeBloggs

Basics/Caption: Basics
# This is a comment
Basics/Version: ~TiddlyWiki Version
```

This example defines two tiddlers, [[$:/language/ControlPanel/Basics/Caption]] and [[$:/language/ControlPanel/Basics/Version]].

If a `title` field is specified in the header then it is treated as a prefix for the individual tiddlers defined in the title.
Add support for multi-tiddler files with a .tids extension 2014-02-09 20:34:42 +00:00			`created: 20140209143652456`
			`tags: deserializers dev`
			`title: MultiTiddlerFiles`

			`MultiTiddlerFiles allow multiple tiddlers to be concisely represented in a single text file.`

			`The goals of this format are:`

			`* To be easy to type and easy to read`
			`* Optimised for single line strings`
			`* To allow common fields or tags to be shared within groups of tiddlers`
			`* To be simple to process with external tools`

			MultiTiddlerFiles have the extension `tids`. The file is structured as a block of shared fields followed by a blank line. The rest of the file is a sequence of comments and tiddlers. Tiddlers are specified by their title, followed by a colon, at least one space character, and then the rest of the line is the text field for the tiddler.

			`For axample:`

			```
Reduce the inconsistent use of "language" vs. "lingo" Now we’re just using the word “lingo” for the macro defined in PageTemplate (where the abbreviation is useful), and using the full word “language” everywhere else. It’s possible that we should be using “locale” instead of “language”, what do you think? 2014-02-15 11:32:11 +00:00			`title: $:/language/ControlPanel/`
Add support for multi-tiddler files with a .tids extension 2014-02-09 20:34:42 +00:00			`tags: strings`
			`modifier: JoeBloggs`

			`Basics/Caption: Basics`
			`# This is a comment`
			`Basics/Version: ~TiddlyWiki Version`
			```

Documentation for translators I’d appreciate help with putting together more complete and foolproof instructions. 2014-02-17 22:46:30 +00:00			`This example defines two tiddlers, [[$:/language/ControlPanel/Basics/Caption]] and [[$:/language/ControlPanel/Basics/Version]].`
Add support for multi-tiddler files with a .tids extension 2014-02-09 20:34:42 +00:00
			If a `title` field is specified in the header then it is treated as a prefix for the individual tiddlers defined in the title.