Difference between revisions of "Template:Infobox language/doc"
m (1 revision imported) |
(Major overhaul to match the template.) |
||
Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> | <!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> | ||
− | |||
{{lua|Module:InfoboxImage|Module:Check for unknown parameters}} | {{lua|Module:InfoboxImage|Module:Check for unknown parameters}} | ||
− | This template | + | This template provides a common standard for displaying data about a language. |
=== Usage === | === Usage === | ||
This template accepts the following parameters: | This template accepts the following parameters: | ||
− | ;name:name of language #REQUIRED | + | ;name:name of language, simplest transliteration #REQUIRED |
− | ; | + | ;nativename:native transliteration of the language's name |
− | |||
;pronunciation:IPA pronunciation of the native name | ;pronunciation:IPA pronunciation of the native name | ||
− | ; | + | ;ailname:transliteration of the name recorded at the [[World:Aldeemah Imperial Library|AIL]] |
+ | ;ailprob:IPA pronunciation of the AIL name | ||
;states:countries in which it is mainly spoken | ;states:countries in which it is mainly spoken | ||
;state:alias for '''states''' | ;state:alias for '''states''' | ||
;region:geographic region in which it is mainly spoken | ;region:geographic region in which it is mainly spoken | ||
− | + | ;ethnicity:people for whom this is the ethnically native language; races can be specified; this may change as I figure this out (or something) | |
− | + | ;familycolor: background color for main heading | |
− | + | ;bgcolor: background color for entire box | |
− | + | :NOTE: The previous two will probably be changed after I decide on some language family color schemes (or something) | |
− | |||
− | |||
− | ;ethnicity:people for whom this is the ethnically native language; | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ; | ||
− | ; | ||
− | |||
− | : | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
;ancestor:ancestral or reconstructed forms | ;ancestor:ancestral or reconstructed forms | ||
;ancestor2 | ;ancestor2 | ||
Line 45: | Line 24: | ||
;ancestor5:intermediate forms | ;ancestor5:intermediate forms | ||
;protoname:alias for ancestor | ;protoname:alias for ancestor | ||
− | |||
− | |||
− | |||
− | |||
;dia1: | ;dia1: | ||
;... | ;... | ||
;dia20:primary dialects | ;dia20:primary dialects | ||
;dialects:whatever you want to say | ;dialects:whatever you want to say | ||
− | |||
− | |||
− | |||
− | |||
− | |||
;script:the writing system(s) used for the language by literate speakers | ;script:the writing system(s) used for the language by literate speakers | ||
;sign:signed forms (manually coded language) | ;sign:signed forms (manually coded language) | ||
Line 63: | Line 33: | ||
;minority:list of countries in which it is a recognised/protected minority language | ;minority:list of countries in which it is a recognised/protected minority language | ||
;agency:regulatory body or language academy for the language | ;agency:regulatory body or language academy for the language | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
;image:image at top of info box. Use format "image name.png", without "file/image" or brackets. | ;image:image at top of info box. Use format "image name.png", without "file/image" or brackets. | ||
;imagesize:override default image size (currently 200px). Use units ("123px", "12em") | ;imagesize:override default image size (currently 200px). Use units ("123px", "12em") | ||
Line 138: | Line 54: | ||
{{Infobox language | {{Infobox language | ||
| name = | | name = | ||
− | |||
| nativename = | | nativename = | ||
| pronunciation = | | pronunciation = | ||
+ | | ailname = | ||
+ | | ailpron = | ||
| states (state) = | | states (state) = | ||
| region = | | region = | ||
− | |||
− | |||
| ethnicity = | | ethnicity = | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| familycolor = | | familycolor = | ||
+ | | bgcolor = | ||
| fam1 = | | fam1 = | ||
| fam2 = | | fam2 = | ||
| fam15 = | | fam15 = | ||
| family = | | family = | ||
− | | ancestor | + | | ancestor = |
− | | | + | | ancestor2(-5) = |
− | + | | dia1(-15) = | |
− | |||
− | |||
− | | dia1 | ||
− | |||
| dialects = | | dialects = | ||
+ | | script = | ||
| sign = | | sign = | ||
− | |||
− | |||
− | |||
− | |||
| nation = | | nation = | ||
| minority = | | minority = | ||
| agency = | | agency = | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| image = | | image = | ||
| imagesize = | | imagesize = | ||
Line 224: | Line 97: | ||
{{Infobox language | {{Infobox language | ||
| name = English | | name = English | ||
− | | pronunciation = {{IPAc-en|ˈ|ɪ|ŋ|ɡ|l|ɪ|ʃ}} | + | | pronunciation = {{IPAc-en|ˈ|ɪ|ŋ|ɡ|l|ɪ|ʃ}} |
− | | | + | | region = (see [[#Geographical distribution|below]]) |
− | | | + | | familycolor = #fff |
− | + | | bgcolor = #fff | |
− | | | + | | script = [[English alphabet]] ([[Latin script]]) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| sign = [[Manually coded English]] | | sign = [[Manually coded English]] | ||
− | |||
| nation = {{plainlist| | | nation = {{plainlist| | ||
* [[List of countries where English is an official language#Sovereign states|54 countries]] | * [[List of countries where English is an official language#Sovereign states|54 countries]] | ||
Line 252: | Line 118: | ||
* [[Pacific Islands Forum|PIF]] | * [[Pacific Islands Forum|PIF]] | ||
* [[UKUSA Agreement]]}} | * [[UKUSA Agreement]]}} | ||
− | |||
− | |||
− | |||
− | |||
| map = Anglospeak.svg | | map = Anglospeak.svg | ||
| mapcaption = {{legend|#0000ff|Countries where English is the native language of the majority of the population}} {{legend|#8ddada|Countries where English is an official but not primary language}} | | mapcaption = {{legend|#0000ff|Countries where English is the native language of the majority of the population}} {{legend|#8ddada|Countries where English is an official but not primary language}} | ||
Line 263: | Line 125: | ||
{{Infobox language | {{Infobox language | ||
| name = English | | name = English | ||
− | | pronunciation = {{IPAc-en|ˈ|ɪ|ŋ|ɡ|l|ɪ|ʃ}} | + | | pronunciation = {{IPAc-en|ˈ|ɪ|ŋ|ɡ|l|ɪ|ʃ}} |
− | | | + | | region = (see [[#Geographical distribution|below]]) |
− | | | + | | familycolor = #fff |
− | + | | bgcolor = #fff | |
− | | | + | | script = [[English alphabet]] ([[Latin script]]) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| sign = [[Manually coded English]] | | sign = [[Manually coded English]] | ||
− | |||
| nation = {{plainlist| | | nation = {{plainlist| | ||
* [[List of countries where English is an official language#Sovereign states|54 countries]] | * [[List of countries where English is an official language#Sovereign states|54 countries]] | ||
Line 291: | Line 146: | ||
* [[Pacific Islands Forum|PIF]] | * [[Pacific Islands Forum|PIF]] | ||
* [[UKUSA Agreement]]}} | * [[UKUSA Agreement]]}} | ||
− | |||
− | |||
− | |||
− | |||
| map = Anglospeak.svg | | map = Anglospeak.svg | ||
| mapcaption = {{legend|#0000ff|Countries where English is the native language of the majority of the population}} {{legend|#8ddada|Countries where English is an official but not primary language}} | | mapcaption = {{legend|#0000ff|Countries where English is the native language of the majority of the population}} {{legend|#8ddada|Countries where English is an official but not primary language}} | ||
Line 300: | Line 151: | ||
}} | }} | ||
</pre> | </pre> | ||
− | |||
− | |||
{{clear}} | {{clear}} | ||
=== Placement === | === Placement === | ||
Line 309: | Line 158: | ||
:'''<nowiki>{{Infobox language</nowiki>''' ← this calls the template | :'''<nowiki>{{Infobox language</nowiki>''' ← this calls the template | ||
:'''| name =''' name of language ← the name of the language needs to be given | :'''| name =''' name of language ← the name of the language needs to be given | ||
− | |||
:'''<nowiki>}}</nowiki>''' ← this ends the template call | :'''<nowiki>}}</nowiki>''' ← this ends the template call | ||
Line 319: | Line 167: | ||
There are several more parameters that can be defined between the opening and closing lines. These are: | There are several more parameters that can be defined between the opening and closing lines. These are: | ||
− | :'''| | + | :'''| nativename =''' the transliteration of the native name of the language. See [[Meta:English Transliterations]] for more information. |
− | :'''| | + | :'''| ailname = ''' the transliteration of the name it is "officially" listed under at the [[World:Aldeemah Imperial Library|Aldeemah Imperial Library]]. |
:'''| states =''' countries in which it is mainly spoken (multigenerational communities) ← you do not have to define both this and '''region'''. Do not use flag icons except for national or official status ([[WP:INFOBOXFLAG]]). | :'''| states =''' countries in which it is mainly spoken (multigenerational communities) ← you do not have to define both this and '''region'''. Do not use flag icons except for national or official status ([[WP:INFOBOXFLAG]]). | ||
:'''| region =''' geographic region in which it is mainly spoken ← you do not have to define both this and '''states'''; use this parameter for a single statement about geographic distribution. It is not for the broader region where the states are located, but rather the regions within the country, or across countries, where it is spoken. (That is, do not add SE Asia if we state it's in Laos, or West Africa if we state it's in Mali.) | :'''| region =''' geographic region in which it is mainly spoken ← you do not have to define both this and '''states'''; use this parameter for a single statement about geographic distribution. It is not for the broader region where the states are located, but rather the regions within the country, or across countries, where it is spoken. (That is, do not add SE Asia if we state it's in Laos, or West Africa if we state it's in Mali.) | ||
− | :'''| | + | :'''| family =''' language family it belongs to. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
:'''| ancestor =''' an ancestral form, such as Old English or Proto-Basque | :'''| ancestor =''' an ancestral form, such as Old English or Proto-Basque | ||
− | :'''| ancestor2 | + | :'''| ancestor2..5 =''' intermediate ancestral forms, such as Middle English or Aquitanian |
=== Optional parameters === | === Optional parameters === | ||
Some parts of the template remain invisible unless they are specifically called. Only use these parameters if they are required. | Some parts of the template remain invisible unless they are specifically called. Only use these parameters if they are required. | ||
− | :'''| fontcolor =''' | + | :'''| fontcolor =''' color of font against the backgrounds below (defaults to black) |
+ | :'''| familycolor =''' background color for the box's heading (defaults to #ddd) | ||
+ | :'''| bgcolor =''' background color for the entire box (defaults to #f0f0f0) | ||
:'''| pronunciation =''' pronunciation of the native name of the language in [[International Phonetic Alphabet|IPA]] → remember to enclose the transcription in an IPA template such as {{tl|IPA-all}} | :'''| pronunciation =''' pronunciation of the native name of the language in [[International Phonetic Alphabet|IPA]] → remember to enclose the transcription in an IPA template such as {{tl|IPA-all}} | ||
+ | :'''| ailpron =''' pronunciation of the name listed at the AIL. | ||
:'''| nation =''' list of countries in which it is an official language | :'''| nation =''' list of countries in which it is an official language | ||
:'''| minority =''' list of countries in which it is a recognised minority language. This is intended for legal protection and similar ''de jure'' recognition, not simply being listed on a census and other ''de facto'' recognition. | :'''| minority =''' list of countries in which it is a recognised minority language. This is intended for legal protection and similar ''de jure'' recognition, not simply being listed on a census and other ''de facto'' recognition. | ||
:'''| agency =''' regulatory body or language academy for the language | :'''| agency =''' regulatory body or language academy for the language | ||
− | |||
− | |||
− | |||
− | |||
:'''| script =''' writing system(s) used to represent the language ← in the form ''script (instantiation)'', such as "[[Latin script|Latin]] ([[English alphabet]])"<br />(Common variants of "Latin (alphabet)" redirect to [[Latin script]]. For the [[Latin alphabet]] itself, add an element such as <code>&nbsp;</code>.) | :'''| script =''' writing system(s) used to represent the language ← in the form ''script (instantiation)'', such as "[[Latin script|Latin]] ([[English alphabet]])"<br />(Common variants of "Latin (alphabet)" redirect to [[Latin script]]. For the [[Latin alphabet]] itself, add an element such as <code>&nbsp;</code>.) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Images in the template === | === Images in the template === | ||
Line 433: | Line 217: | ||
# [[:Template:Infobox language/quilt]] | # [[:Template:Infobox language/quilt]] | ||
− | + | <!-- Hiding this crap wholesale because I don't need it and/or don't want to edit it right now. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== TemplateData == | == TemplateData == | ||
This is the [[WP:VisualEditor/TemplateData|TemplateData]] for this template so it can be used with the new [[WP:VisualEditor|VisualEditor]]. | This is the [[WP:VisualEditor/TemplateData|TemplateData]] for this template so it can be used with the new [[WP:VisualEditor|VisualEditor]]. | ||
Line 1,778: | Line 1,518: | ||
} | } | ||
} | } | ||
− | </templatedata> | + | </templatedata> --> |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | | | <includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | | |
Revision as of 01:10, 29 March 2016
Uses Lua: |
This template provides a common standard for displaying data about a language.
Contents
Usage
This template accepts the following parameters:
- name
- name of language, simplest transliteration #REQUIRED
- nativename
- native transliteration of the language's name
- pronunciation
- IPA pronunciation of the native name
- ailname
- transliteration of the name recorded at the AIL
- ailprob
- IPA pronunciation of the AIL name
- states
- countries in which it is mainly spoken
- state
- alias for states
- region
- geographic region in which it is mainly spoken
- ethnicity
- people for whom this is the ethnically native language; races can be specified; this may change as I figure this out (or something)
- familycolor
- background color for main heading
- bgcolor
- background color for entire box
- NOTE: The previous two will probably be changed after I decide on some language family color schemes (or something)
- ancestor
- ancestral or reconstructed forms
- ancestor2
- ...
- ancestor5
- intermediate forms
- protoname
- alias for ancestor
- dia1
- ...
- dia20
- primary dialects
- dialects
- whatever you want to say
- script
- the writing system(s) used for the language by literate speakers
- sign
- signed forms (manually coded language)
- nation
- list of countries in which it is an official language
- minority
- list of countries in which it is a recognised/protected minority language
- agency
- regulatory body or language academy for the language
- image
- image at top of info box. Use format "image name.png", without "file/image" or brackets.
- imagesize
- override default image size (currently 200px). Use units ("123px", "12em")
- imagealt
- alt text for the image
- imagecaption
- caption to appear under image
- imageheader
- brief header for image (appears in the left-hand column)
- map
- image at bottom of info box. Use format "image name.png", without "file/image" or brackets.
- mapsize
- override default map size (currently 220px). Use units ("123px", "12em"). Affects both maps.
- mapalt
- alt text for the map
- mapcaption
- caption to appear under map
- map2
- a second map
- mapalt2
- alt text for the second map
- mapcaption2
- caption to appear under both maps
- boxsize
- overrides default width of infobox, currently set at 22em. Format must include units ("12em" or "123px").
- Useful when an article has various infoboxes aligned in a column. (Box will automatically expand to fix map wider than default box width.)
- notice
- notice2
- IPA/ipa [adds notice for IPA notation], Indic [same for Indic scripts]
Syntax
{{Infobox language | name = | nativename = | pronunciation = | ailname = | ailpron = | states (state) = | region = | ethnicity = | familycolor = | bgcolor = | fam1 = | fam2 = | fam15 = | family = | ancestor = | ancestor2(-5) = | dia1(-15) = | dialects = | script = | sign = | nation = | minority = | agency = | image = | imagesize = | imagealt = | imagecaption = | imageheader = | map = | mapsize = | mapalt = | mapcaption = | map2 = | mapalt2 = | mapcaption2 = | boxsize = | notice = | notice2 = }}
Example
English | |
---|---|
Pronunciation | /ˈɪŋɡlɪʃ/ |
Region | (see below) |
Writing system | English alphabet (Latin script) |
Signed forms | Manually coded English |
Official status | |
Official language in | |
220px Countries where English is the native language of the majority of the population Countries where English is an official but not primary language | |
{{Infobox language | name = English | pronunciation = {{IPAc-en|ˈ|ɪ|ŋ|ɡ|l|ɪ|ʃ}} | region = (see [[#Geographical distribution|below]]) | familycolor = #fff | bgcolor = #fff | script = [[English alphabet]] ([[Latin script]]) | sign = [[Manually coded English]] | nation = {{plainlist| * [[List of countries where English is an official language#Sovereign states|54 countries]] * [[List of countries where English is an official language#Non-sovereign entities|27 non-sovereign entities]] * [[United Nations]] * [[European Union]] * [[Commonwealth of Nations]] * [[Council of Europe]] * [[International Olympic Committee|IOC]] * [[NATO]] * [[North American Free Trade Agreement|NAFTA]] * [[Organization of American States|OAS]] * [[Organisation for Economic Co-operation and Development|OECD]] * [[Organisation of Islamic Cooperation|OIC]] * [[Pacific Islands Forum|PIF]] * [[UKUSA Agreement]]}} | map = Anglospeak.svg | mapcaption = {{legend|#0000ff|Countries where English is the native language of the majority of the population}} {{legend|#8ddada|Countries where English is an official but not primary language}} | notice = IPA }}
Placement
See also | Wikipedia:WikiProject Languages |
---|
The template should placed at the very top of the wikitext of the article, before any text. The absolute basic syntax is as shown below:
- {{Infobox language ← this calls the template
- | name = name of language ← the name of the language needs to be given
- }} ← this ends the template call
*If you enter "isolate", you will be restricted to a single line for the family. In order to allow levels of classification, as with dialects of a language isolate, enter "grey"/"gray" instead.
However, you will probably want to add more than just this. Other parameters are listed below, they can be incorporated anywhere between the first and last lines, and in any order.
Additional parameters
There are several more parameters that can be defined between the opening and closing lines. These are:
- | nativename = the transliteration of the native name of the language. See Meta:English Transliterations for more information.
- | ailname = the transliteration of the name it is "officially" listed under at the Aldeemah Imperial Library.
- | states = countries in which it is mainly spoken (multigenerational communities) ← you do not have to define both this and region. Do not use flag icons except for national or official status (WP:INFOBOXFLAG).
- | region = geographic region in which it is mainly spoken ← you do not have to define both this and states; use this parameter for a single statement about geographic distribution. It is not for the broader region where the states are located, but rather the regions within the country, or across countries, where it is spoken. (That is, do not add SE Asia if we state it's in Laos, or West Africa if we state it's in Mali.)
- | family = language family it belongs to.
- | ancestor = an ancestral form, such as Old English or Proto-Basque
- | ancestor2..5 = intermediate ancestral forms, such as Middle English or Aquitanian
Optional parameters
Some parts of the template remain invisible unless they are specifically called. Only use these parameters if they are required.
- | fontcolor = color of font against the backgrounds below (defaults to black)
- | familycolor = background color for the box's heading (defaults to #ddd)
- | bgcolor = background color for the entire box (defaults to #f0f0f0)
- | pronunciation = pronunciation of the native name of the language in IPA → remember to enclose the transcription in an IPA template such as {{IPA-all}}
- | ailpron = pronunciation of the name listed at the AIL.
- | nation = list of countries in which it is an official language
- | minority = list of countries in which it is a recognised minority language. This is intended for legal protection and similar de jure recognition, not simply being listed on a census and other de facto recognition.
- | agency = regulatory body or language academy for the language
- | script = writing system(s) used to represent the language ← in the form script (instantiation), such as "Latin (English alphabet)"
(Common variants of "Latin (alphabet)" redirect to Latin script. For the Latin alphabet itself, add an element such as
.)
Images in the template
You should not put large images at the top of the language template: they just make it very messy. You can place a small image at the top of the template using the following parameters:
- | image = image name.png
- | imagesize = 100px ← overrides the default image size
- | imagealt = alt text
- | imagecaption = caption
- | imageheader = very simple description of image ('logo', 'map', 'script', etc.) ← this is placed in the left-hand column, and so needs to be short
If you have a larger image or two, such as a map, you can place them at the bottom of the template, spanning both columns, with the following parameter:
- | map(2) = image name.png
- | mapsize = 300px ← overrides the default image size
- | mapalt(2) = alt text
- | mapcaption(2) = caption
The usual image markup applies for both images. Alt text is for visually impaired readers, and the caption is for all readers; typically they should have little in common (see WP:ALT).
A notice or notices may be placed at the bottom of the infobox:
Sub-templates
- Template:Infobox language/codelist
- Template:Infobox language/family-color
- Template:Infobox language/genetic
- Template:Infobox language/linguistlist
- Template:Infobox language/ref
- Template:Infobox language/quilt