Template:Infobox language/doc

From Linguifex
Jump to: navigation, search

This template is for use in articles about languages or dialects. It provides a common standard for displaying data about a language.

Usage

{{Infobox language
| boxsize           = width of the infobox (default 22em)
| name              = name of language #REQUIRED
| altname           = additional name of the language
| nativename        = native or a second additional name
| acceptance        = degree of acceptance of the language by other nations
| image             = image at top of info box. Use format "image name.png", without "file/image" or brackets.
| imagesize         = override default image size (currently 250px). 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)
| pronunciation     = IPA pronunciation of the native name (without slashes or brackets!); preferably narrow transcription
| pronunciation_key = pronunciation key of the languages; defaults to Help:IPA
| creator           = creator of the language #REQUIRED; if the value is of the form User:xxxxxx, it links automatically to that user
| created           = the year of first creation
| setting           = setting of the language (conworld, Earth country or region, etc.)
| states            = real or fictional countries or regions in which it is mainly spoken (alias: state=)
| 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)
| extinct           = date of extinction, as precise as needed; speakers will not display
| era               = era of historical use; speakers will not display
| speakers          = number of speakers
| date              = date of estimate of number of speakers
| speakers2         = 2nd line (2nd estimate, 2nd country, L2 speakers, etc.)
| revived           = date of attempted or successful language revival
| familycolor       = appropriate language family #REQUIRED
                      See table below for list of options. Please do not use other names, as 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'. For areal colors (American, Khoisan, 
                      Paleosiberian, etc.), you will be prompted for a 'fam1' entry if you do not provide one. If 'isolate' or 'unclassified' is used, the 
                      fam1–xx tree will not display.
| fam1              = the broadest possible widely accepted language family of which the language is a part
| fam2              = a more specific subfamily
| ...
| fam15             = most specific subgroup
| family            = whatever you want to say; fam1–xx will not display
| ancestor1         = the earliest known ancestor
| ancestor2         = a later ancestor
| ...                 (up to 8)
| posteriori        = natural-language sources
| stand1            = a standardized register
| stand2            = a second standardized register
| ...                (up to 6)
| standards         = whatever you want to say
| dia1              = a primary dialect
| dia2              = another primary dialect
| ...                 (up to 20)
| dialects          = whatever you want to say
| script1           = a writing system used for the language by literate speakers; use standard codes, see Module:scripts/data
| script2           = another writing system; use standard codes, see Module:scripts/data
| ...                 (up to 5)
| scripts           = override the scriptN list (e.g. if the language has a script without a code); use a bullet list
| nation            = list of countries in which it is an official language
| minority          = list of countries in which it is a recognised minority language
| agency            = regulatory body or language academy for the language
| development_body  = development body for the language
| 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)
| iso2comment       = for comments to not interfere with the link
| iso3              = the ISO 639-3 code for the language
| iso3comment       = for comments to not interfere with the link
| clcr              = Conlang Registry Code for the language
| glotto            = Glottolog code for the language
| glottoname        = name of code glotto
| glotto2           = Second Glottolog code for the language
| glottoname2       = name of code glotto2
| cws               = ConWorkShop code for the language
| ietf              = IETF (BCP 47) code for the language
| brcl              = Brightraven Registry of Constructed Languages code for the language
| map               = image at bottom of info box. Use format "image name.png", without "file/image" or brackets.
| mapsize           = override default map size (currently 350px). 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 mapswidth.)
| notice            = IPA/ipa [adds notice for IPA notation]
}}

Placement

The template should placed at the very top of the wikitext of the article, before any text. The absolute basic syntax (the required parameters) is as shown below:

{{Infobox language ← this calls the template
|name=
Name of language.
|familycolor=
Appropriate language family. Refer to the coloured chart to the right (or above, depending on your browser), and type the name shown there; this will add the appropriate family color to the template top. Using "Altaic" or "Caucasian" etc. does not result in a claim that the language belongs to that family: think of them as areal codings.
|creator=
Name of language creator. To link to a Linguifex user, use User:xxxx, where xxxx is the username
}} ← this ends the template call

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:

|altname=
Additional name of the language [not every one, but one a reader would be likely to look for]
|nativename=
Autoglossonym, or native name (i.e. name of the language in the language).
|states=
Countries in which it is mainly spoken (multigenerational communities).
|speakers=
The number of native speakers of the language. If unknown, enter ? and do not enter NA for the date. If no native speakers, enter none. Otherwise, if no date is supplied, missing date will be displayed.
|date=
The date of publication of the estimate of the number of speakers. If NA is entered, nothing will display. If no date is entered, "no date" will display.
|speakers2=
A second line for speaker data, such as L2 speakers, 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.
|iso1=
The ISO 639-1 code for the language. Please do not use if your language does not really have an ISO code.
|iso2=
The ISO 639-2 code for the language.
|iso3=
The ISO 639-3 code for the language.
|clcr=
The ConLang Code Registry code for the language.
|brcl=
The Brightraven Registry of Constructed languages code for the language.
|glotto=
The Glottolog code for the language.
etc.

Genetic classification

You can use the language template to show the genetic classification of a language at a glance. This classification is displayed as a descending staircase of language families, from the broadest to the most specific. To add the genetic classification use the following:

|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
|fam3=
A more specific group

You can keep adding parameters in like fashion until you have completed the classification (or 15 subclasses). 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 (sequesters the repetition of the name of the language)
|ancestorN=
An ancestral form, such as Old English or Proto-Basque, N being 1-8.

Optional parameters

Some parts of the template remain invisible unless they are specifically called. Only use these parameters if they are required.

|pronunciation=
Pronunciation of the native name of the language in IPA. There is no need to use {{IPA-all}} or transcription identifiers (narrow or broad), as this is handled automatically
|nation=
List of countries in which it is an official language
|minority=
List of countries in which it is a recognised minority language
|agency=
Regulatory body or language academy for the language
|extinct=
Date of extinction, or information about extinction. This replaces |speakers=
|era=
Era of use of an ancestral form of a language. This replaces |speakers=
|scriptN=
Writing system(s) used to represent the language, N being 1-5. Use international codes; the list in Module:scripts/data can be used as reference.
|scripts=
If the language uses a script without a code, use this parameter with a bullet list
|created=
Year of first creation
|setting=
The use or setting for the language.
|posteriori=
Natural-language sources

Images in the template

You cannot put large images into 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=
Do not specify the namespace File: or link to the file. Image name with file format: Example.png
|imagesize=
Image size, defaults to 200px. If other values are used, please specify the units
|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 slightly larger image or two, such as a map, you can place at the bottom of the template, spanning both columns, with the following parameter:

|map(2)=
In the same fashion as |image=
|mapsize=
Image size, defaults to 300px. If other values are used, please specify the units
|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).

Footer notice

A notice or notices may be placed at the bottom of the infobox:

|notice=ipa

This places a notice about the Unicode fonts used for displaying IPA

Sub-templates

  1. Template:Infobox language/codelist
  2. Template:Infobox language/family-color
  3. Template:Infobox language/genetic
  4. Template:Infobox language/quilt

Error-tracking categories

See also