Editing Template:Infobox language/doc (section)

== Parameters ==
{{Infobox language/quilt|right}}
The required parameters are:
; name : name of language
; familycolor : appropriate language family. Possible values are listed in the coloured chart to the right (or above, depending on your browser). Please do not use other names, because they will not be recognised, and the table will be colored grey.
: In most cases, 'familycolor' will trigger a default entry for the 'fam1' field, so that field is not necessary (you can continue with 'fam2'), but you can override this by entering something under 'fam1'.
: Areal colors (American, Khoisan, Altaic, etc.) represent areal codings, and are *not* claims that the language belongs to that family. When these are used, the '''fam1''' parameter must be set to the widely accepted language family.
: If 'isolate' or 'unclassified' is used, the fam1–xx tree will not display.  In order to allow levels of classification, as with dialects of a language isolate, enter "grey"/"gray" instead.

Other parameters are listed below, they can be incorporated anywhere between the first and last lines, and in any order.

; altname : additional name of the language [not every one, but one a reader would be likely to look for]
; nativename : native name, or a second alternative name [most cases as of 2012 not actually the native name] (if nativename is to be used, and altname parameter MUST be defined)
; 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}}
; acceptance : questionable acceptance/status of the language: unattested, spurious, etc.
; states : countries in which it is mainly spoken. You do not have to define both this and '''region'''. Do not use flag icons except for national or official status ([[WP:INFOBOXFLAG]]). Direct links to country articles are generally not useful, and distract from useful links. Consider 'Languages of [country]' or '[ethnicity] in [country]' links instead. 
; state : alias for '''states'''
; 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.)
; ethnicity : people for whom this is the ethnically native language; also good for the ethnic population if different from the number of speakers (although the names chosen for the articles on the people and on the language will generally be the same, it may be appropriate to pipe in the native name of the people here)
; era : era of use of a historical language, such as one that developed into something else; 'speakers' will not display
; extinct : date of extinction, or information about extinction; 'speakers' will not display
; revived : Date and/or population of attempted revival of extinct language
; revived-category : (or '''revived-cat''') optional name  (without "Category:") of appropriate subcategory of [[:Category:Language revival]] (which is used by default if {{para|revived}} has a value); can be given as {{para|revived-category|nocat}} to suppress the categorization entirely, when the language has a separate article about its revival that is already in the category (e.g. [[Cornish revival]] is in [[:Category:Celtic language revival]], so {{para|revived-cat=nocat}} is used in the infobox at [[Cornish language]]).
; dia1 :
; ...
; dia20 : primary dialects
; dialects : whatever you want to say; dia1–xx will not display
; listclass : class for the dia1–xx list: <code>plainlist</code> (default), <code>hlist</code> (horizontal) or <code>flatlist</code> (bulleted)
; stand1 : a standardized register
; stand2 : a second standardized register
; ...
; stand6 : sixth standardized register
; standards : whatever you want to say
; script : writing system(s) used for the language by literate speakers, 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>&amp;nbsp;</code>.)
; 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. 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
; development_body : development body for the language
; 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.)
; fontcolor : colour of font against 'familycolor' ← the font colour is usually black, use this to change it if it is difficult to read
; module : Used for embedding other infoboxes into this one.

=== Number of speakers ===

; speakers : the number of native speakers of the language. If unknown, enter {{angle bracket|?}} and do not enter NA for the date (this causes the article to be listed in the [[:Category:Language articles with speakers set to 'unknown']], a hidden [[WP:PROJCATS|maintenance category]]). If no native speakers, enter {{angle bracket|none}}. Otherwise, if no date is supplied, ''missing date'' will be displayed.  Use <code><nowiki>{{sigfig|...|2}}</nowiki></code> to round to 2 [[significant figures]] while retaining the exact figure from the reference.
; date : the date of publication of the estimate of the number of speakers.
: Used for calculations for obsolete data, so needs to start with a 4-digit year (see next parameter). Exception: If {{angle bracket|NA}} is entered, nothing will display. If {{angle bracket|no date}} is entered, "no date" will display.  Do not enter a date parameter at all if speakers is set to {{angle bracket|none}}.
: Articles with old dates (currently ≥ 30 years) appear in [[:Category:Language articles with old speaker data]].
; dateprefix : any text wanted inside the parentheses before the date; a space ({{code|&nbsp;}}) must be explicitly included at the end
; ref : reference for the speaker data, , placed after the date, if any. This can be any [[WP:CITEFOOT|inline citation]] or a predefined code such as e19, linglist, ne2010, etc. For more details, see the documentation at [[Template:Infobox language/ref]].
: If {{angle bracket|e17}} is entered, this will automatically generate a reference to the ''Ethnologue'' 17 article that bears the ISO 639-3 code entered at 'iso3'.
: To link to the auto-generated reference from elsewhere in the article, use <code><nowiki><ref name=e17/></nowiki></code>.
: {{angle bracket|e16}} and <code><nowiki><ref name=e16/></nowiki></code> or {{angle bracket|e15}} and <code><nowiki><ref name=e15/></nowiki></code> can be used to ref the 16th or 15th edition, for example for extinct languages which are no longer supported.
: {{angle bracket|linglist}} and <code><nowiki><ref name=linglist/></nowiki></code> can be used to ref the ''MultiTree'' entry at the Linguist List.
: {{angle bracket|ne2007/ne2010}} and <code><nowiki><ref name=NE100/></nowiki></code> can be used to ref the Swedish national encyclopedia, which we use for many of the world's top 100 languages
: {{angle bracket|inali}} and <code><nowiki><ref name=INALI/></nowiki></code> can be used to ref Mexico's [[Instituto Nacional de Lenguas Indígenas]]
: Similarly, aiatsis can be used to link to the <code><nowiki><ref name=AIATSIS/></nowiki></code> ref generated by the infobox for the AIATSIS entry for Australian languages.  (For Maho's edition of the Guthrie list for Bantu languages, <code><nowiki><ref name=Guthrie/></nowiki></code> needs to be added manually, as they do not provide population data.)
; refname : Name used in reference generated by certain 'ref' parameter values such as e19. It defaults to the value of the 'name' parameter or PAGENAME.
; speakers2 : a 2nd line for speaker data, such as 2nd estimate, 2nd country, L2 speakers, etc, appearing after the date.
: If this is a second line of L1 speakers, it should be arranged so that, if there are two dates cited, the oldest appears in the date parameter, for automated update calculations. Data from different countries should not be added together if they are not comparable: say if one is from 1973 and another from 2006, or if one is rounded to the nearest million and another is on the order of 10,000.
; speakers_label : The infobox label for the number of speakers is "Native speakers" by default. Set this parameter to <code>|speakers_label = Speakers</code> to change it to "Speakers".

=== Genetic classification ===

You can use the language template to show the [[language family|genetic classification]] of a language as a descending staircase of language families, from the broadest to the most specific.
; fam1 : the broadest possible widely accepted [[language family]] of which the language is a part. If this would be exactly the same as you have defined for '''familycolor''', it may be omitted.
; fam2 : a more specific sub-family
; ...
; fam15 : most specific sub group

If you would prefer to enter some other information in this box (for example, ''disputed''), use this parameter instead:
; family : whatever you want to say; fam1–xx will not display. This can be set to "na" to avoid specifying a family relationship at all, an for a geographical group that has no single origin.

The template can also display a staircase of ancestral forms:
; ancestor : ancestral or reconstructed form, if it has an article or has been assigned an ISO code
; ancestor2
; ...
; ancestor8 : intermediate ancestral forms
; protoname : alias for '''ancestor'''

=== ISO language codes ===

; iso1 : the [[ISO 639-1]] code for the language
; iso1comment : for comments to not interfere with the link
; iso2 : the [[ISO 639-2]] code for the language (not for its family); creates a link to the ISO page. If a language has two ISO 639-2 codes, use the following two separate fields instead.
; iso2b : the [[ISO 639-2]] bibliographic code (for languages with two ISO 639-2 codes)
; iso2t : the [[ISO 639-2]] terminological code (for languages with two ISO 639-2 codes)
; iso2comment : for comments to not interfere with the link(s)
; iso3 : the [[ISO 639-3]] code for the language; creates a link to the ISO page. See below for the situation where multiple ISO 639-3 codes apply.
: Field will display even if left empty, unless 'lc1' etc. is used.
: If there is no ISO 639-3 code, set {{para|iso3|none}} to return the text ''none'' and add the article to [[:Category:Languages without iso3 codes]] (if '''iso3comment''' is also used, that will display in place of ''none'')
: Leave empty for a dialect that has no iso3 code, but the language it belongs to does; in this case, also use {{para|isoexception|dialect}}.
: Leave empty for a historical variety that has no iso3 code, but its modern version does; in this case, also use {{para|isoexception|historical}}.
: Leave blank for a protolanguage, and use {{para|isoexception|protolanguage}}.
: Use 'linglist' if the language has an iso3 code, but this is maintained at Linguist List instead of at SIL. Add the code itself under |linglist=. (This is not necessary if the SIL page provides its own link to the Linguist List page.)
; iso3comment : allows a comment in the ISO field that will not interfere with the link
; isoexception : a maintenance field to organize cleanup categories for missing ISO codes.  Excludes article from the [[:Category:Language articles without language codes]] if set to any of the following values:
:: '''dialect''' (used for a dialect that does not itself have an ISO code, although the language it belongs to does; adds article to the [[:Category:Dialects of languages with ISO 639-3 code]])
:: '''historical''' (used for a historical language that does not itself have an ISO code, although its modern version does; adds article to the [[:Category:Historical forms of languages with ISO codes]])
:: '''protolanguage''' (used for protolanguages without ISO codes; adds article to the [[:Category:Protolanguages without ISO codes]])
:: '''talkpage''' (used on talk pages and in archives so that they don't show up in tracking categories)

Some languages have a number of [[ISO 639-3]] codes, one for each dialect of that language. If you try putting all of these codes in the usual '''iso3 ='''  parameter, it will get quite messy. Instead, use the following parameters:
; lc1 : ISO code of the first dialect (the 'iso3' field will not display if empty and this is included)
; ld1 : name of the first language dialect
; lc2 : ISO code of the second dialect
; ld2 : name of the second language dialect
: ...
; lc30 : ISO code of the 30–th dialect
; ld30 : name of the 30–th dialect
; iso6 : the ISO 639-6 code for the language.

Lc entries will be automatically linked to the ''Ethnologue'' site. Wikipedia articles on the dialects may be linked from the ld entries.

For languages with an [[ISO 639-3 macrolanguage]] code and several individual codes, use '''iso3''' for the macrolanguage and '''lc''n''''', '''ld''n''''' for the individual codes.

=== Other language codes ===

; linglist : this parameter is deprecated due to unreliable data, with the exception of some long-extinct languages. For ISO 639-3 codes of extinct languages whose descriptions are maintained at [[Linguist List]], enter the code under 'iso3' and the reader will be redirected from the ISO page.
; lingua : the [[Linguasphere]] code for the language
; glotto
; glotto2
; ...
; glotto5 : the [[Glottolog]] code for the language. Enter "none" if Glottolog does not have a code for the language, "spurious" if Glottolog uses that term. [future: also "unattested"]
; glottorefname
; glottorefname2
; ...
; glottorefname5 : the Glottolog name(s) for the language (optional). Substitute '''glottoname''' etc. if the name needs to be displayed in the info box.
; guthrie : the [[Guthrie classification of Bantu languages|Guthrie]] code for Bantu languages. Generates a reference which can be accessed via name="Guthrie".
; aiatsis : the [[AIATSIS]] code for Australian languages. Generates a reference which can be accessed via name="AIATSIS". Site includes population data we can use.
; aiatsis2
; ...
; aiatsis6 : additional AIATSIS codes
; aiatsisname2
; ...
; aiatsisname6 : the AIATSIS name, if different from the entry at |name=, or note to appear after code
; ELP : URL suffix of the language article on the [[Endangered Languages Project]] site. Manual override of a default module linking to the ELP article per WikiData settings. Either way generates a reference that can be accessed via name="ELP". Entering "none" prevents the default link (e.g. when there is more than one info box in the WP article). The ELP site includes population data we can use.
; ELPname : name that will display for the ELP link and ref. 
; ...
; ELP4 : additional ELP links, or manual addition (rather than replacement) to the automated module link. Useful when changing WikiData might corrupt articles on other-language wikis (e.g. when the two wikis don't define the language with the same scope).
; ELPname4
; glottopedia : [[Glottopedia]]. Generates a reference which can be accessed via name="Glottopedia".
; ietf : [[IETF language tag]]

=== Constructed languages ===

This template is appropriate to use for [[constructed language]]s. The following parameters can be used:
; creator : name of language creator
; created : year of first creation
; setting : the use or setting for the language
; posteriori : natural-language sources

Using these parameters, or setting '''familycolor=Conlang''', automatically sets the coloured bars of the infobox to {{code|{{Infobox language/family-color|Conlang}}}} background with white fonts, and removes the '''states''' and '''region''' parameters from use ('''nation''' is also disabled). If the '''iso2''' parameter is left undefined, it is treated as being '''iso2=art'''. For conlangs, the '''family''' or '''fam''n''''' parameters are used to describe the hierarchy of purpose of the language, whereas '''posteriori''' is used to describe the ''a posteriori'' sources on which the conlang draws.

=== Maps and images ===
{{anchor|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 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 the image
; imageheader : brief header for the 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 : 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

The [[WP:EIS|usual image markup]] applies for both images. [[Alt text]] is for visually impaired readers, and the [[WP:CAPTION|caption]] is for all readers; typically they should have little in common (see [[WP:ALT]]).

For languages spoken in smaller areas, where the location of the language can be reasonably approximated by a point on the map, then a pushpin map can be added:
; coordinates : latitude and longitude; use {{tl|coord}}
; pushpin_map : The name of a location map as per [[Template:Location map]] (e.g. ''Indonesia'' or ''Russia''). The coordinate fields (from {{para|coordinates}}) position a pushpin coordinate marker and label on the map '''automatically'''. To show multiple pushpin maps, provide a list of maps separated by #, e.g., ''California#USA''
; pushpin_image : (optional)  Allows the use of an alternative map; the image must have the same edge coordinates as the location map template.<br/>''Equivalent to <code>AlternativeMap</code> parameter in [[Template:Location map]].''
; pushpin_mapsize : (optional) Must be entered as only a number—'''do not use px'''. The default value is 250. ''Equivalent to <code>width</code> parameter in [[Template:Location map]].''
; pushpin_map_alt : (optional) Alt text for pushpin map; used by [[screen reader]]s, see [[WP:ALT]]. ''Equivalent to <code>alt</code> parameter in [[Template:Location map]].''
; pushpin_map_caption : (optional) Fill out if a different caption from ''map_caption'' is desired. ''Equivalent to <code>caption</code> parameter in [[Template:Location map]].''
; pushpin_label : (optional) The text of the label to display next to the identifying mark; a [[Wiki markup|wikilink]] can be used. If not specified, the label will be the text assigned to the ''name'' parameter, and if the ''name'' parameter is not specified, the article title. (if {{para|pushpin_label_position|none}}, no label is displayed).<br/>''Equivalent to <code>label</code> parameter in [[Template:Location map]].''
; pushpin_label_position : (optional) The position of the label on the pushpin map relative to the pushpin coordinate marker. Valid options are {left, right, top, bottom, none}. If this field is not specified, the default value is ''right''.<br/>''Equivalent to <code>position</code> parameter in [[Template:Location map]].''

=== Footer notice ===
A notice or notices may be placed at the bottom of the infobox:
; notice=ipa : places a notice about the [[Unicode]] fonts used for displaying [[International Phonetic Alphabet|IPA]]