tiddlywiki 5.1.23 → 5.2.2

package/editions/tw5.com/tiddlers/wikitext/Transclusion and Substitution.tid

@@ -1,6 +1,7 @@
-title: Transclusion and Substitution
 created: 20141018090608643
-modified: 20150220190346000
+modified: 20211117212543789
+tags: WikiText
+title: Transclusion and Substitution
 type: text/vnd.tiddlywiki
 
 The power of WikiText comes from the ability to use the content of one tiddler inside another one. This ability takes several different forms that can easily be confused.

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

@@ -1,6 +1,6 @@
 caption: Transclusion
 created: 20131205160146648
-modified: 20150220161347000
+modified: 20220122193352028
 tags: WikiText
 title: Transclusion in WikiText
 type: text/vnd.tiddlywiki
@@ -48,3 +48,4 @@ See also:
 * TemplateTiddlers
 * TranscludeWidget
 * [[Transclusion and Substitution]]
+* [[WikiText parser mode: transclusion examples]]

package/editions/tw5.com/tiddlers/wikitext/Widgets in WikiText.tid

@@ -1,6 +1,6 @@
 caption: Widgets
 created: 20131205160840915
-modified: 20161020210726813
+modified: 20220122193129241
 tags: WikiText
 title: Widgets in WikiText
 type: text/vnd.tiddlywiki
@@ -20,8 +20,8 @@ Note that widgets inherit all the features of [[HTML in WikiText]]:
 ** Macro invocations (eg `attr=<<myMacro>>`)
 ** Transclusions (eg, `attr={{MyTiddler!!field}}`)
 ** Filtered transclusions (eg, `attr={{{ [filter[op]] }}}`)
-* 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
+* The content of a widget is [[parsed|WikiText Parser Modes]] in [[inline mode|Inline Mode WikiText]] unless the opening tag is followed by two linebreaks, which forces [[block mode|Block Mode WikiText]]
+** [[inline mode|Inline Mode WikiText]] means that [[block mode|Block Mode WikiText]] parse rules like headings, tables and lists are not recognised
 
 See [[HTML in WikiText]] for more details.
 

package/editions/tw5.com/tiddlers/wikitext/parser/Block Mode WikiText (Examples).tid

@@ -0,0 +1,51 @@
+created: 20220115152811251
+modified: 20220115161035903
+tags: [[Block Mode WikiText]]
+title: Block Mode WikiText (Examples)
+type: text/vnd.tiddlywiki
+
+[[Paragraphs|Paragraphs in WikiText]] are the most common WikiText. It is important to know they do not end until a blank line is encountered. Once a paragraph starts the parser will be in ''inline mode''. Until that blank line is encountered other ''block mode'' syntax will be ignored:
+
+<<<
+<<wikitext-example-without-html src:'This is a paragraph.
+Only __//inline mode//__ punctuation is recognised here.
+Block mode punctuation will be <b>ignored</b> until
+the paragraph ends (i.e. a blank line is encountered).
+For example:
+* List item punctuation is ignored
+* So is this horizontal rule:
+---
+|tables|are|ignored|
+! headings are ignored
+<<<
+multi-line block quotes are ignored
+<<<
+'>>
+<<<
+
+To get the parser to recognise the above ''block mode'' WikiText, a blank line needs to be inserted after the "For example:" line. The blank line will be treated as the end of the paragraph and the parser will start recognising ''block mode'' punctuation again. Like this:
+
+<<<
+<<wikitext-example-without-html src:'This is a paragraph.
+Only __//inline mode//__ punctuation is recognised here.
+Block mode punctuation will be <b>ignored</b> until
+the paragraph ends (i.e. a blank line is encountered).
+For example, here is a blank line:
+
+* due to above blank line,
+* list items work
+* the following horizontal rule also works:
+---
+|!tables|!work|
+|cell 1| cell 2|
+! Headings work
+<<<
+multi-line block quotes work
+<<<
+; Term
+: Definition of that term
+Another paragraph can start here, but it will not end until blank line
+'>>
+<<<
+
+All the block mode examples above except for the paragraph are written one line after the other without blanks between. Those types of WikiText don't require the extra blank line to terminate.

package/editions/tw5.com/tiddlers/wikitext/parser/Block Mode WikiText.tid

@@ -0,0 +1,35 @@
+caption: block parser mode
+created: 20220110234234616
+modified: 20220122182842032
+tags: [[WikiText Parser Modes]]
+title: Block Mode WikiText
+type: text/vnd.tiddlywiki
+
+Some WikiText is recognised only while the parser is in block mode.
+
+Common characteristics of such block mode WikiText:
+
+* At least one entire line is required to delimit the WikiText.
+* The closing punctuation must come at the end of the line (in some cases the end of the line //is// the closing punctuation.
+
+|!~WikiText|!Punctuation|
+|[[Block Quotes in WikiText]] |Multi-line block quotes are enclosed by lines containing only the text `<<<`; single line block quotes are also possible.|
+|[[Code Blocks in WikiText]]|Enclosed by lines containing only the text <code>&#96;&#96;&#96;</code>|
+|[[Definitions in WikiText]]|Each term is on its own line and each definition is on its own line.|
+|[[Hard Linebreaks in WikiText]]|Enclosed by lines containing only the text `"""`.|
+|[[Headings in WikiText]]|Entire line starting with `!`.|
+|[[Horizontal Rules in WikiText]]|A line containing only the text `---`.|
+|[[Lists in WikiText]]|Each list item is on its own line.|
+|[[Paragraphs in WikiText]]|Any text other than the start punctuation of one of the other block mode WikiText will start a paragraph. Even the start punctuation of inline mode WikiText will start a paragraph. The parser includes all following lines into the paragraph until it encounters a blank line.|
+|[[Styles and Classes in WikiText]]|Enclosed by lines starting with `@@`.|
+|[[Tables in WikiText]]|Each table row is a line starting and ending with `|`.|
+|[[Typed Blocks in WikiText]]|Enclosed by lines starting with `$$`.|
+
+The above WikiText types are only recognised in ''block mode''. However, the text <<.em enclosed>> by most of them will be parsed in ''inline mode'' ([[Block Quotes in WikiText]] and [[Styles and Classes in WikiText]] are the two exceptions in which the parser will continue in ''block mode''). While in ''inline mode'' the parser may encounter something which moves it to ''block mode'' (see [[WikiText parser mode transitions]]).
+
+At the end of the terminating line, the parser will return to ''block mode''. 
+<<.tip 'Note: [[Hard Linebreaks in WikiText]] require an extra blank line after the trailing `"""` before the parser will return to <b>block mode</b>'>>.
+
+If the punctuation for the above types of WikiText is encountered while the parser is in ''inline mode'', it will be //ignored// and output as-is.
+
+[[Examples|Block Mode WikiText (Examples)]]

package/editions/tw5.com/tiddlers/wikitext/parser/Inline Mode WikiText.tid

@@ -0,0 +1,26 @@
+caption: inline parser mode
+created: 20220111000108618
+modified: 20220122182842036
+tags: [[WikiText Parser Modes]]
+title: Inline Mode WikiText
+type: text/vnd.tiddlywiki
+
+Some WikiText is recognised only while the parser is in inline mode.
+
+These WikiText types can be expressed without an entire line of text. They aren't required to be all on one line, just that they <<.em can>> be expressed within a single line. And as such, more than one can appear within a single line.  In other words, line endings are not involved while the parser tries to find where the particular WikiText begins and ends While the parser is in inline mode, it will recognise the punctuation for these WikiText types:
+
+* [[Dashes in WikiText]]
+* [[Formatting in WikiText]]
+* [[HTML in WikiText]]
+* [[Images in WikiText]]
+* [[Linking in WikiText]]
+* [[Macro Calls in WikiText]]
+* [[Styles and Classes in WikiText]] (single line version only)
+* [[Transclusion in WikiText]]
+* [[Variables in WikiText]]
+* [[Widgets in WikiText]]
+
+<<.tip """[[Macro Calls in WikiText]] and  [[Transclusion in WikiText]] will be recognised in block mode if the macro call or transclusion spans an entire line.""">>
+<<.tip """The other ''inline mode'' WikiText types are technically <<.em only>> detected while the parser is in ''inline mode''. However, the opening punctuation will also trigger the start of [[Paragraphs in WikiText]] which will automatically cause the parser to go into ''inline mode''. Therefore, practically speaking, it is just as useful to consider these WikiText types as recognised while the parser is in either ''inline mode'' or ''block mode''""">>
+
+While processing the //enclosed// text of some of these WikiText types, the parser [[will not look for new WikiText|Places where the parser ignores WikiText]]. But for rest of these WikiText types, the parser will continue in ''inline mode'' for the //enclosed// text.  While parsing that text, it might encounter something which [[moves it to block mode|WikiText parser mode transitions]].

package/editions/tw5.com/tiddlers/wikitext/parser/Places where the parser ignores WikiText.tid

@@ -0,0 +1,14 @@
+caption: ignore parser mode
+created: 20220111000929700
+modified: 20220122182842038
+tags: [[WikiText Parser Modes]]
+title: Places where the parser ignores WikiText
+type: text/vnd.tiddlywiki
+
+Text enclosed by these constructs is skipped by the parser and WikiText punctuation will be ignored:
+
+|[[Code Blocks in WikiText]]|One of the main purposes of code blocks is to suppress wikitext expansion. Once the code block starts, the parser will ignore all WikiText punctuation until the code block ends.|
+|[[Images in WikiText]]|`[[img|literal image link text]]` - the text enclosed by square braces will be ignored. This means, for example, [[transclusions|Transclusion in WikiText]] and [[macro calls|Macro Calls in WikiText]] cannot be used to dynamically construct the link text|
+|[[Linking in WikiText]]|`[[literal link target|literal link text]]` - the text enclosed by square braces will be ignored. This means, for example, [[transclusions|Transclusion in WikiText]] and [[macro calls|Macro Calls in WikiText]] cannot be used to dynamically construct the link target or the link text|
+|[[Macro Calls in WikiText]]|`<<mymacro ''notbold'' "literal text" "<<macro_expansion_ignored>>" {{transclusion_ignored}}>>` - while processing the text enclosed by a macro call, the parser will follow special rules for detecting macro parameters. These rules do not include detection of WikiText. However, after the parameters are substituted into the macro definition, the result will be parsed using [[normal rules|Wiki Text Parser Modes]]. This will likely result in the detection of any WikiText.|
+

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText Parser Modes.tid

@@ -0,0 +1,16 @@
+created: 20220110233944530
+modified: 20220202022415581
+tags: WikiText
+title: WikiText Parser Modes
+type: text/vnd.tiddlywiki
+
+In order to display Tiddlers (usually the text field), the WikiText parser reads and interprets the content and applies WikiText rules. The parser has three modes:
+
+* ''pragma mode'' - the parser will recognise only [[pragma mode WikiText|Pragma]] punctuation 
+* ''block mode'' - the parser will recognise only [[block mode WikiText|Block Mode WikiText]] punctuation
+* ''inline mode'' - the parser will recognise only [[inline mode WikiText|Inline Mode WikiText]]
+
+The parser [[transitions between these modes|WikiText parser mode transitions]] based on the text it encounters. In addition, there are  [[places where the parser ignores WikiText|Places where the parser ignores WikiText]] punctuation.
+
+<<.tip "The concept of inline vs block also exists for standard HTML elements. For HTML, these [[two layout modes|https://www.w3schools.com/html/html_blocks.asp]] determine if the output flows together on the same line or not.
+<p>Most [[block mode WikiText|Block Mode WikiText]] corresponds to [[block level HTML elements|https://developer.mozilla.org/en-US/docs/Web/HTML/Block-level_elements]] and most [[inline mode WikiText|Inline Mode WikiText]] corresponds to [[inline level HTML elements|https://developer.mozilla.org/en-US/docs/Web/HTML/Inline_elements]]. However, for Wikitext the two modes are just as important for determining which syntax will be recognised by the parser as they are for determining how the output will flow.</p>">>

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText parser mode transitions.tid

@@ -0,0 +1,59 @@
+created: 20220110235808139
+modified: 20220122184232928
+tags: [[WikiText Parser Modes]]
+title: WikiText parser mode transitions
+type: text/vnd.tiddlywiki
+
+This is a <<.em rough>> diagram whose lines mostly correspond to the parser mode transitions described below:
+<$railroad text="""
+{<"pragma mode">
+{(
+  {<"inline mode"> +} |
+  ({<"block mode">
+    +("<<<" | "@@" | "$$")
+  }
+  "other block mode start punct")
+  {<"inline mode"> +}
+  )
+  +(
+    "block mode close punctuation" |
+    ("blank line" "html open tag")
+  )}
+  +("transclude widget" | "macrocall")
+}
+"""/>
+
+!! Start mode
+
+By default the parser starts in [[block mode|Block Mode WikiText]]. However, a tiddler can instead be transcluded with [[inline mode|Inline Mode WikiText]] in which case [[block mode WikiText|Block Mode WikiText]] will not be recognised.
+
+At the start of text only, the parser will also recognise any [[pragma mode WikiText|Pragma]].
+
+!! Transitions from pragma mode
+
+At the start of text, the parser will recognise any [[pragma|Pragma]]. If none are found then it will move to [[inline|Inline Mode WikiText]] or [[block|Block Mode WikiText]] mode depending on the transclusion mode. If any [[pragma|Pragma]] are found then it will continue looking for [[pragma|Pragma]] until it finds one or more blank lines not followed by the start of a new pragma.
+
+!! Transitions from block mode
+
+When the parser encounters most [[block mode|Block Mode WikiText]] start punctuation it transitions to [[inline mode|Inline Mode WikiText]]. This means
+he text enclosed by most [[block mode|Block Mode WikiText]] constructs will be parsed using [[inline mode|Inline Mode WikiText]].
+
+<<.tip """The start "punctuation" for a paragraph is "invisible". Even for paragraphs the parser moves to [[inline mode|Inline Mode WikiText]]""">>
+
+However, there are a few constructs whose enclosed text is parsed using [[block mode|Block Mode WikiText]]:
+
+* [[Multi-line block quotes|Block Quotes in WikiText]]
+* [[Multi-line style blocks|Styles and Classes in WikiText]]
+* [[Typed blocks|Typed Blocks in WikiText]]
+
+When the start punctuation for these are encountered, the enclosed text will continue to be parsed in [[block mode|Block Mode WikiText]].
+
+[[Horizontal rules|Horizontal Rules in WikiText]] are another special case. They do not enclose any text, so there is no opportunity for the parser to transition to [[inline mode|Inline Mode WikiText]].
+
+Opening [[widget|Widgets in WikiText]] or [[HTML|HTML in WikiText]] tags provide another way the parser can transition. When such a tag is <<.em not>> followed by a blank line, then the contents enclosed by the tag will be parsed in [[inline mode|Inline Mode WikiText]]. See the [[HTML examples|WikiText parser mode: HTML examples]].
+
+!! Transitions from inline mode
+
+* The parser will move back to [[block mode|Block Mode WikiText]] after the end of a line which terminates [[block mode|Block Mode WikiText]] ~WikiText. In other words, when the block mode close punctuation is encountered.
+* When the opening [[widget|Widgets in WikiText]] or [[HTML|HTML in WikiText]] tag is followed by a blank line, then the contents enclosed by the tag will be parsed in [[block mode|Block Mode WikiText]]. See the [[HTML examples|WikiText parser mode: HTML examples]].
+* Transcluded text and text pulled in via a macro call can transition the parser away from [[inline mode|Inline Mode WikiText]]. See [[transclusion examples|WikiText parser mode: transclusion examples]] and [[macro examples|WikiText parser mode: macro examples]] for more details.

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText parser mode_ HTML examples.tid

@@ -0,0 +1,72 @@
+created: 20220122153235162
+modified: 20220122180508134
+tags: [[WikiText parser mode transitions]]
+title: WikiText parser mode: HTML examples
+type: text/vnd.tiddlywiki
+
+<<wikitext-example-without-html "<div>
+
+* blank line after open tag allows
+* block mode punctuation (i.e. this list) to
+* be recognised
+</div>
+">>
+
+---
+
+The open tag blank line "trick" also works inside of punctuation only recognised in inline mode (such as [[Formatting in WikiText]]):
+
+<<wikitext-example-without-html "''<div>
+
+* list item one
+* list item two
+</div>''">>
+
+---
+
+<<wikitext-example-without-html "<div>
+* Open tag without a blank line means
+* block mode punctuation (i.e. this list) will
+* NOT be recognised.
+
+Paragraphs are only recognised in block mode. Even with blank lines, new paragraphs are not recognised.
+
+This also is not a new paragraph.
+</div>">>
+
+---
+
+[[Tables in WikiText]] is one construct for which the open tag blank line "trick" cannot work. In order for the parser to recognise a table row, the entire row must be on a single line.
+
+Adding a blank link after an open tag within a table cell causes the row to span mulitple lines and the parser ceases to be able to recognise it as a table row.
+
+<<wikitext-example-without-html "|table row|all on|one line|is recognised|">>
+
+<<wikitext-example-without-html "|For a blank line after open tag|<div>
+
+* list is recognised
+* but the surrounding table row is not
+</div>|">>
+
+---
+
+The only way to get [[block mode|Block Mode WikiText]] punctuation recognised in [[wikitext tables|Tables in WikiText]] is to use <<.wlink TranscludeWidget>> with <<.attr mode>> = <<.value block>>.
+
+<<wikitext-example-without-html '|Nested table:|<$transclude tiddler="table-example" mode=block/>|'>>
+
+Note that <<.wlink MacroCallWidget>> does not have a similar <<.attr mode>> attribute and the content of macro definitions can only be parsed in [[inline mode|Inline Mode WikiText]]
+
+---
+
+The less convenient `<table>`, `<tr>`, `<td>` html tags can be used as a foolproof way to get [[block mode|Block Mode WikiText]] punctuation recognised inside of table cells.
+
+<<wikitext-example-without-html "<table>
+<tr><td>
+
+* list item one
+* list item two
+</td><td>
+
+|nested|table|
+</td></tr>
+</table>">>

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText parser mode_ macro examples.tid

@@ -0,0 +1,55 @@
+created: 20220122144742419
+modified: 20220122180929683
+tags: [[WikiText parser mode transitions]]
+title: WikiText parser mode: macro examples
+type: text/vnd.tiddlywiki
+
+\define boringtable()
+|cell one|cell two|
+|cell three|cell four|
+\end
+With the macro `boringtable` defined as:
+<$codeblock code=<<boringtable>>/>
+then
+<table><<wikitext-example-table-header>><tbody>
+<<wikitext-example-table-row 1 "* <<boringtable>>">>
+<<wikitext-example-table-row 2 """* <div>
+
+<<boringtable>>
+</div>
+""">>
+<<wikitext-example-table-row 3 "* <$macrocall $name=boringtable/>">>
+<<wikitext-example-table-row 4 "* <$macrocall $name=boringtable></$macrocall>">>
+<<wikitext-example-table-row 5 """* <$macrocall $name=boringtable>
+
+</$macrocall>""">>
+</tbody></table>
+
+The list syntax is recognised in [[block mode|Block Mode WikiText]] and the enclosed contents are parsed using [[inline mode|Inline Mode WikiText]]. When the parser encounters a [[wikitext macro call|Macro Calls in WikiText]] it will use the current parse mode to parse the contents of the macro. The contents of the macro contains table syntax which is only recognised in [[block mode|Block Mode WikiText]]. 
+
+Therefore, in #1 above the table syntax is not recognised. In #2 above, the blank line after the open `div` tag moves the parser back into [[block mode|Block Mode WikiText]], the macro call inherits it and the table is recognised.
+
+When calling macros using the [[widget|MacroCallWidget]], the parse mode will be inline (#3 and #4 above) unless it is written as an open tag with a following blank line (#5 above).
+
+<<.tip "See also [[WikiText parser mode: transclusion examples]] for similar examples">>
+
+---
+
+These examples have slightly different behavior. In the previous section, the macro calls were enclosed within list items.  In these examples, the macro calls are at the top level:
+<table><<wikitext-example-table-header>><tbody>
+<<wikitext-example-table-row 1 "<<boringtable>>">>
+<<wikitext-example-table-row 2 """<div>
+
+<<boringtable>>
+</div>
+""">>
+<<wikitext-example-table-row 3 "<$macrocall $name=boringtable/>">>
+<<wikitext-example-table-row 4 "<$macrocall $name=boringtable></$macrocall>">>
+<<wikitext-example-table-row 5 """<$macrocall $name=boringtable>
+
+</$macrocall>""">>
+</tbody></table>
+
+Of these examples, only the two <<.wlink MacroCallWidget>> tags which are not followed by a blank line are parsed using [[inline mode|Inline Mode WikiText]].
+
+<<.tip "See also [[WikiText parser mode: transclusion examples]] for similar examples">>

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText parser mode_ transclusion examples.tid

@@ -0,0 +1,56 @@
+created: 20220122145022547
+modified: 20220122180845946
+tags: [[WikiText parser mode transitions]]
+title: WikiText parser mode: transclusion examples
+type: text/vnd.tiddlywiki
+
+
+Given the tiddler  [[table-example]] defined with these contents:
+<$codeblock code={{table-example}}/>
+then
+<table><<wikitext-example-table-header>><tbody>
+<<wikitext-example-table-row 1 "* {{table-example}}">>
+<<wikitext-example-table-row 2 """* <div>
+
+{{table-example}}
+</div>
+""">>
+<<wikitext-example-table-row 3 "* <$transclude tiddler=table-example/>">>
+<<wikitext-example-table-row 4 "* <$transclude tiddler=table-example></$transclude>">>
+<<wikitext-example-table-row 5 """* <$transclude tiddler=table-example>
+
+</$transclude>""">>
+<<wikitext-example-table-row  6 "* <$transclude tiddler=table-example mode=block/>">>
+</tbody></table>
+
+The list syntax is recognised in [[block mode|Block Mode WikiText]] and the enclosed contents are parsed using [[inline mode|Inline Mode WikiText]]. When the parser encounters a [[wikitext transclusion|Transclusion in WikiText]] it will use the current parse mode to parse the contents of the transcluded tiddler. The contents of the example tiddler contains table syntax which is only recognised in [[block mode|Block Mode WikiText]]. 
+
+Therefore, in #1 above the table syntax is not recognised. In #2 above, the blank line after the open `div` tag moves the parser back into [[block mode|Block Mode WikiText]], the transcluded text inherits it and the table is recognised.
+
+When transcluding tiddlers using the [[widget|TranscludeWidget]], the parse mode will be inline (#3 and #4 above) unless it is written as an open tag with a following blank line (#5 above).
+
+<<.tip "See also [[WikiText parser mode: macro examples]] for similar examples. The only difference here is <<.wlink TranscludeWidget>> has a <<.attr mode>> attribute (extra example #6) which allows the parse mode to be explicitly overridden rather than come implicitly based on the they way the tag is written">>
+
+---
+
+In these examples, the transclusions are at the top level instead of enclosed in list items:
+
+<table><<wikitext-example-table-header>><tbody>
+<<wikitext-example-table-row 1 "{{table-example}}">>
+<<wikitext-example-table-row 2 """<div>
+
+{{table-example}}
+</div>
+""">>
+<<wikitext-example-table-row 3 "<$transclude tiddler=table-example/>">>
+<<wikitext-example-table-row 4 "<$transclude tiddler=table-example></$transclude>">>
+<<wikitext-example-table-row 5 """<$transclude tiddler=table-example>
+
+</$transclude>""">>
+<<wikitext-example-table-row  6 "<$transclude tiddler=table-example mode=inline/>">>
+</tbody></table>
+
+
+Of these examples, only the two <<.wlink TranscludeWidget>> tags which are not followed by a blank line and the widget call using <<.attr mode>>=<<.value inline>> are parsed using [[inline mode|Inline Mode WikiText]].
+
+<<.tip "See also [[WikiText parser mode: macro examples]] for similar examples">>

package/editions/tw5.com/tiddlers/wikitext/parser/table-example.tid

@@ -0,0 +1,8 @@
+created: 20220118023452157
+modified: 20220118023529825
+tags: [[WikiText parser mode transitions (Examples)]]
+title: table-example
+type: text/vnd.tiddlywiki
+
+|cell one|cell two|
+|cell three|cell four|

package/editions/tw5.com/tiddlers/workingwithtw/Sharing your tiddlers with others.tid

@@ -1,5 +1,5 @@
 created: 20140908163900000
-modified: 20170328142732658
+modified: 20201228143412000
 tags: Learning
 title: Sharing your tiddlers with others
 type: text/vnd.tiddlywiki
@@ -14,3 +14,4 @@ There are a number of ways that you can share [[tiddlers|Tiddlers]] or your whol
 * You can [[share a Dropbox link to your TiddlyWiki|Sharing a TiddlyWiki on Dropbox]]
 * You can [[export tiddlers|How to export tiddlers]] (<<.icon $:/core/images/export-button>>) in a variety of formats including text, static HTML and comma separated values (ie spreadsheet compatible)
 *You can also share tiddlers merely by making your ~TiddlyWiki accessible to others, for example by publishing it online, so that they can [[import tiddlers|Importing Tiddlers]] from it
+* There is an experimental [[sharing plugin|Share Plugin]] that you can use to share tiddlers via the URL location hash.

package/editions/tw5.com/tiddlywiki.info

@@ -52,8 +52,8 @@
 			"--rendertiddlers","[!is[system]]","$:/core/templates/static.tiddler.html","static","text/plain",
 			"--rendertiddler","$:/core/templates/static.template.css","static/static.css","text/plain"],
 		"external-js": [
-			"--rendertiddler","$:/core/save/all-external-js","index.html","text/plain",
-			"--rendertiddler","$:/core/templates/tiddlywiki5.js","tiddlywiki.js","text/plain"]
+			"--rendertiddler","$:/core/save/offline-external-js","index.html","text/plain",
+			"--render","$:/core/templates/tiddlywiki5.js","[[tiddlywikicore-]addsuffix<version>addsuffix[.js]]","text/plain"]
 	},
 	"config": {
 		"retain-original-tiddler-path": true

package/languages/ar-PS/Misc.multids

@@ -24,7 +24,6 @@ Encryption/RepeatPassword: كرر/ي كلمة السر
 Encryption/SetPassword: ضبط كلمة السر
 Encryption/Username: اسم المستخدم
 Error/Caption: خطأ
-Error/EditConflict: تم تغيير الملف على الخادم
 Error/Filter: خطأ في التصفية
 Error/FilterSyntax: خطأ في بناء الجملة في تعبير عامل التصفية
 Error/IsFilterOperator: خطأ في التصفية: معامل غير معروف لعامل التصفية 'is'
@@ -32,12 +31,12 @@ Error/IsFilterOperator: خطأ في التصفية: معامل غير معروف
 Error/LoadingPluginLibrary: خطأ في تحميل مكتبة المكونات الإضافية
 
 Error/NetworkErrorAlert: `<h2>''خطأ في الشبكة''</h2> يبدو أن الاتصال بالخادم قد انقطع. قد يشير هذا إلى وجود مشكلة في اتصال الشبكة. يرجى محاولة استعادة اتصال الشبكة قبل المتابعة. <br> <br> '' ستتم مزامنة أي تغييرات غير محفوظة تلقائيًا عند استعادة الاتصال ''.
+Error/PutEditConflict: تم تغيير الملف على الخادم
 Error/WhileSaving: حدث خطأ أثناء الحفظ
 
 InternalJavaScriptError/Hint: حسنا، هذا أمر محرج. من المستحسن إعادة تشغيل تدلي ويكي عن طريق إنعاش المتصفح الخاص بك
 InternalJavaScriptError/Title: خطأ جافا سكربت داخلي
 
-InvalidFieldName: أحرف غير صحيحة في اسم الحقل  "<$text text=<<fieldName>>/>". يمكن أن تحتوي الحقول فقط على الأحرف الانجليزية الصغيرة والأرقام والأحرف السفلية (`_`) والواصلة (` -`) والنقطة (`.`)
 LoginToTiddlySpace: تسجيل الدخول إلى تدلي سبيس
 
 Manager/Controls/FilterByTag/None: (بلا)

package/languages/ca-ES/ControlPanel.multids

@@ -17,6 +17,8 @@ Basics/NewJournal/Title/Prompt: Títol dels nous tiddlers del diari
 Basics/NewTiddler/Tags/Prompt: Etiquetes dels nous tiddlers
 Basics/NewTiddler/Title/Prompt: Títol dels nous tiddlers
 Basics/OverriddenShadowTiddlers/Prompt: Número de tiddlers ombra sobreescrits:
+Basics/RemoveTags: Actualitza al format actual
+Basics/RemoveTags/Hint: Actualitza la configuració de les etiquetes al format actual
 Basics/ShadowTiddlers/Prompt: Número de tiddlers ombra:
 Basics/Subtitle/Prompt: Subtítol:
 Basics/SystemTiddlers/Prompt: Número de tiddlers del sistema:
@@ -44,6 +46,7 @@ KeyboardShortcuts/Platform/NonMac: Només per a les plataformes No Macintosh
 KeyboardShortcuts/Platform/NonWindows: Només per a les plataformes No Windows
 KeyboardShortcuts/Platform/Windows: Només per a la plataforma Windows
 KeyboardShortcuts/Remove/Hint: suprimeix la drecera del teclat
+LayoutSwitcher/Caption: Disposició
 LoadedModules/Caption: Mòduls carregats
 LoadedModules/Hint: Aquests són els mòduls tiddlers enllaçats als seus tiddlers font. Els mòduls indicats en cursiva no disposen de tiddler font, sovint per que s'han configurat a l'arrencada.
 Palette/Caption: Paleta
@@ -71,7 +74,7 @@ Plugins/ClosePluginLibrary: tanca la biblioteca de connectors
 Plugins/Disable/Caption: desactiva
 Plugins/Disable/Hint: Desactiva aquest connector quan la pàgina es torni a carregar
 Plugins/Disabled/Status: (desactivat)
-Plugins/Downgrade/Caption: seactualitza
+Plugins/Downgrade/Caption: desactualitza
 Plugins/Empty/Hint: Cap
 Plugins/Enable/Caption: activa
 Plugins/Enable/Hint: Activa aquest connector quan la pàgina es torni a carregar

package/languages/ca-ES/EditTemplate.multids

@@ -2,6 +2,8 @@ title: $:/language/EditTemplate/
 
 Body/External/Hint: Aquest és un tiddler extern desat fora del fitxer del TiddlyWiki principal. Podeu editar les etiquetes i camps però no podeu editar directament el seu contingut
 Body/Placeholder: Escriviu el text per aquest tiddler
+Body/Preview/Type/DiffCurrent: diferències respecte l'actual
+Body/Preview/Type/DiffShadow: diferències respecte de l'ombre (si hi ha)
 Body/Preview/Type/Output: resultat
 Field/Dropdown/Caption: llista de camps
 Field/Dropdown/Hint: Mostra la llista de camps
@@ -19,6 +21,8 @@ Shadow/Warning: Aquest és un tiddler ombra. Qualsevol canvi sobreescriurà la v
 Tags/Add/Button: afegeix
 Tags/Add/Button/Hint: afegeix una etiqueta
 Tags/Add/Placeholder: nom de l'etiqueta
+Tags/ClearInput/Caption: neteja
+Tags/ClearInput/Hint: Neteja l'etiqueta
 Tags/Dropdown/Caption: llista d'etiquetes
 Tags/Dropdown/Hint: Mostra la llista d'etiquetes
 Title/BadCharacterWarning: Avís: eviteu qualsevol dels caràcters <<bad-chars>> al títol d'un tiddler

package/languages/ca-ES/Help/notfound.tid

@@ -1,4 +1,4 @@
 title: $:/language/Help/notfound
 description: 
 
-Aquest tema d'ajuda no es troba
+No podem trobar aquest tema d'ajuda

package/languages/ca-ES/Import.multids

@@ -1,7 +1,9 @@
 title: $:/language/Import/
 
+Editor/Import/Heading: Importa imatges i afegeix-les a l'editor.
 Imported/Hint: S'han importat els següents tiddlers:
 Listing/Cancel/Caption: Anul·la
+Listing/Cancel/Warning: Voley anul·lar la importació?
 Listing/Hint: Aquests tiddlers estàn llestos per a ser importats
 Listing/Import/Caption: Importa
 Listing/Preview: Vista prèvia:
@@ -9,6 +11,11 @@ Listing/Preview/Diff: Diferències
 Listing/Preview/DiffFields: Diferències (Camps)
 Listing/Preview/Fields: Camps
 Listing/Preview/TextRaw: Text (Cru)
+Listing/Rename/CancelRename: Anul·la
+Listing/Rename/ConfirmRename: Canvia el nom del tiddler
+Listing/Rename/OverwriteWarning: Ja existeix un tiddler amb aquest nom.
+Listing/Rename/Prompt: Canvia el nom a:
+Listing/Rename/Tooltip: Canvia el nom del tiddler abans d'importar
 Listing/Select/Caption: Trieu
 Listing/Status/Caption: Estat
 Listing/Title/Caption: Títol
@@ -17,6 +24,10 @@ Upgrader/Plugins/Suppressed/Version: Connector bloquejat (degut a que la nova ve
 Upgrader/Plugins/Upgraded: Connector actualitzat de <<entrant>> a <<actualitzat>>
 Upgrader/State/Suppressed: Tiddler temporalment bloquejat
 Upgrader/System/Alert: Esteu a punt d’importar un tiddler que sobreescrigui un tiddler del nucli central. Això no és recomanable, ja que pot fer que el sistema sigui inestable
+Upgrader/System/Disabled: Tiddler del sistema inhabilitat
 Upgrader/System/Suppressed: Tiddler del sistema bloquejat
 Upgrader/System/Warning: Tiddler del nucli central
 Upgrader/ThemeTweaks/Created: Tema migrat des de <$text text=<<desde>>/>
+Upgrader/Tiddler/Disabled: Tiddler inhabilitat
+Upgrader/Tiddler/Selected: Triat pel usuari
+Upgrader/Tiddler/Unselected: Tiddler no triat.