1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-06-16 10:29:54 +00:00

Docs: Clarify widgets generated by wikitext transclusion

This commit is contained in:
Jermolene 2014-12-30 09:09:40 +00:00
parent cb8caf6a01
commit 21df296c2f

View File

@ -1,9 +1,11 @@
caption: Transclusion
created: 20131205160146648
modified: 20140317214256948
modified: 20141230090901681
tags: WikiText
title: Transclusion in WikiText
type: text/vnd.tiddlywiki
caption: Transclusion
! Introduction
You can incorporate the content of one tiddler within another using the [[Transclusion]] notation:
@ -11,6 +13,8 @@ You can incorporate the content of one tiddler within another using the [[Transc
* `{{MyTiddler||TemplateTitle}}` displays the tiddler through a specified [[TemplateTiddler|TemplateTiddlers]]
* `{{||TemplateTitle}}` displays the specified template tiddler without altering the CurrentTiddler
!! Transcluding Text References
You can also use a TextReference instead of a tiddler title:
* `{{MyTiddler!!field}}` transcludes a specified field of a tiddler
@ -18,6 +22,8 @@ You can also use a TextReference instead of a tiddler title:
* `{{MyTiddler##index}}` transcludes a specified indexed property of a [[DataTiddler|DataTiddlers]]
* `{{##index}}` transcludes a specified indexed property of the current [[DataTiddler|DataTiddlers]]
!! Filtered Transclusion
A similar syntax can be used to transclude a list of tiddlers matching a specified [[filter|Filters]]:
```
@ -25,6 +31,16 @@ A similar syntax can be used to transclude a list of tiddlers matching a specifi
{{{ [tag[mechanism]] ||TemplateTitle}}}
```
! Generated Widgets
The WikiText transclusion syntax generates a TiddlerWidget wrapped around a TranscludeWidget. For example, `{{MyTiddler||MyTemplate!!myField}}` generates the following pair of widgets:
```
<$tiddler tiddler="MyTiddler">
<$transclude tiddler="MyTemplate" field="myField"/>
</$tiddler>
```
See also:
* [[Transclusion Basic Usage]]