Where do pragmas end?

#1

https://tiddlywiki.com/#Pragmas tells me that pragmas appear at the start of the text of a tiddler, but I have problems (from code perspective) understanding where they end.

If I have a tiddler containing pragmas followed by other wikitext code, is there a silver bullet filter operator or macro or something to split it into two distinct parts: the pragmas block and the rest?

Looking for last \end string in the tiddler and splitting by it is not correct, since it can be found in a string variable way deep down in the wikitext code that follows the pragmas header. As I’ve recently learned (painfully, but hopefully lasting because of it), \end markers also have an optional suffix. And oneliners like functions don’t have an \end marker at all, so this is not a good pattern to look for either.

#2

Usually pragmas are valid within 1 tiddler. They can not be imported. Core internally they are separated from wikitext so you can not find them in variables.

What exactly do you try to achieve?

#3

Every definition can be a 1 liner. It is not limited to functions. Eg. The following code is perfectly valid.

\define test() some text in define
\procedure test-1() one liner in procedure

“Named” \end xyz markers are mandatory if functions or procedures are nested. They are optional for standard definitions.

#4

What exactly do you try to achieve?

Perhaps I did not pick the best wording. I am thinking around this example Is it possible to remove duplicate wikitext code when showing both codeblocks and the result of rendering them? - #2 by RolandH where the transclusion widget is called with two parameters: definitions and demoCode. I am wondering if it is possible to rewrite this to accept just one parameter - the whole code block - and parse it into definitions and demoCode inside the template code. These are two distinct pieces of a string - the header is the definitions and the footer is the actual code that uses them. But I don’t understand how to find where the definitions part ends.

#5

IMO you should use: \procedure wikitext-example-without-html(src) from https://tiddlywiki.com/#%24%3A%2Feditions%2Ftw5.com%2Fwikitext-macros

We do use it a lot to describe TW code. Within the src variable you can use pragmas, procedure and function definitions and also use them.

Usage pattern see: https://tiddlywiki.com/#Pragma%3A%20\procedure

2 Likes