ਫਰਮਾ: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)
*<code>lang</code> parameter: defines the language of the text, e.g. <code>mn</code> for Mongolian, <code>mnc</code> for Manchu, and <code>sjo</code> for Sibe; also used for switching font families by language
*<code>style</code> parameter: defines extended style of the text area, e.g. <code>height:50px</code> 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 <code>font-size</code>, <code>line-height</code>, and <code>display</code> 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 ====
:* <code>MQT</code>=[[Menksoft]]'s <code>Menk Qagan Tig</code>, is a font for Hudum, Todo, Manchu and Sibe, with full Ali-Gali support;
:* <code>MW</code>=[[Almas]]'s <code>Mongolian White</code>, is a font for Hudum and Todo, with some Ali-Gali support;
:* <code>MB</code>=[[Founder Group|Founder]]-[[Microsoft]]'s <code>Mongolian Baiti</code>, is a font for Hudum, Todo, Manchu and Sibe, with some Ali-Gali support;
:* <code>MU</code>=[[Monotype Drawing Office]]'s <code>Mongol Usug</code>, is a font for Hudum and Todo;
:* <code>MS</code>=[[Myatav Erdenechimeg]]'s <code>MongolianScript</code>, is a font for Hudum only;
:* <code>DW</code>=<code>[[Daicing]] White</code>, also known as <code>Abkai Xanyan</code>, is a font for Manchu, Sibe and Daur.
# Little issues are found in <code>MQT</code>;
# Final k/g ATR- rendering issues are found in all fonts except <code>MQT</code> and <code>MS</code>, but Erdenechimeg said her font was an early draft and does not met current Unicode standards;
# <code>MU</code> does not follow Unicode Standardized Variants (by ''ad hoc'' rendering FVS1~3) in many cases;
# <code>MB</code> 5.00 does not match Unicode Standard, please upgrade it to <code>MB</code> 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 <code>MB</code> 5.01 and <code>MU</code> 2.37;
# {{MongolUnicode|valign=middle|ᡓ‍}} is incorrectly rendered as {{MongolUnicode|valign=middle|ᠴ‍}} in <code>MU</code> 2.37;
# <code>MB</code> 5.01 does not render {{MongolUnicode|valign=middle|ᡯᡳ}} correctly (we may use {{MongolUnicode|valign=middle|ᡯᡳ᠌}} instead in <code>MB</code>).

==Template data==
{{Template data header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Text",
			"description": "The Mongolian text to display",
			"type": "content",
			"required": true
		},
		"2": {
			"label": "Direction",
			"description": "Whether to display the text horizontal (default) or vertical",
			"type": "string",
			"suggestedvalues": [
				"h",
				"v"
			],
			"default": "h",
			"suggested": true
		},
		"lang": {
			"aliases": [
				"3"
			],
			"label": "Language",
			"description": "The language of the text as a ISO 639 language code",
			"example": "mn",
			"type": "string",
			"suggestedvalues": [
				"mn",
				"mnc",
				"sjo",
				"khk",
				"mvf"
			],
			"suggested": true
		},
		"display": {
			"deprecated": true
		},
		"font-weight": {},
		"font-size": {},
		"line-height": {},
		"vertical-align": {
			"aliases": [
				"valign"
			]
		},
		"style": {
			"label": "CSS style",
			"description": "Defines extended style of the text area, e.g. height:50px 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).",
			"type": "string"
		}
	},
	"paramOrder": [
		"1",
		"2",
		"lang",
		"display",
		"font-weight",
		"font-size",
		"line-height",
		"vertical-align",
		"style"
	],
	"description": "Intended for use with text written in the Unicode \"Mongolian\" script, to improve display of this text in browsers.",
	"format": "inline"
}
</templatedata>

== See also ==
* [[Mongolian script#Unicode]]
* {{tl|ManchuSibeUnicode}}

<includeonly>{{Sandbox other||
[[Category:Mongolian language|Template]]
[[Category:Script–font templates|MScript/MongolUnicode]]<!-- 'name' for sort purposes only -->
}}</includeonly>