编辑“︁Template:Unichar/doc”︁（章节）

== 给模板编辑者的说明 ==
The word "unichar" is used only in this English Wikipedia, as a name for this template. It has no meaning outside.<br>

=== 模板结构 ===
The template uses these subtemplates:
* {{tl|Unichar/main}} Accepts all the input from {{tlx|unichar}}. Calls several subtemplates to produce the textstrings, and then strings them together. Also checks for the error non-hex input.
* {{tl|unichar/ulink}} creates a piped link for the "U+" prefix.
* {{tl|unichar/gc}} determines the Unicode general category, when this category is special (like, for control characters).
* {{tl|unichar/glyph}} for rendering the glyph by font. Accepts "image=" that overrules the font. Uses also "use", "use2", "size", "cwith".
* {{tl|unichar/na}} Produces the formatted name of the character in {{Smallcaps|smallcaps}}. Accepts the "nlink=" to create a piped wikilink to an article. When the [[Unicode_character_property#General_Category|general category]] (gc) is special, the name will change into a <''label''-''hhhh''>.
* {{tl|unichar/notes}} - Produces the three optional notes in brackets: ''decimal value'', ''HTML-character reference'' (both decimal and by name like {{code|&amp;nbsp;}} if that exists using {{tlx|numcr2namecr}}) and the free text ''note'' as provided by the editor. Also does the brackets themselves.

* Using the main template as an input-easy feature, there are few calculations done (actually only two hex2dec), and allows for adding default values not too deep in the templates.

* The value "<#salted#>" is used internally to pass through a non-defined input parameter. This value is correct when about the Name, because a Unicode name cannot have the characters <##>, and so [[Salting the earth|salted]] is the right word (meaning uninhibitable). For ease of code maintenance it is used in more places around.

=== 实现方法 ===
<templatedata>
{
	"params": {
		"1": {
			"label": "碼位",
			"example": "031A",
			"type": "string",
			"required": true,
			"aliases": [
				"hval"
			],
			"description": "十六進制（HEX）Unicode碼位"
		},
		"2": {
			"label": "名稱",
			"type": "string",
			"suggested": true,
			"aliases": [
				"na"
			],
			"description": "Unicode字符名稱"
		},
		"ulink": {
			"label": "碼位連結",
			"description": "為十六進制（HEX）Unicode碼位添加連結",
			"type": "line"
		},
		"image": {
			"label": "圖示"
		},
		"cwith": {
			"label": "與字符組合",
			"description": "（僅適用於組合字符）在本組合字符之前添加下述字符：",
			"example": "◌",
			"type": "string"
		},
		"size": {
			"label": "大小",
			"description": "渲染所得字符的相對大小",
			"example": "200%",
			"type": "string"
		},
		"use": {
			"label": "使用",
			"type": "string"
		},
		"use2": {
			"label": "使用乙",
			"type": "string"
		},
		"nlink": {
			"label": "名稱連結",
			"description": "為Unicode字符名稱添加連結",
			"type": "string"
		},
		"dec": {
			"label": "十進制碼位",
			"type": "number",
			"description": "十進制（DEC）Unicode碼位"
		},
		"html": {
			"label": "HTML代碼",
			"description": "若勾選，則顯示帶名稱的HTML entity",
			"example": "html= shows \"&copy;\"",
			"type": "string"
		},
		"note": {
			"label": "備註",
			"type": "line"
		}
	},
	"paramOrder": [
		"1",
		"2",
		"ulink",
		"nlink",
		"cwith",
		"size",
		"image",
		"use",
		"use2",
		"dec",
		"html",
		"note"
	]
}
</templatedata>
=== 编辑注意 ===

=== 外部連結 ===
Useful links for researching Unicode characters:
* [http://unicode.org/charts/ Unicode charts], gives the chart (in PDF) on which the U+value is located.
* [http://www.fileformat.info/info/unicode/char/search.htm Fileformat.com search], to search by ''name'' (whole or partial), by U+ ''hex value'' or ''decimal value'', by the font ''symbol'' (copy-past it). Extra information per character.

<includeonly>
<!-- 本行下加入模板的分類 -->
[[Category:Unicode模板]]

<!-- 本行下加入模板的跨語言鏈接 -->
[[en:Template:Unichar]]
[[fr:Modèle:Unichar]]
[[km:ទំព័រគំរូ:Unichar]]
</includeonly>