Difference between revisions of "HTML Entities"
From Roll20 Wiki
Andreas J. (Talk | contribs) m |
m (added percentage sign) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
{{main|Macro Guide}} | {{main|Macro Guide}} | ||
| − | [[HTML]] Entities can be useful to escape HTML characters so they aren't processed prematurely. This is useful in creating [[macros]], [[Building Character Sheets]], and [[Help:Contents|wiki editing]]. | + | '''[[HTML]] Entities''' (a.k.a. ''HTML Escape Characters'') can be useful to escape HTML characters so they aren't processed prematurely. This is useful in creating [[macros]], [[Building Character Sheets]], and [[Help:Contents|wiki editing]]. |
<onlyinclude> | <onlyinclude> | ||
When creating some complicated [[macros]], usually involving [[Nesting|nesting]], you will need to use [https://www.w3schools.com/html/html_entities.asp HTML entities] in parts of the code to trick the Roll20 system to make it behave like you want, or some advanced tricks won't work. | When creating some complicated [[macros]], usually involving [[Nesting|nesting]], you will need to use [https://www.w3schools.com/html/html_entities.asp HTML entities] in parts of the code to trick the Roll20 system to make it behave like you want, or some advanced tricks won't work. | ||
| − | Here are some HTML Entities that are commonly useful to escape when creating advanced Roll20 macros. See [https://www.freeformatter.com/html-entities.html HTML Entities] or [https://www.html.am/reference/html-special-characters.cfm special character] for more: | + | Here are some HTML Entities/Escape Characters that are commonly useful to escape when creating advanced Roll20 macros. See [https://www.freeformatter.com/html-entities.html HTML Entities] or [https://www.html.am/reference/html-special-characters.cfm special character] for more: |
<div style="float:right">{{notebox| '''<code>|</code>''', '''<code>}</code>''', and '''<code>,</code>''' are the most common character that need to be replaced in nested macros.}}</div> | <div style="float:right">{{notebox| '''<code>|</code>''', '''<code>}</code>''', and '''<code>,</code>''' are the most common character that need to be replaced in nested macros.}}</div> | ||
::{| class="wikitable" | ::{| class="wikitable" | ||
| Line 13: | Line 13: | ||
! Character || Replacement | ! Character || Replacement | ||
|- | |- | ||
| − | | <code>|</code> (pipe) || <code>&#124;</code> | + | | <code>|</code> (pipe) || <code>&#124;</code>, (<code>&vert;</code>) |
|- | |- | ||
| − | | <code>,</code>|| <code>&#44;</code> | + | | <code>,</code>|| <code>&#44;</code>, (<code>&comma;</code>) |
|- | |- | ||
| <code>{</code>|| <code>&#123;</code>, (<code>&lbrace;</code>) | | <code>{</code>|| <code>&#123;</code>, (<code>&lbrace;</code>) | ||
| Line 25: | Line 25: | ||
| <code>space</code> || <code>&#160;</code>, (<code>&nbsp;</code>) | | <code>space</code> || <code>&#160;</code>, (<code>&nbsp;</code>) | ||
|- | |- | ||
| − | | <code>=</code> || <code>&#61;</code> | + | | <code>=</code> || <code>&#61;</code>, (<code>&equals;</code>) |
|- | |- | ||
| − | | <code>_</code> || <code>&#95;</code> | + | | <code>_</code> || <code>&#95;</code>, (<code>&lowbar;</code>) |
|- | |- | ||
| − | | <code><nowiki>(</nowiki></code> || <code>&#40;</code> | + | | <code><nowiki>(</nowiki></code> || <code>&#40;</code>, (<code>&lpar;</code>) |
|- | |- | ||
| − | | <code><nowiki>)</nowiki></code> || <code>&#41;</code> | + | | <code><nowiki>)</nowiki></code> || <code>&#41;</code>, (<code>&rpar;</code>) |
|- | |- | ||
| <code><nowiki>[</nowiki></code> || <code>&#91;</code>, (<code>&lbrack;</code>) | | <code><nowiki>[</nowiki></code> || <code>&#91;</code>, (<code>&lbrack;</code>) | ||
| Line 37: | Line 37: | ||
| <code><nowiki>]</nowiki></code> || <code>&#93;</code>, (<code>&rbrack;</code>) | | <code><nowiki>]</nowiki></code> || <code>&#93;</code>, (<code>&rbrack;</code>) | ||
|- | |- | ||
| − | | <code><nowiki><</nowiki></code> || <code>&#60;</code>, (<code>&lt;</code>) | + | | <code><nowiki><</nowiki></code> || <code>&#60;</code>, (<code>&lt;</code>) |
|- | |- | ||
| <code><nowiki>></nowiki></code> || <code>&#62;</code>, (<code>&gt;</code>) | | <code><nowiki>></nowiki></code> || <code>&#62;</code>, (<code>&gt;</code>) | ||
|- | |- | ||
| − | | <code><nowiki>`</nowiki></code>(backtick, grave accent) || <code>&#96;</code> | + | | <code><nowiki>`</nowiki></code>(backtick, grave accent) || <code>&#96;</code>, (<code>&grave;</code>) |
|- | |- | ||
| − | | {{c|*}}(asterisk)|| <code>&#42;</code> | + | | {{c|*}}(asterisk)|| <code>&#42;</code>, (<code>&ast;</code>) |
|- | |- | ||
| − | | {{c|!}} || <code>&#33;</code> | + | | {{c|!}} || <code>&#33;</code>, (<code>&excl;</code>) |
|- | |- | ||
| − | | {{c|"}}(doublequote)|| <code>&#34;</code> | + | | {{c|"}}(doublequote)|| <code>&#34;</code>, (<code>&quot;</code>) |
|- | |- | ||
| − | | {{c|#}} || <code>&#35;</code> | + | | {{c|#}} || <code>&#35;</code>, (<code>&num;</code>) |
|- | |- | ||
| − | | {{c|-}}(hyphen) || <code>&#45;</code> | + | | {{c|-}}(hyphen) || <code>&#45;</code>, (<code>&dash;</code>) |
|- | |- | ||
| − | | {{c|@}} || <code>&#64;</code> | + | | {{c|@}} || <code>&#64;</code>, (<code>&commat;</code>) |
| + | |- | ||
| + | | {{c|%}} || <code>&#37;</code>, (<code>&percnt;</code>) | ||
|} | |} | ||
</onlyinclude> | </onlyinclude> | ||
| Line 72: | Line 74: | ||
</pre> | </pre> | ||
| − | == | + | ==Nested Query Improvement== |
| + | An fix for macros to not needing to use HTML Entities for nested macros was tried in 2021{{source|https://app.roll20.net/forum/permalink/10260308/}}, but it was seemingly shelved at some point. There might be new try with this as part of Jumpgate updates. [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 11:40, 28 September 2024 (UTC) | ||
| + | |||
[https://app.roll20.net/forum/permalink/10260308/ Now on Dev Server: Roll Query Improvements!] July 20th, 2021 | [https://app.roll20.net/forum/permalink/10260308/ Now on Dev Server: Roll Query Improvements!] July 20th, 2021 | ||
| − | + | Some, if not all, character substitutions might become redundant, when roll20 improves nested [[Dice Reference/Roll Query|Roll Query]] handling in macros. | |
:''Now on the [[Dev Server]]({{Pro}}-users) for testing, improved roll query parsing!'' | :''Now on the [[Dev Server]]({{Pro}}-users) for testing, improved roll query parsing!'' | ||
Latest revision as of 17:36, 6 October 2024
 | Page Updated: 2024-10-06 |
Macro Creation
- Complete Guide to Macros & Rolls
- q Text Chat
- Dice Reference
- Order of Operations
- Macros
- Token Reference
- Character Reference
- Roll Templates
- Roll Table
Advanced
- Formatting
- HTML Replacement
- Chat Menus
- Hidden Rolls
- Advanced Macro Tips
- API Commands
- Char Sheet Creation
- External tools
Misc.
Main Page: Macro Guide
HTML Entities (a.k.a. HTML Escape Characters) can be useful to escape HTML characters so they aren't processed prematurely. This is useful in creating macros, Building Character Sheets, and wiki editing.
When creating some complicated macros, usually involving nesting, you will need to use HTML entities in parts of the code to trick the Roll20 system to make it behave like you want, or some advanced tricks won't work.
Here are some HTML Entities/Escape Characters that are commonly useful to escape when creating advanced Roll20 macros. See HTML Entities or special character for more:
 | |, }, and , are the most common character that need to be replaced in nested macros. |
Character Replacement |(pipe)|, (|),,, (,){{, ({)}}, (})&&, (&)space , ( )==, (=)__, (_)((, (())), ())[[, ([)]], (])<<, (<)>>, (>)`(backtick, grave accent)`, (`)*(asterisk)*, (*)!!, (!)"(doublequote)", (")##, (#)-(hyphen)-, (‐)@@, (@)%%, (%)
[edit] Examples
Main Page: Roll Queries & Nesting
By using HTML entities to replace all } inside "Choose a Roll", it will now correctly process where the query ends. This is essentially to prevent the Roll Query from closing at the first } it encounters.
?{Choose a Roll|
STR,/roll 1d20 + 3 + (?{Modifier}) |
DEX,/roll 1d20 + 2 + (?{Modifier}) |
CON,/roll 1d20 + 1 + (?{Modifier}) }
If your query options contains |, you need to replace them to prevent the query thinking it's a delimiter between options.
?{Pick a pair|Alice|Bob|Bob|Charlie}
[edit] Nested Query Improvement
An fix for macros to not needing to use HTML Entities for nested macros was tried in 2021, but it was seemingly shelved at some point. There might be new try with this as part of Jumpgate updates. Andreas J. (talk) 11:40, 28 September 2024 (UTC)Now on Dev Server: Roll Query Improvements! July 20th, 2021
Some, if not all, character substitutions might become redundant, when roll20 improves nested Roll Query handling in macros.
- Now on the Dev Server(Proinfo-users) for testing, improved roll query parsing!
- Recently, an update to our character sheet code broke a workaround that some sheets were using to implement nested roll queries. Rather than fixing this workaround, we did a little extra work to properly support nested queries. Now, you should be able to nest roll queries inside of each other without needing to use any character codes.
