Template:Dialog/safe/doc
This is a documentation subpage for Template:Dialog/safe It may contain usage information, categories and other content that is not part of the original template page. |
This is a dialog formatting template. It is meant for use on interactive dialog pages, and may involve interactions between wiki markup, HTML, and JavaScript. Please carefully test any edits before making them. |
This template is used on approximately 1,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template converts certain wiki formatting characters in its parameter to numeric html entity references.
Usage
editApply this template to strings output by the template expansion process, that will be converted to html but are meant to remain relatively unaffected by the conversion. The conversion still alters the string somewhat. To bypass the conversion altogether, use {{dialog/init}}.
- {{dialog/safe}} returns a "safe" version of string, by substituting html entity references for certain characters that have format meaning in wiki markup. As of this writing, the characters are
- < > = [ ] * # : '
- Note, this list does not include characters that affect parsing of wiki markup, but don't affect the subsequent conversion to html:
- { } |
- These parsing characters (and some of the others) are significant when a dialog parameter is being injected into the template expansion process, and are dealt with there by replacing them with template calls — to templates {{(*}}, {{*)}}, {{!}}, etc., so that the expansion process returns those characters to their original forms.
Internals
editThe characters substituted for are designated by a Scribunto ustring pattern.
See also
edit