mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-07-07 12:34:22 +00:00
2261fd4b84
It was getting a pain to manage the content in separate places, and I suspect confusing for end users. I think the best time to move the dev content out is when we’ve established the community wiki for TW5, which is a much more natural home for it. In the meantime, a feature that I’m interested in exploring is the ability to hide tiddlers from the UI based on tag. Then the tw5.com wiki could disable all tiddlers tagged ‘dev’ until explicitly overridden by the user.
59 lines
2.1 KiB
Plaintext
59 lines
2.1 KiB
Plaintext
created: 201308251500
|
|
creator: JeremyRuston
|
|
modified: 201308251621
|
|
modifier: JeremyRuston
|
|
tags: deserializers dev
|
|
title: TiddlerFiles
|
|
|
|
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 <pre> tag.\nNote how the body is "HTML encoded" 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.
|