View source for Template:InfoBoxPerson/doc

{{for|an infobox for fictional characters|Template:InfoBoxCharacter}}
{{Documentation subpage}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}
<!-- Categories go at the bottom of this page -->
{{tl|InfoBoxPerson}} may be used to summarize information about a particular person, usually at the top of an article.

== 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 ===
{{InfoBoxPerson
| name          = ''name''
| image         = No-image-available.jpg
| alt           = alt
| caption       = ''caption''
| birth_name    = ''birth_name''
| birth_date    = ''birth_date''
| death_date    = ''death_date''
| other_names   = ''other_names''
| occupation    = ''occupation''
| years_active  = ''years_active''
| known_for     = ''known_for''
}}
<syntaxhighlight lang="wikitext" style="overflow:auto; line-height:1.2em;">
{{InfoBoxPerson
| name          = <!-- defaults to article title when left blank -->
| image         = <!-- filename only, no "File:" or "Image:" prefix, and no enclosing [[brackets]] -->
| alt           = <!-- descriptive text for use by speech synthesis (text-to-speech) software -->
| caption       = <!-- if relevant -->
| birth_name    = <!-- only use if different from name -->
| birthdate     = <!-- {{Birth date and age|YYYY|MM|DD}} for living people supply only the year with {{Birth year and age|YYYY}} unless the exact date is already widely published. For people who have died, use {{Birth date|YYYY|MM|DD}}. -->
| death_date    = <!-- {{Death date and age|YYYY|MM|DD|YYYY|MM|DD}} (DEATH date then BIRTH date) -->
| other_names   = <!-- if relevant -->
| occupation    = <!-- if relevant -->
| years_active  = <!-- if known -->
| known_for     = <!-- if relevant -->
}}
</syntaxhighlight>
{{clear}}

=== Blank template with all parameters ===

{{InfoBoxPerson
| name          = ''name''
| image         = No-image-available.jpg
| alt           = alt
| caption       = ''caption''
| birth_name    = ''birth_name''
| birth_date    = ''birth_date''
| birth_place   = ''birth_place''
| death_date    = ''death_date''
| death_place   = ''death_place''
| other_names   = ''other_names''
| siglum        = ''siglum''
| nationality   = ''nationality''   
| citizenship   = ''citizenship''   
| education     = ''education''
| alma_mater    = ''alma_mater''
| occupation    = ''occupation''
| employer      = ''employer''
| title         = ''title''
| website       = ''website''
| signature     = No-image-available.jpg
| years_active  = ''years_active''
| known_for     = ''known_for''
| works         = ''works''  
| credits       = ''credits''
| sarnaname     = ''sarnaname''
| btforumhandle = ''btforumhandle''
| btpersona     = ''btpersona''
}}

<syntaxhighlight lang="wikitext" style="overflow: auto;">
{{InfoBoxPerson
| name          = <!-- defaults to article title when left blank -->
| image         = <!-- filename only, no "File:" or "Image:" prefix, and no enclosing [[brackets]] -->
| alt           = <!-- as needed -->
| caption       = <!-- as needed -->
| birth_name    = <!-- only use if different from name -->
| birth_date    = <!-- {{Birth date and age|YYYY|MM|DD}} for living people supply only the year with {{Birth year and age|YYYY}} unless the exact date is already widely published. For people who have died, use {{Birth date|YYYY|MM|DD}}. -->
| birth_place   = <!-- if known --> 
| death_date    = <!-- {{Death date and age|YYYY|MM|DD|YYYY|MM|DD}} (DEATH date then BIRTH date) -->
| death_place   = <!-- if known --> 
| other_names   = <!-- as needed -->
| siglum        = <!-- as needed -->
| nationality   = <!-- if known --> 
| citizenship   = <!-- if known -->
| education     = <!-- if known -->
| alma_mater    = <!-- if known -->
| occupation    = <!-- if relevant -->
| employer      = <!-- if relevant -->
| title         = <!-- if relevant -->
| website       = <!-- if known -->
| signature     = <!-- filename only, no "File:" or "Image:" prefix, and no enclosing [[brackets]] -->
| years_active  = <!-- if relevant -->
| known_for     = <!-- brief description of why the person is notable. -->
| works         = <!-- intended to be normally used to link to the category or the listing on the page -->
| credits       = <!-- intended to be normally used to link to the category or the listing on the page -->
| sarnaname     = <!-- if known -->
| btforumhandle = <!-- if known -->
| btpersona     = <!-- if known -->
}}

</syntaxhighlight>
{{Clear}}

== Parameters ==
{| class="wikitable"
! Parameter
! Explanation
|-
| {{mono|name}}
| Common name of person (defaults to article name if left blank; provide {{para|birth_name}} (below) if different from {{para|name}}). If middle initials are specified (or implied) by the lead of the article, and are not specified separately in the {{para|birth_name}} parameter, include them here. ''Do not put honorifics or alternative names in this parameter.'' There are separate parameters for these things, covered below.
|-
| {{mono|image}}
| Image name: {{pval|abc.jpg}}, {{pval|xpz.png}}, {{pval|123.gif}}, etc., without the {{code|File:}} or {{code|Image:}} prefix.
|-
| {{mono|image_upright}}
| Scales the image thumbnail from its default size by the given factor. Values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%).
|-
| {{mono|landscape}}
| Set to <code>yes</code> when using wide, short images. The image height (rather than width) will be limited to 200 pixels. 
|-
| {{mono|alt}}
| Descriptive alternative text for images or alt text for the image, for visually impaired readers. One word (such as photograph) is rarely sufficient. Do not copy-paste the value of "caption" into this parameter.
|-
| {{mono|caption}}       
| Image caption, if any; in particular, please provide a date here for the image if at all possible
|-
| {{mono|birth_name}}
| Name at birth; only use if different from {{para|name}}.
|-
| {{mono|birth_date}}
| Date of birth: Use {{tlx|birth date and age}} (if living) or {{tlx|birth date}} (if dead). {{crossref|See template's page for details on usage.}} If only a year of birth is known, or age as of a certain date, consider using {{tlx|birth year and age}} or {{tlx|birth based on age as of date}}. Supply only the year unless the exact date is already widely published. Treat such cases as if only the year is known, so use {{tlx|birth year and age}} or a similar option.
|-
| {{mono|{{vanchor|birth_place}}}}
| Place of birth: {{var|city}}, {{var|administrative region}}, {{var|country}}.
* Use the name of the birthplace at the time of birth, e.g.: {{pval|Saigon}} (prior to 1976) or {{pval|Ho Chi Minh City}} (post-1976).
* Do not use a flag template, coat of arms, or other icon.
* Omit unnecessary or redundant details. For example, it is not necessary to state: {{!xt|{{pval|New York City, [[w:New York (state)|New York]], United States}}}} when {{xt|{{pval|New York City, U.S.}}}} conveys essentially the same information more concisely.
* Country name should be visible (not just in a link target). Well-known countries should generally not be linked, but historical and less-well-known countries can be.
* For subsequent places (of death, etc.) it is not necessary to repeat jurisdictional details or links for the same place name.
|-
| {{mono|death_date}}
| Date of death: Use {{tlx|death date and age}} (if birth date is known) or {{tlx|death date}} (if birth date unknown). {{crossref|See template's page for details on usage.}} If exact dates are unknown, consider using {{tlx|death year and age}}. The templates mentioned in this paragraph emit metadata indicating the date is in the Gregorian calendar; if the date is in the Julian calendar, do not use these templates, just write the date.
|-
| {{mono|death_place}}
| Place of death: {{var|city}}, {{var|administrative region}}, {{var|country}}.&nbsp; ({{crossref|See {{para|birth_place}}, [[#birth place|above]], for instructions on how to use this parameter}}, including: no flag templates, inappropriate linking, redundancy, anachronisms, "country" definitions, etc.)
|-
| {{mono|other_names}}
| Other notable names for the person, if different from {{para|name}}. This can include stage names, maiden/married names, nicknames, pen names, etc.
|-
| {{mono|siglum}}
| [[w:Siglum|Siglum]] or monogram, a text shortcut (often formed from the initials of the name, with variations) used to sign work, if relevant.
|-
| {{mono|nationality}}
| Designated for legal [[w:nationality|nationality]], not to be confused with ethnicity.
|-
| {{mono|citizenship}}
| Country of legal citizenship or nationality. Rarely needed - omit if the same as birth country. {{crossref|Also see {{para|birth_place}}, [[#birth place|above]], for instructions on how to use this parameter}}, including: no flag templates, inappropriate linking, anachronisms, "country" definitions, etc.
|-
| {{mono|education}}
| Education, e.g., degree, institution and graduation year, if relevant. If very little information is available or relevant, the {{para|alma_mater}} parameter may be more appropriate.
|-
| {{mono|alma_mater}}
| ''[[w:Alma mater|Alma mater]]''. This parameter is a more concise alternative to (not addition to) {{para|education}}, and will often consist of the linked name of the last-attended institution of higher education (not secondary schools). It is usually not relevant to include either parameter for non-graduates.
|-
| {{mono|occupation}}
| Occupation(s) as given in the lead. Use list markup for three or more entries, e.g. with {{tlx|flatlist}}. Please observe [[w:sentence case|sentence case]] and capitalise only the first letter of the first item; e.g.:
{{block indent|1={{Flatlist|
* Writer
* game designer
* voice actor
}}}}
|-
| {{mono|employer}}
| Employer(s), if relevant.
|-
| {{mono|title}}
| Multiple uses:
* Formal title, 
* Awarded title
* Job title
* A combination of the above
For multiple entries, use an [[#Inline lists|inline list]].
|-
| {{mono|website}}<br/>{{mono|homepage}}
| Official website only. Unofficial websites should be placed under <code><nowiki>==External links==</nowiki></code> in the body of the article. Use {{tlx|URL}} as in {{tnull|URL|Example.com}}. Do not display the {{samp|www.}} part unless the site requires it.
|-
| {{mono|years_active}}
| Date range in years during which the subject was active in their principal occupation(s) and/or other activity for which they are notable. Use the format {{code|1950–2000}}, or {{code|1970–present}} if still active. [[BattleIntelligence:Manual of Style/Dates and numbers#Ranges|Date ranges]] always use an [[BattleIntelligence:Manual of Style#En dashes|en dash]], not hyphen. If approximate (''[[wikt:circa#English|circa]]'') dates are known for either or both, put them in the {{para|birthdate}} and {{para|died}} parameters. Helpful template: {{tlx|circa}}.
|-
| {{mono|known_for}}
| A brief description of why the person is notable.
|-
| {{ubl|{{mono|works}}<br/>{{mono|credits}}
| The {{para|credits}} and/or {{para|works}} parameters are intended to be normally used to link to the category or the listing on the page
|-
| {{mono|sarnaname}}   
| The username of the person in question here on Sarna.net, if applicable
|-
| {{mono|btforumhandle}}
| The username of the person in question on the official BattleTech forum, if applicable
|-
| {{mono|btpersona}}     
| The BattleTech character identified with the person in question
|}

== Inline lists ==
{{Main|BattleIntelligence:Manual of Style/Lists#Horizontal lists|BattleIntelligence:Manual of Style/Lists#Unbulleted lists}}
Parameters with multiple values should be formatted with inline-list templates.

'''Horizontal''' ones include {{tlx|hlist}} or {{tlx|flatlist}}. In [[BattleIntelligence:Manual of Style/Lists#Horizontal lists|horizontal style]], only the first item is capitalized (aside from [[BattleIntelligence:Manual of Style/Capital letters#Proper names|proper names]]).
This style is best for short items, and few of them. Mid-dots, commas or semicolons are available as separators (use semicolons or mid-dots if any items contain their own commas). For example:
* {{para|parameter_name|{{tlp|hlist |Foo |bar |baz}}}} → {{hlist |Foo |bar |baz}}
* {{para|parameter_name|{{tlp|cslist |Foo |bar |baz}}}} → {{cslist |Foo |bar |baz}}
* {{para|parameter_name|{{tlp|cslist |Foo, fee |bar, bor |baz, biz |semi=true}}}} → {{cslist |Foo, fee |bar, bor |baz, biz |semi=true}}

Horizontal list example with {{tlx|hlist|Item one|item two|item three}}: {{hlist|Item one|item two|item three}}

'''Vertical''' templates are {{tlx|plainlist}} and {{tlx|unbulleted list}} (vertical), use [[BattleIntelligence:Manual of Style/Lists#Unbulleted lists|unbulleted, non-indented lists]] for clean display in infoboxes. Entries may be all [[w:sentence case|sentence case]], or all lowercase (aside from proper names) after the first.

This style is best for long items, and longer lists. For long lists of information that may not be of immediate interest but retained for reference, the {{tlx|collapsible list}} template can be used; this is not a universally accessible option, so should not be used for key information.

''[[BattleIntelligence:Manual of Style/Lists#Line breaks|Do not use {{tag|br|s}} markup]]'' to create fake lists, as in: {{!mxt|<nowiki>Item one<br />item two<br />item three</nowiki>}}.

Vertical list example:, using {{tlx|unbulleted list|Item one|item two|item three}}:
{{unbulleted list|Item one|item two|item three}}

== Example ==
{{InfoBoxPerson
| name          = Michael A. Stackpole
| image         = Michael Stackpole by Gage Skidmore.jpg
| caption       = Stackpole at the 2017 [[w:Phoenix Comicon|Phoenix Comicon]]
| alt           = Picture of Michael Stackpole as he was in 2017 at the Phoenix Comicon
| upright       = 1.5
| birth_date    = {{Birth date and age|1957|11|27|df=yes}}
| nationality   = American
| occupation    = {{ubl|Writer|Game designer}}
| years_active  = 1988 - Present
| known_for     = BattleTech Fiction
| works		= {{cl|Works by Michael A. Stackpole}}
| sarnaname     = <!-- if known -->
| btforumhandle = <!-- if known -->
| btpersona     = [[Gustavus Michaels]]
| homepage      = [http://stormwolf.com stormwolf.com]
}}
<syntaxhighlight lang="wikitext" style="overflow:auto">
{{InfoBoxPerson
| name          = Michael A. Stackpole
| image         = Michael Stackpole by Gage Skidmore.jpg
| caption       = Stackpole at the 2017 [[w:Phoenix Comicon|Phoenix Comicon]]
| alt           = Picture of Michael Stackpole as he was in 2017 at the Phoenix Comicon
| upright       = 1.5
| birth_date    = {{Birth date and age|1957|11|27|df=yes}}
| nationality   = American
| occupation    = {{ubl|Writer|Game designer}}
| years_active  = 1988 - Present
| known_for     = BattleTech Fiction
| works		= {{cl|Works by Michael A. Stackpole}}
| sarnaname     = <!-- if known -->
| btforumhandle = <!-- if known -->
| btpersona     = [[Gustavus Michaels]]
| homepage      = [http://stormwolf.com stormwolf.com]
}}
</syntaxhighlight>

== Tracking categories ==
The following categories are used to track errors:
* {{Clc|Category:Pages using InfoboxPerson with unknown parameters}}

<includeonly>{{Sandbox other||
<!-- Categories go here and interwikis go in Wikidata -->
[[Category:Infobox templates|Person]]
}}</includeonly>