mirrors
/
TiddlyWiki5
mirror of https://github.com/Jermolene/TiddlyWiki5
1
0
Fork 0
Code Issues Releases Wiki Activity
TiddlyWiki5/editions/tw5.com/tiddlers/wikitext/Widgets in WikiText.tid

30 lines
1.0 KiB
Plaintext
Raw Normal View History

Big docs update Finally sorting out the wikitext documentation
2013-12-05 16:21:10 +00:00
created: 20131205160840915
Docs update
2014-06-19 11:37:54 +00:00
modified: 20140619111725471
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: Widgets in WikiText
type: text/vnd.tiddlywiki
Update wikitext documentation
2014-09-11 08:15:58 +00:00
caption: Widgets
Big docs update Finally sorting out the wikitext documentation
2013-12-05 16:21:10 +00:00
Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks.
2014-02-20 21:42:31 +00:00
Widgets provide rich functionality within WikiText. They have the same syntax as [[HTML elements|HTML in WikiText]], but the tag name always starts with `$`. For example:
```
Rename "tw-*" messages to "tm-*"
2014-08-28 20:43:44 +00:00
<$button message="tm-close-tiddler">Close Me!</$button>
Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks.
2014-02-20 21:42:31 +00:00
```
Note that widgets inherit all the features of [[HTML in WikiText]]:
* Widget attributes can be specified as:
** Unquoted strings (that cannot contain spaces)
** Strings quoted with single or double quotes
Docs update
2014-06-19 11:37:54 +00:00
** Strings quoted with triple-double quotes
Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks.
2014-02-20 21:42:31 +00:00
** Macro invocations (eg `attr=<<myMacro>>`)
** Transclusions (eg, `attr={{MyTiddler!!field}}`)
* The content of a widget is parsed in inline mode unless the opening tag is followed by two linebreaks, which forces block mode
** 'Inline mode' means that 'block mode' parse rules like headings, tables and lists are not recognised
See [[HTML in WikiText]] for more details.
The available widgets include:
Big docs update Finally sorting out the wikitext documentation
2013-12-05 16:21:10 +00:00
Refine preliminary list macro @pmario: I’ve taken your suggestion and made the HTML element type(s) be macro parameters.
2014-09-17 11:13:24 +00:00
<<list-links "[tag[Widgets]]">>