Difference between revisions of "Template:Infobox person/doc"

From annadreambrush.com/wiki
Jump to navigation Jump to search
imported>Xeworlebi
(ndash (2))
imported>SMcCandlish
(general cleanup and clarification; "misc" parameter remains undefined and either should have a clear rationale here or become an alias of "footnotes")
Line 146: Line 146:
 
|-
 
|-
 
| '''citizenship'''
 
| '''citizenship'''
| Citizenship. ''See usage notes for nationality.''
+
| Citizenship. ''See usage notes for nationality, above.''
 
|-
 
|-
 
| '''other_names'''
 
| '''other_names'''
Line 161: Line 161:
 
|-
 
|-
 
| '''employer'''
 
| '''employer'''
| Employer.
+
| Employer, if relevant.
 
|-
 
|-
 
| '''occupation'''
 
| '''occupation'''
Line 170: Line 170:
 
|-
 
|-
 
| '''salary'''
 
| '''salary'''
| Annual salary or compensation.
+
| Annual salary or compensation, if relevant.
 
|-
 
|-
 
| '''networth'''
 
| '''networth'''
| Current estimated net worth.
+
| Current estimated net worth, if relevant.
 
|-
 
|-
 
| '''height'''
 
| '''height'''
| If person was notable for their height.
+
| If person was notable for their height, or if height is relevant.
 
|-
 
|-
 
| '''weight'''
 
| '''weight'''
| If used, this should also include the date.
+
| If person was notable for their weight, or if weight is relevant. If used, this should also include the date.
 
|-
 
|-
 
| '''title'''
 
| '''title'''
Line 187: Line 187:
 
* Job title, such as ''President of Calvin College'' for [[Anthony Diekema]].
 
* Job title, such as ''President of Calvin College'' for [[Anthony Diekema]].
 
* A combination of the above, such as ''Professor of Mathematics'' and ''[[Fellow of the Royal Society]]'' for [[Bill Parry (mathematician)|Bill Parry]]
 
* A combination of the above, such as ''Professor of Mathematics'' and ''[[Fellow of the Royal Society]]'' for [[Bill Parry (mathematician)|Bill Parry]]
 +
''See also "awards" parameter, below, for awarded honors that are not really titles. A single award should not use both parameters.''
 
|-
 
|-
 
| '''term'''
 
| '''term'''
Line 198: Line 199:
 
|-
 
|-
 
| '''party'''
 
| '''party'''
| Field labeled '''Political party'''.
+
| If relevant. Field labeled '''Political party'''.
 +
|-
 +
| '''religion'''
 +
| If relevant. Field labeled '''Religion'''.
 
|-
 
|-
 
| '''boards'''
 
| '''boards'''
| Field labeled '''Board member of'''.
+
| For [[board of directors]] membership(s), if relevant. Field labeled '''Board member of'''.
|-
 
| '''religion'''
 
| Field labeled '''Religion'''.
 
 
|-
 
|-
 
| '''spouse'''
 
| '''spouse'''
| Name of spouse(s), followed by years of marriage. Use the format ''Name (1950–present)'' for current spouse and ''Name (1970–1999)'' for former spouse(s). Separate entries with a line break (<nowiki><br /></nowiki>).
+
| Name of spouse(s), followed by years of marriage. Use the format ''Name (1950–present)'' for current spouse and ''Name (1970–1999)'' for former spouse(s). Separate entries with a line break (<nowiki><br /></nowiki>). For deceased persons still married at time of death, close the date range with death year.
 
|-
 
|-
 
| '''partner'''
 
| '''partner'''
| Use same format as '''spouse'''.
+
| For unmarried [[life partner]]s (of any gender or sexual preference), not business partners. Use same format as '''spouse'''.
 
|-
 
|-
 
| '''children'''
 
| '''children'''
| Number of children (i.e. 3), or list of names if notable. Separate entries with a line break (<nowiki><br /></nowiki>).
+
| Number of children (i.e. 3), or list of names if notable, in which case, separate entries with a line break (<nowiki><br /></nowiki>).
 
|-
 
|-
 
| '''parents'''
 
| '''parents'''
Line 222: Line 223:
 
|-
 
|-
 
| '''callsign'''
 
| '''callsign'''
| Amateur radio '''call-sign'''.
+
| Amateur radio '''call-sign''', if relevant.
 
|-
 
|-
 
| '''awards'''
 
| '''awards'''
| Notable awards
+
| Notable awards. ''See also "title" parameter, above, for awarded titles. A single award should not use both parameters.''
 
|-
 
|-
 
| '''signature'''
 
| '''signature'''
Line 241: Line 242:
 
| '''box_width'''
 
| '''box_width'''
 
| The infobox width, such as: box_width=220px (default: 22em). Space character between the number and the unit of measurement breaks the parameter.
 
| The infobox width, such as: box_width=220px (default: 22em). Space character between the number and the unit of measurement breaks the parameter.
 +
|-
 +
| '''misc'''
 +
| Undefined.{{Clarify|reason=This needs a real, clearly explained reason to exist separately, or it should simply become an alias of the "footnotes" parameter.}}
 
|}
 
|}
  

Revision as of 00:14, 8 April 2010

{{infobox person}} may be used to summarize information about a particular person to an article. It is an alternative to more specific templates such as those listed at WikiProject Biography/Infoboxes and within the people infobox templates category.

Usage

The infobox may be added by pasting the template as shown below into an article and then filling in the desired fields. Any parameters left blank or omitted will not be displayed.

Blank template with basic parameters

{{Infobox person
| name        = 
| image       = 
| alt         = 
| caption     = 
| birth_date  = <!-- {{birth date|YYYY|MM|DD}} -->
| birth_place = 
| death_date  = <!-- {{Death date and age|YYYY|MM|DD|YYYY|MM|DD}} (death date then birth) -->
| death_place = 
| nationality = 
| other_names = 
| known_for   = 
| occupation  = 
}}

Blank template with all parameters

{{Infobox person
| name                      = 
| image                     = 
| image_size                = 
| alt                       = 
| caption                   = 
| birth_name                = 
| birth_date                = <!-- {{birth date|YYYY|MM|DD}} -->
| birth_place               = 
| death_date                = <!-- {{Death date and age|YYYY|MM|DD|YYYY|MM|DD}} (death date then birth) -->
| death_place               = 
| body_discovered           = 
| death_cause               = 
| resting_place             = 
| resting_place_coordinates = <!-- {{coord|LAT|LONG|display=inline,title}} -->
| residence                 = 
| nationality               = 
| ethnicity                 = 
| citizenship               = 
| other_names               = 
| known_for                 = 
| education                 = 
| alma_mater                = 
| employer                  = 
| notable works             =
| occupation                = 
| years_active              = 
| home_town                 = 
| salary                    = 
| networth                  = 
| height                    = 
| weight                    = 
| title                     = 
| term                      = 
| predecessor               = 
| successor                 = 
| party                     = 
| opponents                 = 
| boards                    = 
| religion                  = 
| spouse                    = 
| partner                   = 
| children                  = 
| parents                   = 
| relations                 = 
| callsign                  = 
| awards                    = 
| signature                 = 
| signature_alt             = 
| website                   = 
| footnotes                 = 
| box_width                 = 
| misc                      =
}}

Parameters

Do not use all these parameters for any one person. The list is long to cover a wide range of people. Only use those parameters that convey essential or notable information about the subject. Any parameters left blank or omitted will not be displayed. If a data field has more than one parameter name which can be used, the preferred name is listed first in bold print.

Parameter Explanation
name Common name of person (defaults to article name if left blank; provide birth_name (below) if different from name).
image Image name: abc.jpg, xpz.png, 123.gif, etc. If an image is desired but not available, one may add "yes" to the "needs-photo" section of the Template:WPBiography on the talkpage. Do not use Image:Replace this image male.svg, Image:Replace this image female.svg or other placeholder images; the proposal to use such placeholders has been rejected by the community.
image_size
(imagesize)
Size to display image: 200px (set width), or 200x300px (max width & max height). This defaults to 225px if empty or omitted.
alt Alt text for image, for visually impaired readers. See WP:ALT.
caption Caption for image, if needed. Try to include date of photo and the photographer.
birth_name Name at birth, if different from name.
birth_date Date of birth: {{birth date and age|1930|1|15}} (if living) or {{birth date|1930|1|15}} (if dead). See Template:Birth date for details.
birth_place Place of birth: city, administrative region, sovereign state.
death_date Date of death: {{death date and age|1995|10|9|1930|1|15}} (if birth date is known) or {{death date|1995|10|9}} (if birth date unknown). See Template:Death date for details.
death_place Place of death: city, administrative region, sovereign state.
body_discovered Place where the body was discovered (If different from place of death).
death_cause Cause of death.
resting_place Place of burial, ash-scattering, etc.
resting_place_coordinates Coordinates for place of burial, ash-scattering etc. Use {{coord}} template.
residence Location(s) where the person notably resides/resided, if different from birth place.
nationality Nationality. May be used instead of citizenship (below) or vice versa in cases where any confusion could result. Should only be used with citizenship when they somehow differ.
ethnicity Ethnicity.
citizenship Citizenship. See usage notes for nationality, above.
other_names Other notable names for the person, if different from name and birth_name.
known_for
(known)
A brief description of why the person is notable.
education Education.
alma_mater Alma mater
employer Employer, if relevant.
occupation Occupation.
home_town The place where the person was raised and matured, if different from birth place and residence.
salary Annual salary or compensation, if relevant.
networth Current estimated net worth, if relevant.
height If person was notable for their height, or if height is relevant.
weight If person was notable for their weight, or if weight is relevant. If used, this should also include the date.
title Multiple uses:

See also "awards" parameter, below, for awarded honors that are not really titles. A single award should not use both parameters.

term Years the person held the title listed above.
predecessor Person who previously held the title listed above.
successor Person who subsequently held the title listed above.
party If relevant. Field labeled Political party.
religion If relevant. Field labeled Religion.
boards For board of directors membership(s), if relevant. Field labeled Board member of.
spouse Name of spouse(s), followed by years of marriage. Use the format Name (1950–present) for current spouse and Name (1970–1999) for former spouse(s). Separate entries with a line break (<br />). For deceased persons still married at time of death, close the date range with death year.
partner For unmarried life partners (of any gender or sexual preference), not business partners. Use same format as spouse.
children Number of children (i.e. 3), or list of names if notable, in which case, separate entries with a line break (<br />).
parents Names of parents, if notable. Separate entries with a line break (<br />).
relatives
(relations)
Names of siblings or other relatives, if notable. Include the relationship in parentheses after the name (sister, uncle, etc). Separate entries with a line break (<br />).
callsign Amateur radio call-sign, if relevant.
awards Notable awards. See also "title" parameter, above, for awarded titles. A single award should not use both parameters.
signature An image of the person's signature. Image is displayed at a width of 128px, same format as {{Infobox Writer}}, {{Infobox officeholder}} and {{Infobox Philosopher}}.
signature_alt Alt text for the signature image. For example, for Image:ThomasJeffersonSignature.gif the alt text might be "Th: Jefferson".
website Official website only. Unofficial websites should be placed under ==External links== in the body of the article.
footnotes Notes about any of the infobox data.
box_width The infobox width, such as: box_width=220px (default: 22em). Space character between the number and the unit of measurement breaks the parameter.
misc Undefined.Template:Clarify

Examples

Bill Gates
Head and shoulders portrait of talking 50-year-old man in rimless glasses, business suit, and power red tie, with raised right hand gesturing.
At an IT forum in Denmark, 2004
Born
William Henry Gates III

(1955-10-28) October 28, 1955 (age 69)
OccupationChairman, Microsoft
Co-Chair, Bill & Melinda Gates Foundation
Net worthUS$ 56.0 billion (2007)
Spouse(s)Melinda Gates (since 1994)
Children3
WebsiteMicrosoft (Press Pass)
Gates Foundation
Signature
William H. Gates III
{{ infobox person
| name          = Bill Gates
| image         = Bill Gates 2004 cr.jpg
| image_size    = 170px
| alt           = Head and shoulders portrait of talking 50-year-old man in rimless glasses, business suit, and power red tie, with raised right hand gesturing.
| caption       = At an IT forum in Denmark, 2004
| birth_name    = William Henry Gates III
| birth_date    = {{birth date and age|1955|10|28}}
| birth_place   = [[Seattle, Washington]]
| occupation    = Chairman, [[Microsoft]]<br />Co-Chair, [[Bill & Melinda Gates Foundation]]
| salary        = [[US$]] 966,667<ref>Year 2006 compensation: salary $616,667, bonus $350,000. From Microsoft's [http://www.microsoft.com/msft/reports/proxy2006.mspx Proxy Statement].</ref>
| networth      = US$ 56.0 billion (2007)
| spouse        = [[Melinda Gates]] (since 1994)
| children      = 3
| signature     = BillGates Signature.svg
| signature_alt = William H. Gates III
| website       = [http://www.microsoft.com/ Microsoft] [http://www.microsoft.com/presspass/exec/billg/default.mspx (Press Pass)]<br>[http://www.gatesfoundation.org Gates Foundation]
| box_width     = 200px
}}

Microformat

The HTML markup produced by this template includes an hCard microformat, which makes the person's details parsable by computers, either acting automatically to catalogue articles across Wikipedia or via a browser tool operated by a reader, to (for example) add the subject to an address book or database. For more information about the use of microformats on Wikipedia, please see the microformat project.

Sub-templates

Date-of-birth ("bday") information will only be included in the microformat if {{birth date}}, or {{birth date and age}} are used in the infobox. (Do not use these if the date is before 1583). Be cautious about using these if the person is still living, per WP:DOB.

To include a URL, use {{URL}}.

Please do not remove instances of these sub-templates.

Classes

hCard uses HTML classes including:

  • adr
  • agent
  • bday
  • birthplace
  • category
  • country-name
  • deathdate
  • deathplace
  • extended-address
  • family-name
  • fn (required)
  • given-name
  • honorific-prefix
  • honorific-suffix
  • label
  • locality
  • n
  • nickname
  • note
  • org
  • role
  • url
  • vcard

Please do not rename or remove these classes nor collapse nested elements which use them.

Template:Refs
  1. Year 2006 compensation: salary $616,667, bonus $350,000. From Microsoft's Proxy Statement.