View source for Template:Contains special characters/doc

{{Documentation subpage}}
{{High-use}}
{{Uses TemplateStyles|Template:Contains special characters/styles.css}}
This template flags potential font/encoding issues for users when an article contains text which may not be rendered correctly on out-of-the-box installations of current operating systems.

Use this only in articles in which the presence of [[Help:Special characters|special characters]] is likely to confuse readers of affected articles; it is not needed on articles where special characters are ordinarily expected (mathematics articles, for instance).

== Usage ==
Place at the top of affected articles, below any infobox. Specific languages have pre-programmed values installed in "Contains special characters" that hard-code the following (as appropriate for that language, see list [[#Languages|below]]).

{| class="wikitable"
|+ 
! scope="col" | Code
! scope="col" | Renders as
|-
! colspan=2 | Typical implementations, with generally useful values:
|-
|
<syntaxhighlight lang="wikitext">
{{Contains special characters
| special    = uncommon [[Unicode]] characters
| fix        = Help:Multilingual support
| error      = [[Specials (Unicode block)#Replacement character|question marks, boxes, or other symbols]]
| characters = the intended characters
| image      = Replacement character.svg
| link       = Specials (Unicode block)#Replacement character
| alt        = <?>
| compact    = 
}}
</syntaxhighlight>
|
{{Contains special characters
| special    = uncommon [[Unicode]] characters
| fix        = Help:Multilingual support
| error      = [[Specials (Unicode block)#Replacement character|question marks, boxes, or other symbols]]
| characters = the intended characters
| image      = Replacement character.svg
| link       = Specials (Unicode block)#Replacement character
| alt        = <?>
| compact    = 
}}
|-
|
<syntaxhighlight lang="wikitext">
{{Contains special characters
| special    = uncommon [[Unicode]] characters
| fix        = Help:Multilingual support
| image      = Replacement character.svg
| link       = Specials (Unicode block)#Replacement character
| alt        = <?>
| compact    = yes
}}
</syntaxhighlight>
|
{{Contains special characters
| special    = uncommon [[Unicode]] characters
| fix        = Help:Multilingual support
| image      = Replacement character.svg
| link       = Specials (Unicode block)#Replacement character
| alt        = <?>
| compact    = yes
}}
|-
! colspan=2 | Language-specific simplification
|-
|
<syntaxhighlight lang="wikitext">
{{Contains special characters|Armenian}}
</syntaxhighlight>
|{{contains special characters|Armenian}}
|-
|
<syntaxhighlight lang="wikitext">
{{Contains special characters|Runic|section}}
</syntaxhighlight>
|{{contains special characters|Runic|section}}
|-
|
<syntaxhighlight lang="wikitext">
{{Contains special characters|Baybayin|compact=yes}}
</syntaxhighlight>
|{{contains special characters|Baybayin|compact=yes}}
|}

===Parameters===
; <code>|special=</code>: The languages or special content the page includes. This is the text immediately after "This page contains".  Free-form, so you can specify as many as you like. Remember to link to the articles for the characters / languages.
; <code>|fix=</code>: The "rendering support" link to a page with the solution (installing fonts, etc.). This should just be the title of the fix page, unlinked. This should usually be <code>[[Help:Multilingual support]]</code> unless you have something more specific to point to for a particular language or use case (e.g. <code>[[Help:IPA#Rendering issues]]</code>, used in the {{tlx|Contains special characters|IPA}} variant of this template).
; <code>|error=</code>: (optional; {{em|must}} be given a value or omitted entirely) The type of rendering error that will observed without the required support. Free-form wikicode, and will appear between "you may see" and "instead of". Defaults to: <code><nowiki>[[Specials (Unicode block)#Replacement character|question marks, boxes, or other symbols]]</nowiki></code>, though <code><nowiki>''[[mojibake]]''</nowiki></code> may be good for East Asian languages.
; <code>|characters=</code>: The specific type of characters that might be missing (i.e. [[kanji]], [[kana]]). This is the final wording of the template, after "instead of". Free-form, remember to use links, if not already linked in {{para|special}}. The entire "instead of" clause will not appear if this is blank (i.e., the template will end with the wording of {{para|error}} or its default value).
; <code>|section=</code>: (optional) By default, this display "article" in an article and "page" on all other pages. You can manually specify a replacement for that word, usually {{para|section|section}}, but other values might be <code>list</code> or <code>table</code>.  Note: The "{{para|section|y}}" syntax does not work; it will output the letter "y". <small>[[Template:YesNo|Support for that option]] can be added if it is desired.</small>
; <code>|image=</code>: (optional) Just the title (no <code>File:</code> or <code>Image:</code> prefix) of an image of the characters, ideally legible at 65x50px and either square or slightly wider than tall.  The template defaults to blank, but a reasonable suggestion for many circumstances is [[:File:Replacement character.svg|Replacement character.svg]]: [[File:Replacement character.svg|20px]], which can be given an {{para|alt=&lt;?&gt;}} description. (This is the default replacement character on Windows systems.)
; <code>|alt=</code>: (optional) The alt text for the image, for visually-impaired readers. See [[WP:ALT]]. If the image is merely some text, the alt text should simply repeat that text.
; <code>|link=</code>: (optional) Name of the article that the image should link to. This should just be the title of the page, unlinked, usually <code>Specials (Unicode block)#Replacement character</code>, but perhaps <code>Mojibake</code> for East Asian languages.  By default, the image is considered to be purely decorative and does not link to any article. If this parameter is specified, the '''alt''' parameter should also be specified.
; <code>|width=</code>: (unusually unused) The default width of the image is <code>22em</code>. This can be made larger with this parameters, for a very small character, or considerably smaller for a short word.
; <code>|compact=y</code>: (optional) If set to any value, it will display a shorter form of the standard text, to save space. It suppresses display of the values of {{para|characters}} and {{para|error}} (so having an image {{para|link}} that goes to the same page as {{para|error}} is particularly useful, in case someone later turns on the {{para|compact|y}} feature.

===Languages===
The following languages have hard-coded values, removing the necessity of the above {{slink||Parameters}}. Note that {{para|section}} and {{para|compact}} are available for use even if the language is specified.

{| class="wikitable"
|+ "Simplified" languages available for direct input
|-
! Language parameter !! Template rendering !! Examples of characters in question
|-
| {{tlf|Contains special characters|AA}}
| style="padding-right:1.2em;" | {{Contains special characters|AA}}
| <syntaxhighlight lang="wikitext" style="font-family:'MS PGothic',ＭＳ Ｐゴシック,IPAMonaPGothic,Mona;font-size:12pt">
　　＿＿＿_∧∧
～'　＿＿__(,,ﾟДﾟ)
　 ＵU 　 　Ｕ U
</syntaxhighlight>

|-
| {{tlf|Contains special characters|APL}}
| style="padding-right:1.2em;" | {{Contains special characters|APL}}
| {{code|⍟⍋⌹⋆⍕⍀←⌽⍳⍝|apl}}
|-
| {{tlf|Contains special characters|Armenian}}
| style="padding-right:1.2em;" | {{Contains special characters|Armenian}}
| Ծծ
|-
| {{tlf|Contains special characters|Balinese}}
| style="padding-right:1.2em;" | {{Contains special characters|Balinese}}
| ᬅᬓ᭄ᬱᬭᬩᬮᬶ
|-
| {{tlf|Contains special characters|Baluchi}}
| style="padding-right:1.2em;" | {{Contains special characters|Baluchi}}
| بلوچی
|-
| {{tlf|Contains special characters|Baybayin}}
| style="padding-right:1.2em;" | {{Contains special characters|Baybayin}}
| ᜊᜌ᜔ᜊᜌᜒᜈ᜔ᜊᜇ᜔ᜎᜒᜆ᜔
|-
| {{tlf|Contains special characters|Braille}}
| style="padding-right:1.2em;" | {{Contains special characters|Braille}}
| ⠞⠑⠭⠞
|-
| {{tlf|Contains special characters|Burmese}}
| style="padding-right:1.2em;" | {{Contains special characters|Burmese}}
| မြန်မာအက္ခရာ
|-
| {{tlf|Contains special characters|Canadian}}
| style="padding-right:1.2em;" | {{Contains special characters|Canadian}}
| ᐇᑹᑹᓓᓔᔔᕧᗶᙥᙶᙽ
|-
| {{tlf|Contains special characters|Cherokee}}
| style="padding-right:1.2em;" | {{Contains special characters|Cherokee}}
| Ꮂ
|-
| {{tlf|Contains special characters|Coptic}}
| style="padding-right:1.2em;" | {{Contains special characters|Coptic}}
| {{Coptic|Ϣϣ}}
|-
| {{tlf|Contains special characters|cuneiform}}
| style="padding-right:1.2em;" | {{Contains special characters|cuneiform}}
| 𒅇𒀉𒆤𒈿𒅅𒄠𒅈𒅕𒄑𒌦
|-
| {{tlf|Contains special characters|Deseret}}
| style="padding-right:1.2em;" | {{Contains special characters|Deseret}}
| 𐐔𐐯𐑅𐐨𐑉𐐯𐐻 𐐔𐐯𐑆𐐲𐑉𐐯𐐻
|-
| {{tlf|Contains special characters|emoticon}}
| style="padding-right:1.2em;" | {{Contains special characters|emoticon}}
| ⏰❤️🍉😂😩🛶☃✌❽🥇🏝️👧🏾
|-
| {{tlf|Contains special characters|Ethiopic}}
| style="padding-right:1.2em;" | {{Contains special characters|Ethiopic}}
| ሀለበተኀነ𐩠𐩡ዘየደገጠ𐩴𐩮𐩰
|-
| {{tlf|Contains special characters|Georgian}}
| style="padding-right:1.2em;" | {{Contains special characters|Georgian}}
| ქართული
|-
| {{tlf|Contains special characters|Glagolitic}}
| style="padding-right:1.2em;" | {{Contains special characters|Glagolitic}}
| Ⱋ
|-
| {{tlf|Contains special characters|Gothic}}
| style="padding-right:1.2em;" | {{Contains special characters|Gothic}}
| 𐌺
|-
| {{tlf|Contains special characters|Hebrew}}
| style="padding-right:1.2em;" | {{Contains special characters|Hebrew}}
| ק
|-
| {{tlf|Contains special characters|Hindko}}
| style="padding-right:1.2em;" | {{Contains special characters|Hindko}}
| بثجچشظعقگلمھے
|-
| {{tlf|Contains special characters|Hokkien}}
| style="padding-right:1.2em;" | {{Contains special characters|Hokkien}}
| Pe̍h-ōe-jī
|-
| {{tlf|Contains special characters|Indic}}
| style="padding-right:1.2em;" | {{Contains special characters|Indic}}
| ग्रा
|-
| {{tlf|Contains special characters|Javanese}}
| style="padding-right:1.2em;" | {{Contains special characters|Javanese}}
| ꦲꦏ꧀ꦱꦫꦗꦮ
|-
| {{tlf|Contains special characters|Karen}}
| style="padding-right:1.2em;" | {{Contains special characters|Karen}}
| ကညီလံာ်ခီၣ်ထံး
|-
| {{tlf|Contains special characters|Khmer}}
| style="padding-right:1.2em;" | {{Contains special characters|Khmer}}
| ភាសាខ្មែរ
|-
| {{tlf|Contains special characters|Khoekhoe}}
| style="padding-right:1.2em;" | {{Contains special characters|Khoekhoe}}
|ǃne
|-
| {{tlf|Contains special characters|Lao}}
| style="padding-right:1.2em;" | {{Contains special characters|Lao}}
| ພາສາລາວ
|-
| {{tlf|Contains special characters|Lanna}}<br>{{tlf|Contains special characters|Northern Thai}}
| style="padding-right:1.2em;" | {{Contains special characters|Lanna}}
| ᨣᩴᩤᨾᩮᩬᩥᨦ
|-
| {{tlf|Contains special characters|Lontara}}
| style="padding-right:1.2em;" | {{Contains special characters|Lontara}}
| ᨒᨚᨈᨑ
|-
| {{tlf|Contains special characters|Manchu}}
| style="padding-right:1.2em;" | {{Contains special characters|Manchu}}
| {{ManchuSibeUnicode|ᠮᠠᠨᠵᡠ<br>ᡤᡳᠰᡠᠨ}}
|-
| {{tlf|Contains special characters|Meitei}}
| style="padding-right:1.2em;" | {{Contains special characters|Meitei}}
| ꯃꯩꯇꯩ ꯃꯌꯦꯛ
|-
| {{tlf|Contains special characters|Mongolian}}
| style="padding-right:1.2em;" | {{Contains special characters|Mongolian}}
| {{MongolUnicode|ᠮᠣᠩᠭᠣᠯ}} {{MongolUnicode|ᠪᠢᠴᠢᠭ}}
|-
| {{tlf|Contains special characters|Nom}}
| style="padding-right:1.2em;" | {{Contains special characters|Nom}}
| 𡨸喃
|-
| {{tlf|Contains special characters|Ogham}}
| style="padding-right:1.2em;" | {{Contains special characters|Ogham}}
| ᚁᚂᚃᚄᚅᚆᚇᚈᚉᚊᚋᚌᚍᚎᚏᚐᚑᚒᚓᚔᚕᚖᚗᚘᚙᚚ᚛᚜
|-
| {{tlf|Contains special characters|Old Hungarian}}
| style="padding-right:1.2em;" | {{Contains special characters|Old Hungarian}}
| 𐲀𐲄𐲅𐲆𐲇𐲍𐲎𐲜𐲝𐲞𐲟𐲠𐳄𐳅𐳥𐳦𐳧𐳨𐳱𐳲𐳺𐳾𐳿
|-
| {{tlf|Contains special characters|Old Persian}}
| style="padding-right:1.2em;" | {{Contains special characters|Old Persian}}
| 𐎠𐎣𐎤𐎫𐎬𐎭𐎮𐎳𐎴𐎵𐏊𐏋𐏏𐏐𐏑𐏕
|-
| {{tlf|Contains special characters|Ottoman Turkish}}
| style="padding-right:1.2em;" | {{Contains special characters|Ottoman Turkish}}
| ا‎ـا‎ء‎بـ‎ـ‎پـ‎ت‎ـت‎ـضـ‎ظ‎ـظ‎ـغـ‎ف‎ـقـ‎قـ‎ـ‎گـ‎ل‎ـم‎ـمـنـ‎نـ‎ـه‎ـهـ‎ـی‎ـیـ‎
|-
| {{tlf|Contains special characters|Pashto}}
| style="padding-right:1.2em;" | {{Contains special characters|Pashto}}
| ﺍپﺕﺙﺝچﺩﺭﺱښﻁﻕکﻡﻥيئ
|-
| {{tlf|Contains special characters|Perso-Arabic}}
| style="padding-right:1.2em;" | {{Contains special characters|Perso-Arabic}}
| چ
|-
| {{tlf|Contains special characters|PIE}}
| style="padding-right:1.2em;" | {{Contains special characters|PIE}}
| l̥
|-
| {{tlf|Contains special characters|Runic}}
| style="padding-right:1.2em;" | {{Contains special characters|Runic}}
| ᚱᚢᚾᛟᚠᚥᛊᛋᛌᛍᛓᛔᛤᛥᛨᛩᛪ᛫᛭ᛮᛯᛰᛴᛵᛸ
|-
| {{tlf|Contains special characters|Saraiki}}
| style="padding-right:1.2em;" | {{Contains special characters|Saraiki}}
| ابٹخدڊڈزژسصضعغقکمنھے
|-
| {{tlf|Contains special characters|Shavian}}
| style="padding-right:1.2em;" | {{Contains special characters|Shavian}}
| 𐑮𐑰𐑮𐑲𐑑𐑦𐑙
|-
| {{tlf|Contains special characters|SignWriting}}
| style="padding-right:1.2em;" | {{Contains special characters|SignWriting}}
| 𝠀𝠁𝠂𝠥𝠧𝡩𝡪𝡫𝣶𝪛𝣷𝣸𝣺𝦙𝦚𝦛𝩆𝩈𝩉
|-
| {{tlf|Contains special characters|Sindhi}}
| style="padding-right:1.2em;" | {{Contains special characters|Sindhi}}
| सिन्धी ਸਿੰਧੀ سنڌي
|-
| {{tlf|Contains special characters|Sundanese}}
| style="padding-right:1.2em;" | {{Contains special characters|Sundanese}}
| ᮃᮊ᮪ᮞᮞᮥᮔ᮪ᮓ°ᮂ᮸᳅
|-
| {{tlf|Contains special characters|Syriac}}
| style="padding-right:1.2em;" | {{Contains special characters|Syriac}}
| ܐܠܦ ܒܝܬ ܣܘܪܝܝܐ
|-
| {{tlf|Contains special characters|Tamil}}
| style="padding-right:1.2em;" | {{Contains special characters|Tamil}}
| தமிழ் அரிச்சடி
|-
| {{tlf|Contains special characters|Tangut}}
| style="padding-right:1.2em;" | {{Contains special characters|Tangut}}
| 𗃰𗁼𗀪𘄠𘢓𘫖
|-
| {{tlf|Contains special characters|Thai}}
| style="padding-right:1.2em;" | {{Contains special characters|Thai}}
| ม
|-
| {{tlf|Contains special characters|Tibetan}}
| style="padding-right:1.2em;" | {{Contains special characters|Tibetan}}
| ༁༂༖༗ཆཇླྀཹྪྫ࿂࿃࿘࿙
|-
| {{tlf|Contains special characters|Tifinagh}}
| style="padding-right:1.2em;" | {{Contains special characters|Tifinagh}}
| ⴰⴲⴸⴹⴺⴻⴼⴽⵃⵈⵏⵐⵞⵟⵥⵯ⵰
|-
| {{tlf|Contains special characters|Tirhuta}}
| style="padding-right:1.2em;" | {{Contains special characters|Tirhuta}}
| 
|-
| {{tlf|Contains special characters|Ugaritic}}
| style="padding-right:1.2em;" | {{Contains special characters|Ugaritic}}
|
|-
| {{tlf|Contains special characters|Urdu}}
| style="padding-right:1.2em;" | {{Contains special characters|Urdu}}
| اردو تہجی
|-
| {{tlf|Contains special characters|Uyghur}}
| style="padding-right:1.2em;" | {{Contains special characters|Uyghur}}
| ئۇيغۇر يېزىقى
|-
| {{tlf|Contains special characters|Vietnamese}}
| style="padding-right:1.2em;" | {{Contains special characters|Vietnamese}}
| ự
|-
| {{tlf|Contains special characters|Warang Citi}}
| style="padding-right:1.2em;" | {{Contains special characters|Warang Citi}}
| 
|-
| {{tlf|Contains special characters|IPA}}
| style="padding-right:1.2em;" | {{Contains special characters|IPA}}
| ʈʰul
|-
| {{tlf|Contains special characters|Uncommon Unicode}}
| style="padding-right:1.2em;" | {{Contains special characters|Uncommon Unicode}}
| {{N/a}}
|}

==See also==
{{Unicode templates}}
<includeonly>{{Sandbox other||
[[Category:Language maintenance templates]]
[[Category:Wikipedia multilingual support templates]]

}}</includeonly>