Gabrys wrote on 30 Dec 2009 13:51
Purpose: the purpose of universal escaping is ability to display ANY text in browser. Now it's almost possible using @@, but you can't easily put @@ inside of such text. You can put almost any text inside of [[code]] block, but you can't put there [[/code]] and so…
The proposed solution is to introduce two new syntax entities: @< and >@. Between them you can put any text provided you first:
- convert each "&" to "&"
- convert each "<" to "<"
- convert each ">" to ">"
(this is also known as HTML escaping).
This will work for single lines only. This means if you have a block of a few lines to escape, you need to escape each line in the block separately.
Using this technique, you can put ANY text on your site, for example:
|---------------------------|----------------------------|
| What you want: | What you write to get it: |
|---------------------------|----------------------------|
| code @@ example | @<code @@ example>@ |
| @@code example@@ | @<@@code example@@>@ |
| @<code example>@ | @<@<code example>@>@ |
|---------------------------|----------------------------|
You can also put so called HTML entities (including all UTF-8 characters) inside of "@<" and ">@", like "©", to get the copyright sign ("©") without searching for it in a char table or in the Internet.
Live example:
@<U umlaut: ü>@
@<[[code]]>@
@<Hello world @@ !!!!>@
@<Something **not** bold>@
@<[[module ListPages]]>@
@<Copyright sign: ©>@
@<[[/code]]>@
Works @<inline as>@ well
This way you can escape universal escaping tokens: @<@<>@ and @<>@>@
In action:
U umlaut: ü
[[code]]
Hello world @@ !!!!
Something **not** bold
[[module ListPages]]
Copyright sign: ©
[[/code]]
Works inline as well
This way you can escape universal escaping tokens: @< and >@
http://www.wikidot.com/doc:wiki-syntax
Also, there seems to be a problem on that page under "Typography" that resulted from this feature being implemented:
The 'you type' column actually uses the double-@ syntax like this:
But it results in @<quotation>@ instead of the expected <<quotation>>
~ Leiger - Wikidot Community Admin - Volunteer
Wikidot: Official Documentation | Wikidot Discord server | NEW: Wikiroo, backup tool (in development)
Thanks for pointing this out. Corrected as suggested.
Piotr Gabryjeluk
visit my blog
Just realised that Universal Escaping had already been added to that page, a full day ago! So the title of my post 'This needs to be added to the Wikidot syntax page' was wrong :)
~ Leiger - Wikidot Community Admin - Volunteer
Wikidot: Official Documentation | Wikidot Discord server | NEW: Wikiroo, backup tool (in development)