Template:Korean/doc

From the AARoads Wiki: Read about the road before you go
Jump to navigation Jump to search

Purpose

This template organizes Korean scripts and romanizations for use within article prose. It formats Korean Hangul and hanja using Template:Lang to ensure that web browsers use appropriate fonts, and screen readers use correct pronunciation. It also uses Template:Transl to mark romanizations as belonging in the "latinx" class of MediaWiki:Common.css.

Usage

Parameters

Only the first parameter is required

hangul
Required
hanja
Optional
rr
The Revised Romanization
mr
McCune–Reischauer romanization; to be used in place of |rr= in articles about North Korea
context=north
Deprecated; for use in articles about North Korea; displayed "Hancha" instead of "Hanja" and "Chosŏn'gŭl" instead of "Hangul"
context=old
Deprecated; displayed Hunminjeongeum instead of "Hangul" or "Chosŏn'gŭl", was meant to be used in articles about events that occurred before the development of North and South Korea (pre-1945)
labels
Set to no to remove all labels. This is useful if the template is used multiple times in quick succession.
links
Set to no to remove the wikilinks from labels. This reduces overlinking in an article (see WP:OLINK)
lit
Allows for the inclusion of a literal English translation; should not be used for people's names

Note: This template should generally be placed in parentheses (see MOS:TEXT)

Full parameter set

{{Korean|hangul=|hanja=|rr=|mr=|links=|labels=|lit=}}

Typical usage:

{{Korean|hangul=|hanja=|rr=}}

Example:

{{Korean|hangul=대청황제공덕비|hanja=大淸皇帝功德碑|rr=Daechong Hwangje Gongdeokbi}}

will produce:

Korean대청황제공덕비; Hanja大淸皇帝功德碑; RRDaechong Hwangje Gongdeokbi

Alternatively, the template can be used without labels. This will produce the same output as above, but be careful to put the Hangul, hanja, and romanizations in the same order as you would if you were using the labels.

Label options

Add |labels=no anywhere in the template to disable labels, so only the text supplied as parameters appears, separated by semicolons. This minimises the length of the template, and can be used when the template is used more than once to lessen its impact. Disabling labels also suppresses links.

{{Korean|대청황제공덕비|大淸皇帝功德碑|Daechong Hwangje Gongdeokbi|labels = no}}
대청황제공덕비; 大淸皇帝功德碑; Daechong Hwangje Gongdeokbi

Add |links=no anywhere in the template to suppress label links. This is for preventing overlinking in an article or section where the template is used repeatedly.

{{Korean|대청황제공덕비|大淸皇帝功德碑|Daechong Hwangje Gongdeokbi|links = no}}
Korean: 대청황제공덕비; Hanja: 大淸皇帝功德碑; RRDaechong Hwangje Gongdeokbi

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Korean in articles based on its TemplateData.

TemplateData for Korean

<templatedata> { "params": { "labels": { "label": "Labels", "description": "Labels",

           "autovalue": "no",

"example": "no", "type": "string" }, "links": { "label": "Links", "description": "Links",

           "autovalue": "no",

"example": "no", "type": "string" }, "context": { "label": "Context", "description": "Context", "example": "north", "deprecated": true }, "hangul": { "label": "Korean characters", "type": "string", "suggested": true, "description": "Korean characters", "aliases": [ "1" ] }, "hanja": { "label": "Chinese characters", "type": "string", "suggested": true, "description": "Chinese characters", "aliases": [ "2" ] }, "mr": { "description": "McCune–Reischauer Romanization", "type": "string", "suggested": true, "label": "McCune–Reischauer Romanization", "aliases": [ "4" ] }, "rr": { "description": "Revised Romanization", "type": "string", "suggested": true, "label": "Revised Romanization", "aliases": [ "3" ] }, "lit": { "label": "Literal English translation", "description": "Literal English translation", "type": "string" } }, "description": "A template to facilitiate consistent layout, proper formatting, categorisation and language labelling of Korean text", "paramOrder": [ "hangul", "hanja", "rr", "mr", "labels", "links", "context", "lit" ], "format": "inline" } </templatedata>

See also