Want to take part in these discussions? Sign in if you have an account, or apply for one below
Vanilla 1.1.10 is a product of Lussumo. More Information: Documentation, Community Support.
I added a section to HowTo about making floating TOCs. However, the [[!include ...]]
in the sample code got parsed and included the contents page into HowTo, unless I broke it up somehow. Is there a way to tell instiki not to parse an !include
?
Working from memory, you can surround something wiki-ish that you don’t want parsed in <nowiki> ... </nowiki>
pseudo-tags. (Check the instiki instiki to be sure - google “instiki golem” if you can’t find a link somewhere nearby, that’s what I always do.)
I’ve tried a bunch of things, including nowiki, at the bottom of the Sandbox page and none of them work.
EDIT: at very bottom I fake things by wrapping it in ’pre’ tags and then I use ampersand #33; to put in the exclamation mark.
fixed HowTo using ’pre’ tags.
I didn’t realise that it was in the middle of a code block, sorry. That complicates matters because the include stuff is done by a separate parser and happens before markdown gets its hands on the code block. So there are complicated interactions between the two parsers, what they see and what they ignore, to deal with. Although this may well be one of those situations where one bites the bullet and uses raw XHTML syntax, just for future reference there is a way to do it and as it involves a useful trick to know about, I’ve changed HowTo to do it this way.
The trick is to know that the markdown parser treats named entities and numbered entities as syntactically different. At least, it does when it encounters them in code blocks. A numbered entity is escaped but a named entity is converted to its correct character. Don’t ask me why it does this, but it’s a useful thing to know about and a useful feature in cases like this so I’m not complaining! So although !
gets escaped and you should just see the raw entity code, !
doesn’t get escaped and you see just !
. So to put the include syntax in a code block, I wrote [[!include category theory - contents]]
.
(Note that the parser on the forum isn’t so sophisticated: it escapes everything in code blocks.)
Huh! Thanks.
1 to 6 of 6