Hi JeanPierre, 

There isn't too much docs about pragmas[1], because the \rules pragma can 
have unexpected side effects, if you don't know the underlying parser 
process well. 

TW has many wikitext - rules: https://tiddlywiki.com/#WikiText

Every one of them has 1 or 2 core javascript modules [2] associated. They 
have a module-type: wikirule. A wikirule can be a "block" or "inline" type. 
eg: 
<<< 
blockquote
<<<
... is one of them. https://tiddlywiki.com/#Block%20Quotes%20in%20WikiText

The associated js-name is: quoteblock 

So there are the following pragma rules that can be used for blockquote

\rules only quoteblock 
or
\rules except quoteblock 

So if you use \rules only in a tiddler, the *only* rule the will be 
detected is the blockquote wikitext rule. 
If you use \rules except, all wikitext rules will be active, *except* the 
blockquote. 

only and except are 2 basic parameters that are allowed for the \rules 
pragma. 

Every rule can have several wiki-rule names. eg: The one you linked to [3]

\rules only filteredtranscludeinline transcludeinline macrodef 
macrocallinline html 

The rule above only uses the defined wikitext rules and deactivates all 
others. .. This mechanism is heavily used in the rendering templates, that 
is used by the TW save mechanism. ... It allows us to control the parsing 
mechanism on an almost "per wiki-rule" basis. ... 

The downside is, that you need to know the parser code quite well. eg: 

\rules only quoteblock

! heading

<<<
test
<<<

>asdf

Will only render the test text as a blockquote. The asdf text will be plain 
text, because the associated name is: list [4]

list handles:  *  #  ;  :  > ... So if you use \rules only list ... you'll 
get all of them. 

The other names can be found, if you look at the source code of every 
single rule that is module-type: wikirule and looks similar to the 
quteblock [5] code. 

I hope this helps. have fun!
mario

[1] https://tiddlywiki.com/#Pragma
[2] https://tiddlywiki.com/dev/#WikiRuleModules
[3] https://tiddlywiki.com/static/Using%2520Stylesheets.html
[4] 
https://github.com/Jermolene/TiddlyWiki5/blob/master/core/modules/parsers/wikiparser/rules/list.js
[5] 
https://github.com/Jermolene/TiddlyWiki5/blob/b9647b2c48152dac069a1099a0822b32375a66cf/core/modules/parsers/wikiparser/rules/quoteblock.js#L38-L39
 


-- 
You received this message because you are subscribed to the Google Groups 
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/585e97dc-9ac2-49ca-91ad-bead9a230283n%40googlegroups.com.

Reply via email to