View source for Help:CharInsert

{{Wikipedia how to|H:CI}}
{{for|the toolbar that shows above the edit window|Help:Edit toolbar}}
'''CharInsert''' is an editing tool that shows under the edit window and allows the insertion of various characters and symbols that may be difficult to add from the keyboard.

== Menus ==
{{hatnote|These menus are copied from the interface pages and may not match precisely if those pages are changed.}}

=== Insert ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text">
'''Copy and paste:''' – — ° ′ ″ ≈ ≠ ≤ ≥ ± − × ÷ ← → · § &nbsp; '''Sign your posts on talk pages:''' <nowiki>~~~~</nowiki> &nbsp; '''Cite your sources:''' <nowiki><ref></ref></nowiki>
</div>

The listed symbols are:
{| class="wikitable"
| –|| [[dash#En dash|en dash]]||≠|| [[inequality (mathematics)|not equal to]]||÷|| [[obelus]]
|-
| —|| [[dash#Em dash|em dash]]||≤|| [[inequality (mathematics)|less than or equal to]]||←|| [[arrow (symbol)|left arrow]]
|-
| °|| [[degree symbol|degree]]||≥|| [[inequality (mathematics)|greater than or equal to]]||→|| [[arrow (symbol)|right arrow]]
|-
| ′|| [[prime (symbol)|prime]]||±|| [[plus-minus sign]]||·|| [[interpunct]]
|-
| ″|| [[prime (symbol)|double prime]]||−|| [[plus and minus signs#Minus sign|minus sign]]||§|| [[section sign]]
|-
| ≈|| [[approximation|approximately equal]] ||×|| [[multiplication sign]]|| ||
|}

=== [[Help:Wikitext|Wiki markup]] ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
<nowiki>{{}}</nowiki> &nbsp; <nowiki>{{{}}}</nowiki> &nbsp; | &nbsp; <nowiki>[]</nowiki> &nbsp; <nowiki>[[]]</nowiki> &nbsp; <nowiki>[[Category:]]</nowiki> &nbsp; <nowiki>#REDIRECT [[]]</nowiki> &nbsp; &amp;nbsp; &nbsp; &lt;s>&lt;/s> &nbsp; &lt;sup>&lt;/sup> &nbsp; &lt;sub>&lt;/sub> &nbsp; &lt;code>&lt;/code> &nbsp; &lt;pre>&lt;/pre> &nbsp; &lt;blockquote>&lt;/blockquote> &nbsp; &lt;ref>&lt;/ref> &lt;ref name="" /> &nbsp; <nowiki>{{Reflist}}</nowiki> &nbsp; &lt;references /> &nbsp; &lt;includeonly>&lt;/includeonly> &nbsp; &lt;noinclude>&lt;/noinclude> &nbsp; <nowiki>{{DEFAULTSORT:}}</nowiki> &nbsp; &lt;nowiki>&lt;/nowiki> &nbsp; &lt;!-- --> &nbsp; &lt;span class="plainlinks">&lt;/span>
</small></div>

=== Symbols ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
'''Symbols:''' ~ | ¡ ¿ † ‡ ↔ ↑ ↓ • ¶ &nbsp; # ∞ &nbsp; ‘ ’ “ ” ‹› «» &nbsp; ¤ ₳ ฿ ₵ ¢ ₡ ₢ $ ₫ ₯ € ₠ ₣ ƒ ₴ ₭ ₤ ℳ ₥ ₦ № ₧ ₰ £ ៛ ₨ ₪ ৳ ₮ ₩ ¥ &nbsp; ♠ ♣ ♥ ♦ &nbsp; ♭ ♯ ♮ &nbsp; © ® ™
</small></div>

=== Latin ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
A a Á á À à Â â Ä ä Ǎ ǎ Ă ă Ā ā Ã ã Å å Ą ą Æ æ Ǣ ǣ &nbsp; B b &nbsp; C c Ć ć Ċ ċ Ĉ ĉ Č č Ç ç &nbsp; D d Ď ď Đ đ Ḍ ḍ Ð ð &nbsp; E e É é È è Ė ė Ê ê Ë ë Ě ě Ĕ ĕ Ē ē Ẽ ẽ Ę ę Ẹ ẹ Ɛ ɛ Ǝ ǝ Ə ə &nbsp; F f &nbsp; G g Ġ ġ Ĝ ĝ Ğ ğ Ģ ģ &nbsp; H h Ĥ ĥ Ħ ħ Ḥ ḥ &nbsp; I i İ ı Í í Ì ì Î î Ï ï Ǐ ǐ Ĭ ĭ Ī ī Ĩ ĩ Į į Ị ị &nbsp; J j Ĵ ĵ &nbsp; K k Ķ ķ &nbsp; L l Ĺ ĺ Ŀ ŀ Ľ ľ Ļ ļ Ł ł Ḷ ḷ Ḹ ḹ &nbsp; M m Ṃ ṃ &nbsp; N n Ń ń Ň ň Ñ ñ Ņ ņ Ṇ ṇ Ŋ ŋ &nbsp; O o Ó ó Ò ò Ô ô Ö ö Ǒ ǒ Ŏ ŏ Ō ō Õ õ Ǫ ǫ Ọ ọ Ő ő Ø ø Œ œ &nbsp; Ɔ ɔ &nbsp; P p &nbsp; Q q &nbsp; R r Ŕ ŕ Ř ř Ŗ ŗ Ṛ ṛ Ṝ ṝ &nbsp; S s Ś ś Ŝ ŝ Š š Ş ş Ș ș Ṣ ṣ ß &nbsp; T t Ť ť Ţ ţ Ț ț Ṭ ṭ Þ þ &nbsp; U u Ú ú Ù ù Û û Ü ü Ǔ ǔ Ŭ ŭ Ū ū Ũ ũ Ů ů Ų ų Ụ ụ Ű ű Ǘ ǘ Ǜ ǜ Ǚ ǚ Ǖ ǖ &nbsp; V v &nbsp; W w Ŵ ŵ &nbsp; X x &nbsp; Y y Ý ý Ŷ ŷ Ÿ ÿ Ỹ ỹ Ȳ ȳ &nbsp; Z z Ź ź Ż ż Ž ž &nbsp; ß Ð ð Þ þ Ŋ ŋ Ə ə &nbsp; <nowiki>{{Unicode|}}</nowiki>
</small></div>

=== Greek ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
Ά ά Έ έ Ή ή Ί ί Ό ό Ύ ύ Ώ ώ &nbsp; Α α Β β Γ γ Δ δ &nbsp; Ε ε Ζ ζ Η η Θ θ &nbsp; Ι ι Κ κ Λ λ Μ μ &nbsp; Ν ν Ξ ξ Ο ο Π π &nbsp; Ρ ρ Σ σ ς Τ τ Υ υ &nbsp; Φ φ Χ χ Ψ ψ Ω ω &nbsp; <nowiki>{{Polytonic|}}</nowiki>
</small></div>

For tables showing Greek letters with all existing combinations of diacritics, see {{section link|Greek diacritics|Unicode}}.

=== Cyrillic ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
А а Б б В в Г г &nbsp; Ґ ґ Ѓ ѓ Д д Ђ ђ &nbsp; Е е Ё ё Є є Ж ж &nbsp; З з Ѕ ѕ И и І і &nbsp; Ї ї Й й Ј ј К к &nbsp; Ќ ќ Л л Љ љ М м &nbsp; Н н Њ њ О о П п &nbsp; Р р С с Т т Ћ ћ &nbsp; У у Ў ў Ф ф Х х &nbsp; Ц ц Ч ч Џ џ Ш ш &nbsp; Щ щ Ъ ъ Ы ы Ь ь &nbsp; Э э Ю ю Я я &nbsp;
</small></div>

=== Hebrew ===
<!-- Copied from [[MediaWiki:Gadget-charinsert-core.js]]. If something is wrong here, get it fixed there first. -->
This section shows only for the JavaScript version of CharInsert.

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
אבגדהוזחטיכךלמםנןסעפףצץקרשת  ׳ ״  װױײ

</small></div>

=== Arabic ===
<!-- Copied from [[MediaWiki:Gadget-charinsert-core.js]]. If something is wrong here, get it fixed there first. -->
This section shows only for the JavaScript version of CharInsert.

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
<bdi>ا ﺁ ب ت ث ج ح خ د ذ ر ز س ش ص ض ط ظ ع غ ف ق ك ل م ن ه ة و ي ى ء أ إ ؤ ئ</bdi> Transliteration: ʾ ṯ ḥ ḫ ẖ ḏ š ṣ ḍ ṭ ẓ ʿ ġ ẗ
</small></div>

=== IPA (English) ===
<!-- Copied from [[MediaWiki:Gadget-charinsert-core.js]]. If something is wrong here, get it fixed there first. -->
This section shows only for the JavaScript version of CharInsert.

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
ˈ ˌ ŋ ɡ tʃ dʒ ʃ ʒ θ ð ʔ  iː ɪ uː ʊ ʌ ɜr eɪ ɛ æ oʊ ɒ ɔː ɔɪ ɔr ɑː ɑr aɪ aʊ  ə ər ɨ ɵ ʉ <nowiki>{{angle.bracket|}}</nowiki> <nowiki>{{IPAc-en|}}</nowiki> <nowiki>{{IPA-en|}}</nowiki> <nowiki>{{IPA|}}</nowiki>
</small></div>

For the pronunciation of these symbols, see [[Help:IPA/English]].

=== IPA ===
<!-- Copied from [[MediaWiki:Edittools]]. If something is wrong here, get it fixed there first. -->

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
t̪ d̪ ʈ ɖ ɟ ɡ ɢ ʡ ʔ &nbsp; ɸ β θ ð ʃ ʒ ɕ ʑ ʂ ʐ ç ʝ ɣ χ ʁ ħ ʕ ʜ ʢ ɦ &nbsp; ɱ ɳ ɲ ŋ ɴ &nbsp; ʋ ɹ ɻ ɰ &nbsp; ʙ ⱱ ʀ ɾ ɽ &nbsp; ɫ ɬ ɮ ɺ ɭ ʎ ʟ &nbsp; ɥ ʍ ɧ &nbsp; ʼ &nbsp; ɓ ɗ ʄ ɠ ʛ &nbsp; ʘ ǀ ǃ ǂ ǁ &nbsp; ɨ ʉ ɯ &nbsp; ɪ ʏ ʊ &nbsp; ø ɘ ɵ ɤ &nbsp; ə ɚ &nbsp; ɛ œ ɜ ɝ ɞ ʌ ɔ &nbsp; æ &nbsp; ɐ ɶ ɑ ɒ &nbsp; ʰ ʱ ʷ ʲ ˠ ˤ ⁿ ˡ &nbsp; ˈ ˌ ː ˑ ̪ &nbsp; <nowiki>{{IPA|}}</nowiki>
</small></div>

The listed symbols are:
{{col-begin}}
{{col-break}}
{| class="wikitable"
| t̪ d̪ || [[voiceless dental stop|voiceless]] and [[voiced dental stop]]s
|-
| ʈ ɖ || [[voiceless retroflex stop|voiceless]] and [[voiced retroflex stop]]s
|-
| ɟ ɡ ɢ || [[voiced palatal stop|voiced palatal]], [[voiced velar stop|velar]], and [[voiced uvular stop|uvular stops]]
|-
|  ʡ ʔ || [[epiglottal stop|epiglottal]] and [[glottal stop]]s
|-
| ɸ β || [[voiceless bilabial fricative]]<br>and [[voiced bilabial fricative|voiced bilabial fricative or approximant]]
|-
| θ ð || [[voiceless dental fricative]]<br>and [[voiced dental fricative|voiced dental fricative or approximant]]
|-
| ʃ ʒ || [[voiceless palato-alveolar sibilant|voiceless]] and [[voiced palato-alveolar sibilant]]s
|-
| ɕ ʑ || [[voiceless alveolo-palatal sibilant|voiceless]] and [[voiced alveolo-palatal sibilant]]s
|-
| ʂ ʐ || [[voiceless retroflex sibilant|voiceless]] and [[voiced retroflex sibilant]]s
|-
| ç ʝ || [[voiceless palatal fricative|voiceless]] and [[voiced palatal fricative]]s
|-
| ɣ || [[voiced velar fricative]]
|-
| χ ʁ || [[voiceless uvular fricative]]<br>and [[voiced uvular fricative|voiced uvular fricative or approximant]]
|-
| ħ ʕ || [[voiceless pharyngeal fricative]]<br>and [[voiced pharyngeal fricative|voiced pharyngeal fricative or approximant]]
|-
| ʜ ʢ || [[voiceless epiglottal fricative]]<br>and [[voiced epiglottal fricative|voiced epiglottal fricative or approximant]]
|-
| ɦ || [[voiced glottal fricative]]
|-
| ɱ ɳ ɲ ŋ ɴ || [[labiodental nasal|labiodental]], [[retroflex nasal|retroflex]], [[palatal nasal|palatal]], [[velar nasal|velar]], and [[uvular nasal]]s
|-
| ʋ || [[labiodental approximant]]
|-
| ɹ ɻ ɰ || [[alveolar approximant|alveolar]], [[retroflex approximant|retroflex]], and [[velar approximant]]s
|-
| ʙ ⱱ || [[bilabial trill]] and [[bilabial flap|flap]]
|-
| ʀ || [[uvular trill]]
|-
| ɾ ɽ || [[alveolar flap|alveolar]] and [[retroflex flap]]
|-
| ɫ || [[Alveolar lateral approximant#Velarized alveolar lateral approximant|velarized or pharyngealized alveolar lateral approximant]]
|-
| ɬ ɮ || [[voiceless alveolar lateral fricative|voiceless]] and [[voiced alveolar lateral fricative]]
|-
| ɺ || [[alveolar lateral flap]]
|-
| ɭ ʎ ʟ || [[retroflex lateral approximant|retroflex]], [[palatal lateral approximant|palatal]], and [[velar lateral approximant]]s
|-
| ɥ || [[labialized palatal approximant]]
|}
{{col-break}}
{| class="wikitable"
|-
| ʍ || [[voiceless labio-velar approximant]]
|-
| ɧ || [[sj-sound]]
|-
| ʼ || [[ejective consonant]]
|-
| ɓ ɗ ʄ ɠ ʛ || [[voiced bilabial implosive|voiced bilabial]], [[voiced alveolar implosive|alveolar]], [[voiced palatal implosive|palatal]], [[voiced velar implosive|velar]], and [[voiced uvular implosive|uvular implosive]]
|-
| ʘ ǀ ǃ ǂ ǁ || [[bilabial click|bilabial]], [[dental click|dental]], [[alveolar click|alveolar]], [[palatal click|palatal]], and [[lateral click]]s
|-
| ɨ ʉ || [[close central unrounded vowel|close central unrounded]] and [[close central rounded vowel|rounded vowels]]
|-
| ɯ || [[close back unrounded vowel]]
|-
| ɪ ʏ || [[near-close near-front unrounded vowel|near-close near-front unrounded]] and [[near-close near-front rounded vowel|rounded vowels]]
|-
| ʊ || [[near-close near-back rounded vowel]]
|-
| ø || [[close-mid front rounded vowel]]
|-
| ɘ ɵ || [[close-mid central unrounded vowel|close-mid central unrounded]] and [[close-mid central rounded vowel|rounded vowels]]
|-
| ɤ || [[close-mid back unrounded vowel]]
|-
| ə ɚ || [[mid-central vowel]] or [[schwa]] and [[r-colored vowel|r-colored schwa]]
|-
| ɛ œ || [[close-mid front unrounded vowel|close-mid front unrounded]] and [[close-mid front rounded vowel|rounded vowels]]
|-
| ɜ ɝ || [[close-mid central unrounded vowel]] and [[r-colored vowel|r-colored version]]
|-
| ɞ || [[close-mid central rounded vowel]]
|-
| ʌ ɔ || [[close-mid back unrounded vowel|close-mid back unrounded]] and [[close-mid back rounded vowel|rounded vowels]]
|-
| æ ɐ || [[near-open front unrounded vowel|near-open front]] and [[near-open central vowel|central vowels]]
|-
| ɶ || [[open front rounded vowel]]
|-
| ɑ ɒ || [[open back unrounded vowel|open back unrounded]] and [[open back rounded vowel|rounded vowels]]
|-
| ʰ ʱ || [[aspirated consonant|aspirated]] and [[breathy voice|breathy-voiced consonants]]
|-
| ʷ || [[labialized consonant]]
|-
| ʲ || [[palatalized consonant]]
|-
| ˠ ˤ || [[velarization|velarized]] and [[pharyngealization|pharyngealized consonants]]
|-
| ⁿ ˡ || [[lateral release (phonetics)|lateral]] and [[nasal release]]
|-
| ˈ ˌ || [[stress (linguistics)|primary and secondary stress]]
|-
| ː ˑ || [[vowel length|long or half-long vowel]] or [[gemination|consonant]]
|-
|  ̪ || [[dental consonant]]
|-
| <nowiki>{{IPA|}}</nowiki> || generic IPA template
|}
{{col-end}}

=== Math and logic ===
<!-- Copied from [[MediaWiki:Gadget-charinsert-core.js]]. If something is wrong here, get it fixed there first. -->
This section shows only for the JavaScript version of CharInsert.

<div style="margin-top: 15px; border: 1px solid #aaaaaa; padding: 2px;" class="edittools-text"><small>
− × ÷ ⋅ ° ∗ ∘ ± ∓ ≤ ≥ ≠ ≡ ≅ ≜ ≝ ≐ ≃ ≈ ⊕ ⊗ ⇐ ⇔ ⇒ ∞ ← ↔ → ≪ ≫ ∝ √ ∤ ≀ ◅ ▻ ⋉ ⋊ ⋈ ∴ ∵ ↦ ¬ ∧ ∨ ⊻ ∀ ∃ ∈ ∉ ∋ ⊆ ⊈ ⊊ ⊂ ⊄ ⊇ ⊉ ⊋ ⊃ ⊅ ∪ ∩ ∑ ∏ ∐ ′ ∫ ∬ ∭ ∮ ∇ ∂ ∆ ∅ ℂ ℍ ℕ ℙ ℚ ℝ ℤ ℵ ⌊ ⌋ ⌈ ⌉ ⊤ ⊥ ⊢ ⊣ ⊧ □ ∠ ⟨ ⟩ <nowiki><math></math></nowiki> <nowiki>{{math|}}</nowiki> <nowiki>{{mvar|}}</nowiki> <nowiki>{{frac|}}</nowiki> <nowiki>{{sfrac|}}</nowiki>
</small></div>

== Customization ==
To add custom entries, adapt this code, and place it in [[special:mypage/common.js|your common.js]]:
<syntaxhighlight lang="javascript">
// Add custom CharInsert entries
window.charinsertCustom = {
 "Insert": ' Mention: {\{u|+}}  {\{ping|+}}',
};
</syntaxhighlight>
that will append the {{tl|u}} and {{tl|ping}} code to the Insert menu.
* In this example, <code>"Insert":</code> is the name of the menu the new markup is being added to; it is enclosed in quotes<code>"</code> followed by a colon <code>:</code>; to create a new menu simply use a new name
* In this example, <code>Mention:</code> is a heading within the entries; anything ending in a colon is a heading; use an underscore <code>_</code> to replace a space
* The content within the single quotes <code><nowiki>' '</nowiki></code> is the new markup; use a dot <code>.</code> to replace a space; the entry may need to be enclosed within {{tag|nowiki}} to prevent it from being parsed
* <code>+</code> is where your cursor will appear after the text is inserted, or if you already have text highlighted when you click them then that text will be properly surrounded by the markup
* For multiple menus, end all lines with a comma <code>,</code> except for the last line
* To include a single literal <code>\</code> use ''four'' backslashes <code>\\\\</code> (this will appear as double-\ on menu display.); for example <code><nowiki><math>\\\\scriptstyle{+}</math></nowiki></code>.
* Add a newline as <code>\n</code>
* These available operators can be derived from the source code [[MediaWiki:Gadget-charinsert-core.js]]: function <code>createTokens</code>

To add multiple entries to a menu, enclose them all in the single quotes and separate them with a space:
<syntaxhighlight lang="javascript">
// Add custom CharInsert entries
window.charinsertCustom = {
 "Insert": '<code>+</code> <code><nowiki>+</nowiki></code>',
};
</syntaxhighlight>

To add entries to multiple menus:
<syntaxhighlight lang="javascript">
// Add custom CharInsert entries
window.charinsertCustom = {
 "Insert": ' Mention: {\{u|+}}  {\{ping|+}}',
 "Wiki markup": ' Mention: {\{u|+}}  {\{ping|+}}'
};
</syntaxhighlight>

To create a new menu, use a new name:
<syntaxhighlight lang="javascript">
// Add custom CharInsert entries
window.charinsertCustom = {
 'Insert2': ' – — ° ′ ″ ≈ ≠ ≤ ≥ ± − × ÷ ← → · §  <code>+</code> <code><nowiki>+</nowiki></code>'
};
</syntaxhighlight>

To copy entries from one menu to another, browse to [[MediaWiki:Edittools]] and click on edit. You can copy any entry and paste it into your customized menu.

Other entries that may be useful:
* <code><nowiki><poem></poem></nowiki></code>
* <code><nowiki><syntaxhighlight.lang="css">\n+\n</syntaxhighlight></nowiki></code>
* <code>'CSS': ' style="+" margin:.1em.auto; text-align:.center; margin-left:.auto; margin-right:.auto; width:."+%"; background-color:.#+; '</code>

== Issues ==

If CharInsert does not show: 

In the Interface section: (Wikisource)

* Ensure {{myprefs|Gadgets|<b>site</b>}} is checked. The General utilities needed by the templates and portals of this wiki project.

In the Editing tools section:

* Ensure {{myprefs|Gadgets|CharInsert}} is checked. The tool uses JavaScript by default. Check your various JavaScript configurations at {{myprefs|appearance}}. If an invalid entry is added, it will break all uses of JS but since JS is enabled it will not fallback to [[MediaWiki:Edittools]]. Personal JS pages will now show an error on save if there is an invalid entry, so an attempt to edit and save will point out issues.

== Technical ==
If JavaScript is enabled, then CharInsert is added as a Gadget defined at [[MediaWiki:Gadget-charinsert.js]] which uses JavaScript to load CharInsert from [[MediaWiki:Gadget-charinsert-core.js]]. The Gadget is enabled by default  but can be disabled through {{myprefs|gadgets|CharInsert}}.

If JavaScript is disabled, then the [[mw:Extension:CharInsert|CharInsert]] software extension is called, which uses the symbols defined at [[MediaWiki:Edittools]]. Not all of the symbol sets are included in MediaWiki:Edittools. This mode is also used if the  bits server fails to yield all the needed Javascript and CSS.

For discussion, see [[MediaWiki talk:Edittools]].

{{Wikipedia technical help|collapsed}}
[[Category:Wikipedia edit window help]]
[[Category:Wikipedia editing]]