mirrors/TiddlyWiki5
1
0
Fork 0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-06-25 06:43:15 +00:00
Code Issues Releases Wiki Activity

Docs: Clarify widgets generated by wikitext transclusion

Browse Source
This commit is contained in:
Jermolene 2014-12-30 09:09:40 +00:00
parent cb8caf6a01
commit 21df296c2f
1 changed files with 18 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
editions/tw5.com/tiddlers/wikitext/Transclusion in WikiText.tid
View File

@ -1,9 +1,11 @@
caption: Transclusion
created: 20131205160146648 created: 20131205160146648
modified: 20140317214256948 modified: 20141230090901681
tags: WikiText tags: WikiText
title: Transclusion in WikiText title: Transclusion in WikiText
type: text/vnd.tiddlywiki type: text/vnd.tiddlywiki
caption: Transclusion
! Introduction
You can incorporate the content of one tiddler within another using the [[Transclusion]] notation: 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]] * `{{MyTiddler||TemplateTitle}}` displays the tiddler through a specified [[TemplateTiddler|TemplateTiddlers]]
* `{{||TemplateTitle}}` displays the specified template tiddler without altering the CurrentTiddler * `{{||TemplateTitle}}` displays the specified template tiddler without altering the CurrentTiddler
!! Transcluding Text References
You can also use a TextReference instead of a tiddler title: You can also use a TextReference instead of a tiddler title:
* `{{MyTiddler!!field}}` transcludes a specified field of a tiddler * `{{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]] * `{{MyTiddler##index}}` transcludes a specified indexed property of a [[DataTiddler|DataTiddlers]]
* `{{##index}}` transcludes a specified indexed property of the current [[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]]: 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}}} {{{ [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: See also:
* [[Transclusion Basic Usage]] * [[Transclusion Basic Usage]]