TiddlyWiki5/editions/tw5.com/tiddlers/wikitext/Transclusion in WikiText.tid

created: 20131205160146648
modified: 20140317214256948
tags: WikiText
title: Transclusion in WikiText
type: text/vnd.tiddlywiki
caption: Transclusion

You can incorporate the content of one tiddler within another using the [[Transclusion]] notation:

* `{{MyTiddler}}` transcludes a single tiddler
* `{{MyTiddler||TemplateTitle}}` displays the tiddler through a specified [[TemplateTiddler|TemplateTiddlers]]
* `{{||TemplateTitle}}` displays the specified template tiddler without altering the CurrentTiddler

You can also use a TextReference instead of a tiddler title:

* `{{MyTiddler!!field}}` transcludes a specified field of a tiddler
* `{{!!field}}` transcludes a specified field of the current tiddler
* `{{MyTiddler##index}}` transcludes a specified indexed property of a [[DataTiddler|DataTiddlers]]
* `{{##index}}` transcludes a specified indexed property of the current [[DataTiddler|DataTiddlers]]

A similar syntax can be used to transclude a list of tiddlers matching a specified [[filter|Filters]]:

```
{{{ [tag[mechanism]] }}}
{{{ [tag[mechanism]] ||TemplateTitle}}}
```

See also:

* [[Transclusion Basic Usage]]
* [[Transclusion with Templates]]
* TemplateTiddlers
* TranscludeWidget
* [[Confusion between Transclusion and Substitution]]
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00			`created: 20131205160146648`
Update transclusion wikitext syntax to allow a template without a target tiddler This allows us to transclude a tiddler without changing the current tiddler with `{{\|\|MyTiddler}}`. 2014-03-17 21:44:10 +00:00			`modified: 20140317214256948`
Update wikitext documentation 2014-09-11 08:15:58 +00:00			`tags: WikiText`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00			`title: Transclusion in WikiText`
			`type: text/vnd.tiddlywiki`
Update wikitext documentation 2014-09-11 08:15:58 +00:00			`caption: Transclusion`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +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			`You can incorporate the content of one tiddler within another using the [[Transclusion]] notation:`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00
			* `{{MyTiddler}}` transcludes a single tiddler
Docs updates 2014-01-07 11:57:42 +00:00			* `{{MyTiddler\|\|TemplateTitle}}` displays the tiddler through a specified [[TemplateTiddler\|TemplateTiddlers]]
Fix bad links 2014-10-10 20:06:48 +00:00			* `{{\|\|TemplateTitle}}` displays the specified template tiddler without altering the CurrentTiddler
Update transclusion wikitext syntax to allow a template without a target tiddler This allows us to transclude a tiddler without changing the current tiddler with `{{\|\|MyTiddler}}`. 2014-03-17 21:44:10 +00:00
			`You can also use a TextReference instead of a tiddler title:`

			* `{{MyTiddler!!field}}` transcludes a specified field of a tiddler
			* `{{!!field}}` transcludes a specified field of the current tiddler
			* `{{MyTiddler##index}}` transcludes a specified indexed property of a [[DataTiddler\|DataTiddlers]]
			* `{{##index}}` transcludes a specified indexed property of the current [[DataTiddler\|DataTiddlers]]
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00
Update filter docs 2014-09-10 22:42:13 +00:00			`A similar syntax can be used to transclude a list of tiddlers matching a specified [[filter\|Filters]]:`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00
			```
			`{{{ [tag[mechanism]] }}}`
			`{{{ [tag[mechanism]] \|\|TemplateTitle}}}`
			```
Docs updates 2014-10-20 15:12:24 +00:00
			`See also:`

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			`* [[Transclusion Basic Usage]]`
			`* [[Transclusion with Templates]]`
			`* TemplateTiddlers`
			`* TranscludeWidget`
Docs updates 2014-10-20 15:12:24 +00:00			`* [[Confusion between Transclusion and Substitution]]`