View source for Template:MongolUnicode/doc

{{Documentation subpage}}
{{COinS safe|n}}
{{Uses TemplateStyles|Template:MongolUnicode/fonts.css}}
<!-- Categories and interwikis go at the bottom of this page. -->

=== Usage ===
This template is intended for use with text written in the Unicode "Mongolian" script.  Note, the Unicode "Mongolian" script is a unification of the Mongolian, Todo, Manchu and Sibe scripts, so this template can be used for text written in various different languages, including varieties of Mongolian (Classical Mongolian, Halh [khk] and Peripheral Mongolian [mvf]), as well as Manchu [mnc] and Sibe [sjo].

*1st parameter is the Mongolian (Todo, Manchu, Sibe) text to display
*2nd parameter is optional; if it is 'h' then the text is laid out horizontally; if it is any other value (e.g. 'v'), or if it is omitted then the text is laid out vertically (if the browser supports vertical layout)
*<tt>lang</tt> parameter: defines the language of the text, e.g. <tt>mn</tt> for Mongolian, <tt>mnc</tt> for Manchu, and <tt>sjo</tt> for Sibe; also used for switching font families by language
*<tt>style</tt> parameter: defines extended style of the text area, e.g. <tt>height:50px</tt> limits the height as 50px, if the length of text is over than 50px, the rest of contents will align at the next column(s).
*In addition, you can override the defaults for <tt>font-size</tt>, <tt>line-height</tt>, and <tt>display</tt> using likewise named parameters.

If you have a long run of vertical Mongolian text (i.e. more than one or two words) embedded in a horizontal English paragraph, it will create a very large gap between lines, so it is best to break long vertical runs of Mongolian text into short word-lengthed chunks. This can be done by wrapping each Mongolian word in a separate MongolUnicode template, and separating each MongolUnicode template by a space character (if you omit the space character the Mongolian text will format correctly, but if a user copies the Mongolian text from the article the individual words will be concatenated into a single word).  Do not use <nowiki><br/></nowiki> to break vertical Mongolian runs for unnecessary purpose as this causes problems with browsers which do not support vertical layout.

=== Examples ===
*<code><nowiki>{{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌}}</nowiki></code> produces: {{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌}}
*<code><nowiki>{{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌|v}}</nowiki></code> produces: {{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌|v}}
*<code><nowiki>{{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌|h}}</nowiki></code> produces: {{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌|h}}
*<code><nowiki>{{MongolUnicode|ᠮᠣᠩᠭᠣᠯ}} {{MongolUnicode|ᠪᠢᠴᠢᠭ᠌|v}}</nowiki></code> produces: {{MongolUnicode|ᠮᠣᠩᠭᠣᠯ}} {{MongolUnicode|ᠪᠢᠴᠢᠭ᠌|v}}
*<code><nowiki>{{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌|style=height:50px}}</nowiki></code> produces: {{MongolUnicode|ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ᠌|style=height:50px}}
*<code><nowiki>{{MongolUnicode|ᠸᠢᠺᠢᠫᠧᠳᠢᠶᠠ|font-size=2em}}</nowiki></code> produces: {{MongolUnicode|ᠸᠢᠺᠢᠫᠧᠳᠢᠶᠠ|font-size=2em}}

=== Issues ===
Currently only Internet Explorer 8 and above, Edge, Firefox 41 and above, and Webkit browsers (Chrome, Safari, Opera 15.0+, Android native browser) support rendering the text in top-to-bottom, left-to-right format. Other browsers will render the text as left-to-right, top-to-bottom or don't connect the characters. See also:
* http://dev.w3.org/csswg/css3-writing-modes/
* https://bugzilla.mozilla.org/show_bug.cgi?id=145503
* https://developer.mozilla.org/en-US/docs/Web/CSS/writing-mode

For users of Firefox version 38.0–40.0 and Firefox 38 ESR based browsers, you need to open the <code>about:config</code> page, and set <code>layout.css.vertical-text.enabled</code> as <code>true</code> to enable it.

For MediaWiki issues regarding this: [[bugzilla:9436]]

==== Non-Font ====
When Daicing font set to be the EUDC, 
* ZERO WIDTH JOINER at the head-place does not work. 
* NIRUGU does not work.
* NARROW NO-BREAK SPACE does not work.

==== Font issues ====
:* <TT>MQT</TT>=[[Menksoft]]'s <TT>Menk Qagan Tig</TT>, is a font for Hudum, Todo, Manchu and Sibe, with full Ali-Gali support;
:* <TT>MW</TT>=[[Almas]]'s <TT>Mongolian White</TT>, is a font for Hudum and Todo, with some Ali-Gali support;
:* <TT>MB</TT>=[[Founder Group|Founder]]-[[Microsoft]]'s <TT>Mongolian Baiti</TT>, is a font for Hudum, Todo, Manchu and Sibe, with some Ali-Gali support;
:* <TT>MU</TT>=[[Monotype Drawing Office]]'s <TT>Mongol Usug</TT>, is a font for Hudum and Todo;
:* <TT>MS</TT>=[[Myatav Erdenechimeg]]'s <TT>MongolianScript</TT>, is a font for Hudum only;
:* <TT>DW</TT>=<TT>[[Daicing]] White</TT>, also known as <TT>Abkai Xanyan</TT>, is a font for Manchu, Sibe and Daur.
# Little issues are found in <TT>MQT</TT>;
# Final k/g ATR- rendering issues are found in all fonts except <TT>MQT</TT> and <TT>MS</TT>, but Erdenechimeg said her font was an early draft and does not met current Unicode standards;
# <TT>MU</TT> does not follow Unicode Standardized Variants (by ''ad hoc'' rendering FVS1~3) in many cases;
# <TT>MB</TT> 5.00 does not match Unicode Standard, please upgrade it to <TT>MB</TT> 5.01 (KB929763);
# Under certain situations {{MongolUnicode|valign=middle|‍ᠶ‍}} is incorrectly rendered as {{MongolUnicode|valign=middle|‍ᠢ‍}}<!--Middle form--> or {{MongolUnicode|valign=middle|ᠵ‍}}<!--Head form--> in <TT>MB</TT> 5.01 and <TT>MU</TT> 2.37;
# {{MongolUnicode|valign=middle|ᡓ‍}} is incorrectly rendered as {{MongolUnicode|valign=middle|ᠴ‍}} in <TT>MU</TT> 2.37;
# <TT>MB</TT> 5.01 does not render {{MongolUnicode|valign=middle|ᡯᡳ}} correctly (we may use {{MongolUnicode|valign=middle|ᡯᡳ᠌}} instead in <TT>MB</TT>).

=== See also ===
* [[Mongolian script#Unicode]]

<IncludeOnly>
<!-- Categories and interwikis go here: -->

</IncludeOnly>