TiddlyWiki5/editions/tw5.com/tiddlers/system/wikitext-macros.tid

code-body: yes
created: 20150117184156000
modified: 20220617122915793
tags: $:/tags/Macro
title: $:/editions/tw5.com/wikitext-macros
type: text/vnd.tiddlywiki

\define activatePluginTab()
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Plugins"/>
<$action-navigate $to="$:/ControlPanel"/>
\end

\define activateTiddlerWindow()
<$action-sendmessage $message="tm-open-window"
  $param=<<currentTiddler>> windowTitle="Side by Side View"
  width="800" height="600" />
\end

\define controlPanel-plugin-link()
<$button actions=<<activatePluginTab>> class="tc-btn-invisible tc-tiddlylink">
{{$:/core/images/options-button}} ~ControlPanel
</$button>
\end

\define open-tiddler-in-window()
<$button actions=<<activateTiddlerWindow>> class="tc-btn-invisible tc-tiddlylink">
open ''this'' tiddler in a new window
</$button>
\end

\define activateEditionWindow(url)
<$action-sendmessage $message="tm-open-external-window"
  $param="""$url$""" windowName="_edition"
  windowFeatures="width=800 height=600" />
\end

\define open-external-window(url)
<$button actions=<<activateEditionWindow """$url$""">> class="tc-btn-invisible tc-tiddlylink">
open the ''example edition'' in a new window
</$button>
\end


\define wikitext-example(src)
<div class="doc-example">

<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>

<$codeblock code=<<__src__>>/>

That renders as:

<$macrocall $name="__src__"/>

... and the underlying HTML is:

<$wikify name="html" text=<<__src__>> output="html">
<$codeblock code=<<html>>/>
</$wikify>
</div>
\end

\define wikitext-example-without-html(src)
<div class="doc-example">

<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>

<$codeblock code=<<__src__>>/>

That renders as:

<$macrocall $name="__src__"/>

</div>
\end

\define wikitext-example-table-header() <thead><tr><th/><th>wiki text</th><th>renders as</th></tr></thead>

\define wikitext-example-table-row(id, code)
 <tr>
<th><<__id__>></th><td><$codeblock code=<<__code__>>/></td><td>

<<__code__>>
</td>
</tr>
\end

\define tw-code(tiddler)
<$codeblock language={{$tiddler$!!type}} code={{$tiddler$}}/>
\end

\define tw-code-link(tiddler)
[[$tiddler$]]:

<<tw-code $tiddler$>>
\end

\define flex-card(class,bordercolor:"",backgroundcolor:"",textcolor:"",imageField:"image",captionField:"caption",subtitle:"",descriptionField:"description",linkField:"link")
\whitespace trim
<$link class={{{ [<__class__>addprefix[tc-card ]] }}} to={{{ [<currentTiddler>get<__linkField__>else<currentTiddler>] }}}>
	<div class="tc-card-accent" style.borderTop={{{ [<__bordercolor__>!is[blank]addprefix[5px solid ]] }}} style.background={{!!background}} style.backgroundColor=<<__backgroundcolor__>> style.color=<<__textcolor__>> style.fill=<<__textcolor__>>>
		<$list filter="[<currentTiddler>has[ribbon-text]]" variable="ignore">
			<div class="tc-card-ribbon-wrapper">
				<div class="tc-card-ribbon" style.backgroundColor={{{ [<currentTiddler>get[ribbon-color]else[red]] }}}>
					<div class="tc-card-ribbon-inner">
						<$text text={{!!ribbon-text}}/>
					</div>
				</div>
			</div>
		</$list>
		<$list filter="[<currentTiddler>has<__imageField__>]" variable="ignore">
			<div class="tc-card-image">
				<$image source={{{ [<currentTiddler>get<__imageField__>] }}}/>
			</div>
		</$list>
		<div class="tc-card-title"><$transclude field=<<__captionField__>>><$view field="title"/></$transclude></div>
		<$list filter="[<__subtitle__>!is[blank]]" variable="ignore">
			<div class="tc-card-subtitle">
				<$text text=<<__subtitle__>>/>
			</div>
		</$list>
		<div class="tc-card-icon"><$transclude tiddler={{!!icon}}/></div>
		<div class="tc-card-body-wrapper">
			<div class="tc-card-body">
				<$transclude field=<<__descriptionField__>> mode="block"/>
			</div>
			<div class="tc-card-body-clear">
			</div>
		</div>
		<$list filter="[all[current]has[button-text]]" variable="ignore">
			<div class="tc-card-button" style.background-color={{!!button-color}} style.border-color={{!!button-color}}>
				<$text text={{!!button-text}}/>&#32;{{$:/core/images/chevron-right}}
			</div>
		</$list>
	</div>
</$link>
\end
Doc restructuring Plugin Install using core Libraries and with Node.js (#6722) * Doc restructuring Plugin Install using core Libraries and with Node.js * fixing typos and concerns raised by Jeremy 2022-06-20 12:55:12 +00:00			`code-body: yes`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`created: 20150117184156000`
Doc restructuring Plugin Install using core Libraries and with Node.js (#6722) * Doc restructuring Plugin Install using core Libraries and with Node.js * fixing typos and concerns raised by Jeremy 2022-06-20 12:55:12 +00:00			`modified: 20220617122915793`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00			`tags: $:/tags/Macro`
Add doc related to WikiText parser modes (#6415) * Added macros for displaying wikitext examples in a table * Added documentation for WikiText parsing * Changed recognize to British spelling * Add links to the new wikitext parser tiddlers 2022-01-23 09:44:01 +00:00			`title: $:/editions/tw5.com/wikitext-macros`
			`type: text/vnd.tiddlywiki`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Doc restructuring Plugin Install using core Libraries and with Node.js (#6722) * Doc restructuring Plugin Install using core Libraries and with Node.js * fixing typos and concerns raised by Jeremy 2022-06-20 12:55:12 +00:00			`\define activatePluginTab()`
			`<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Plugins"/>`
			`<$action-navigate $to="$:/ControlPanel"/>`
			`\end`

			`\define activateTiddlerWindow()`
			`<$action-sendmessage $message="tm-open-window"`
			`$param=<<currentTiddler>> windowTitle="Side by Side View"`
			`width="800" height="600" />`
			`\end`

			`\define controlPanel-plugin-link()`
			`<$button actions=<<activatePluginTab>> class="tc-btn-invisible tc-tiddlylink">`
			`{{$:/core/images/options-button}} ~ControlPanel`
			`</$button>`
			`\end`

			`\define open-tiddler-in-window()`
			`<$button actions=<<activateTiddlerWindow>> class="tc-btn-invisible tc-tiddlylink">`
			`open ''this'' tiddler in a new window`
			`</$button>`
			`\end`

			`\define activateEditionWindow(url)`
			`<$action-sendmessage $message="tm-open-external-window"`
			`$param="""$url$""" windowName="_edition"`
			`windowFeatures="width=800 height=600" />`
			`\end`

			`\define open-external-window(url)`
			`<$button actions=<<activateEditionWindow """$url$""">> class="tc-btn-invisible tc-tiddlylink">`
			`open the ''example edition'' in a new window`
			`</$button>`
			`\end`


Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00			`\define wikitext-example(src)`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`<div class="doc-example">`

Add copy-to-clipboard macro And use it in the tw5.com example documentation 2017-12-16 10:58:33 +00:00			`<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>`

Partial fix for wikitext example macros They don't work when the src text contains variable substitution syntax. 2022-09-21 08:32:18 +00:00			`<$codeblock code=<<__src__>>/>`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`That renders as:`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Partial fix for wikitext example macros They don't work when the src text contains variable substitution syntax. 2022-09-21 08:32:18 +00:00			`<$macrocall $name="__src__"/>`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`... and the underlying HTML is:`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Complete fix for a981f8ccfe80634eb15b9ed33393775a2d77994f 2022-09-22 09:34:27 +00:00			`<$wikify name="html" text=<<__src__>> output="html">`
			`<$codeblock code=<<html>>/>`
			`</$wikify>`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`</div>`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00			`\end`

			`\define wikitext-example-without-html(src)`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`<div class="doc-example">`

Add copy-to-clipboard macro And use it in the tw5.com example documentation 2017-12-16 10:58:33 +00:00			`<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>`

Partial fix for wikitext example macros They don't work when the src text contains variable substitution syntax. 2022-09-21 08:32:18 +00:00			`<$codeblock code=<<__src__>>/>`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`That renders as:`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00
Partial fix for wikitext example macros They don't work when the src text contains variable substitution syntax. 2022-09-21 08:32:18 +00:00			`<$macrocall $name="__src__"/>`
Typo from a981f8ccfe80634eb15b9ed33393775a2d77994f Fixes #6955 2022-09-24 09:55:22 +00:00
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`</div>`
Support global macros via the importvariables widget The new importvariables widget imports macro/variable definitions from the specified tiddlers and makes them available to its children. Allows us to split PageMacros up into separate tiddlers. We still support loading macros from $:/core/ui/PageMacros to help people upgrading. Fixes #644 and #559 2014-06-12 17:01:33 +00:00			`\end`
updated NestedLists, renamed to GroupedLists added tw-code macro Didn't implement the codeblock widget as suggested here... https://github.com/Jermolene/TiddlyWiki5/pull/1332#discussion_r22762157 ...because it would only return `undefined`. 2015-01-11 10:55:22 +00:00
Add doc related to WikiText parser modes (#6415) * Added macros for displaying wikitext examples in a table * Added documentation for WikiText parsing * Changed recognize to British spelling * Add links to the new wikitext parser tiddlers 2022-01-23 09:44:01 +00:00			`\define wikitext-example-table-header() <thead><tr><th/><th>wiki text</th><th>renders as</th></tr></thead>`

			`\define wikitext-example-table-row(id, code)`
			`<tr>`
			`<th><<__id__>></th><td><$codeblock code=<<__code__>>/></td><td>`

			`<<__code__>>`
			`</td>`
			`</tr>`
			`\end`

updated NestedLists, renamed to GroupedLists added tw-code macro Didn't implement the codeblock widget as suggested here... https://github.com/Jermolene/TiddlyWiki5/pull/1332#discussion_r22762157 ...because it would only return `undefined`. 2015-01-11 10:55:22 +00:00			`\define tw-code(tiddler)`
updated tw-code macro to use codeblock widget As per fix.... https://github.com/Jermolene/TiddlyWiki5/pull/1332#issuecomment-69499836 Tested, working. 2015-01-11 17:15:27 +00:00			`<$codeblock language={{$tiddler$!!type}} code={{$tiddler$}}/>`
updated NestedLists, renamed to GroupedLists added tw-code macro Didn't implement the codeblock widget as suggested here... https://github.com/Jermolene/TiddlyWiki5/pull/1332#discussion_r22762157 ...because it would only return `undefined`. 2015-01-11 10:55:22 +00:00			`\end`

			`\define tw-code-link(tiddler)`
			`[[$tiddler$]]:`

			`<<tw-code $tiddler$>>`
Improve readability for documentation macros (#6494) 2022-03-02 17:36:53 +00:00			`\end`
Add Funding and Marketplace material, and refresh HelloThere 2022-12-04 17:58:16 +00:00
Docs: Fixed PR for getting started tweaks (#7399) * Cherry picked from getting-started-tweaks-feb-2023 * Update tiddler modified dates 2023-04-10 14:52:10 +00:00			`\define flex-card(class,bordercolor:"",backgroundcolor:"",textcolor:"",imageField:"image",captionField:"caption",subtitle:"",descriptionField:"description",linkField:"link")`
Add Funding and Marketplace material, and refresh HelloThere 2022-12-04 17:58:16 +00:00			`\whitespace trim`
			`<$link class={{{ [<__class__>addprefix[tc-card ]] }}} to={{{ [<currentTiddler>get<__linkField__>else<currentTiddler>] }}}>`
Docs: Fixed PR for getting started tweaks (#7399) * Cherry picked from getting-started-tweaks-feb-2023 * Update tiddler modified dates 2023-04-10 14:52:10 +00:00			`<div class="tc-card-accent" style.borderTop={{{ [<__bordercolor__>!is[blank]addprefix[5px solid ]] }}} style.background={{!!background}} style.backgroundColor=<<__backgroundcolor__>> style.color=<<__textcolor__>> style.fill=<<__textcolor__>>>`
Add Funding and Marketplace material, and refresh HelloThere 2022-12-04 17:58:16 +00:00			`<$list filter="[<currentTiddler>has[ribbon-text]]" variable="ignore">`
			`<div class="tc-card-ribbon-wrapper">`
			`<div class="tc-card-ribbon" style.backgroundColor={{{ [<currentTiddler>get[ribbon-color]else[red]] }}}>`
			`<div class="tc-card-ribbon-inner">`
			`<$text text={{!!ribbon-text}}/>`
			`</div>`
			`</div>`
			`</div>`
			`</$list>`
			`<$list filter="[<currentTiddler>has<__imageField__>]" variable="ignore">`
			`<div class="tc-card-image">`
			`<$image source={{{ [<currentTiddler>get<__imageField__>] }}}/>`
			`</div>`
			`</$list>`
			`<div class="tc-card-title"><$transclude field=<<__captionField__>>><$view field="title"/></$transclude></div>`
			`<$list filter="[<__subtitle__>!is[blank]]" variable="ignore">`
			`<div class="tc-card-subtitle">`
			`<$text text=<<__subtitle__>>/>`
			`</div>`
			`</$list>`
Docs: Fixed PR for getting started tweaks (#7399) * Cherry picked from getting-started-tweaks-feb-2023 * Update tiddler modified dates 2023-04-10 14:52:10 +00:00			`<div class="tc-card-icon"><$transclude tiddler={{!!icon}}/></div>`
Add Funding and Marketplace material, and refresh HelloThere 2022-12-04 17:58:16 +00:00			`<div class="tc-card-body-wrapper">`
			`<div class="tc-card-body">`
			`<$transclude field=<<__descriptionField__>> mode="block"/>`
			`</div>`
			`<div class="tc-card-body-clear">`
			`</div>`
			`</div>`
Docs: Fixed PR for getting started tweaks (#7399) * Cherry picked from getting-started-tweaks-feb-2023 * Update tiddler modified dates 2023-04-10 14:52:10 +00:00			`<$list filter="[all[current]has[button-text]]" variable="ignore">`
			`<div class="tc-card-button" style.background-color={{!!button-color}} style.border-color={{!!button-color}}>`
			`<$text text={{!!button-text}}/> {{$:/core/images/chevron-right}}`
			`</div>`
			`</$list>`
Add Funding and Marketplace material, and refresh HelloThere 2022-12-04 17:58:16 +00:00			`</div>`
			`</$link>`
			`\end`