TiddlyWiki5/editions/tw5.com/tiddlers/concepts/TemplateTiddlers.tid

created: 20140107114355828
modified: 20150220160920000
tags: Concepts
title: TemplateTiddlers
type: text/vnd.tiddlywiki

A template tiddler is not actually a type of tiddler, it is a role in which a tiddler can be used.

Templates are a way to re-use chunks of WikiText.

Transcluding through a template extends the basic functionality of [[Transclusion]] by combining two tiddlers:

* A template tiddler that contains the WikiText to be displayed. It can contain transclusions that reference fields in the [[current tiddler|Current Tiddler]]
* A target tiddler that identifies which tiddler is to be treated as current when resolving references to fields

The best example of templating is the main story river in TiddlyWiki. Each tiddler in the story river is rendered through a ViewTemplate that specifies how each field is to be rendered.

See [[Transclusion with Templates]] for details.
Docs updates 2014-01-07 11:57:42 +00:00			`created: 20140107114355828`
Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`modified: 20150220160920000`
More reference docs mangling 2014-09-11 14:52:47 +00:00			`tags: Concepts`
Docs updates 2014-01-07 11:57:42 +00:00			`title: TemplateTiddlers`
			`type: text/vnd.tiddlywiki`

Documentation tweaks @erwanm I ended up making some fairly extensive tweaks. One issue is that the (excellent) material you’ve provided on transclusion with templates covers very much the same ground as the existing TemplateTiddlers tiddler. The existing text was focused on transclusion with widgets; I think your material using transclusion notation is much easier to understand. I’ve also removed the exercises section. We don’t have exercises elsewhere in the documentation, so I think we need to make a conscious decision about whether we’re going to try to add them, and then do so consistently across the material. I also made some changes to bring the text into house style for consistency (which I’ve also tried to start documenting). 2014-12-10 17:08:59 +00:00			`A template tiddler is not actually a type of tiddler, it is a role in which a tiddler can be used.`
Docs updates 2014-01-07 11:57:42 +00:00
Documentation tweaks @erwanm I ended up making some fairly extensive tweaks. One issue is that the (excellent) material you’ve provided on transclusion with templates covers very much the same ground as the existing TemplateTiddlers tiddler. The existing text was focused on transclusion with widgets; I think your material using transclusion notation is much easier to understand. I’ve also removed the exercises section. We don’t have exercises elsewhere in the documentation, so I think we need to make a conscious decision about whether we’re going to try to add them, and then do so consistently across the material. I also made some changes to bring the text into house style for consistency (which I’ve also tried to start documenting). 2014-12-10 17:08:59 +00:00			`Templates are a way to re-use chunks of WikiText.`
Docs updates 2014-01-07 11:57:42 +00:00
Documentation tweaks @erwanm I ended up making some fairly extensive tweaks. One issue is that the (excellent) material you’ve provided on transclusion with templates covers very much the same ground as the existing TemplateTiddlers tiddler. The existing text was focused on transclusion with widgets; I think your material using transclusion notation is much easier to understand. I’ve also removed the exercises section. We don’t have exercises elsewhere in the documentation, so I think we need to make a conscious decision about whether we’re going to try to add them, and then do so consistently across the material. I also made some changes to bring the text into house style for consistency (which I’ve also tried to start documenting). 2014-12-10 17:08:59 +00:00			`Transcluding through a template extends the basic functionality of [[Transclusion]] by combining two tiddlers:`
Docs updates 2014-01-07 11:57:42 +00:00
Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`* A template tiddler that contains the WikiText to be displayed. It can contain transclusions that reference fields in the [[current tiddler\|Current Tiddler]]`
			`* A target tiddler that identifies which tiddler is to be treated as current when resolving references to fields`
Docs updates 2014-01-07 11:57:42 +00:00
Documentation tweaks @erwanm I ended up making some fairly extensive tweaks. One issue is that the (excellent) material you’ve provided on transclusion with templates covers very much the same ground as the existing TemplateTiddlers tiddler. The existing text was focused on transclusion with widgets; I think your material using transclusion notation is much easier to understand. I’ve also removed the exercises section. We don’t have exercises elsewhere in the documentation, so I think we need to make a conscious decision about whether we’re going to try to add them, and then do so consistently across the material. I also made some changes to bring the text into house style for consistency (which I’ve also tried to start documenting). 2014-12-10 17:08:59 +00:00			`The best example of templating is the main story river in TiddlyWiki. Each tiddler in the story river is rendered through a ViewTemplate that specifies how each field is to be rendered.`
Docs updates 2014-01-07 11:57:42 +00:00
Documentation tweaks @erwanm I ended up making some fairly extensive tweaks. One issue is that the (excellent) material you’ve provided on transclusion with templates covers very much the same ground as the existing TemplateTiddlers tiddler. The existing text was focused on transclusion with widgets; I think your material using transclusion notation is much easier to understand. I’ve also removed the exercises section. We don’t have exercises elsewhere in the documentation, so I think we need to make a conscious decision about whether we’re going to try to add them, and then do so consistently across the material. I also made some changes to bring the text into house style for consistency (which I’ve also tried to start documenting). 2014-12-10 17:08:59 +00:00			`See [[Transclusion with Templates]] for details.`