Difference between revisions of "Template:Infobox comics organization/doc"

From blackwiki
Jump to navigation Jump to search
imported>Horkana
(→‎Usage: use same indentation as most other templates.)
imported>Wikid77
(540 changes: noted "Placing images uses 4 parameters"; new imagealt=xx to set alt-text +example; shortened other descriptions to avoid "shaggy dog story" of too much wording; fixed spelling errors)
Line 7: Line 7:
 
<!--Wikipedia:WikiProject Comics-->
 
<!--Wikipedia:WikiProject Comics-->
 
| name        =  
 
| name        =  
| image        = <!-- file name format only -->
+
| image        = <!-- file name only-->
| imagesize    = <!-- default 250 -->
+
| imagesize    = <!-- 250 or upright=1.1-->
 +
| imagealt    = <!-- describe image-->
 
| caption      =  
 
| caption      =  
 
| publisher    =  
 
| publisher    =  
Line 15: Line 16:
 
| debutyr      =  
 
| debutyr      =  
 
| debuthead    =  
 
| debuthead    =  
| debut#       =  
+
| debut1       =  
| debutmo#     =  
+
| debutmo1     =  
| debutyr#     =  
+
| debutyr1     =  
| debuthead#   =  
+
| debuthead1   =  
 
| creators    =  
 
| creators    =  
 
| type        =  
 
| type        =  
 
| business    =  
 
| business    =  
| organisation =  
+
| organization = <!-- or organisation= -->
| organization =
 
 
| team        =  
 
| team        =  
 
| base        =  
 
| base        =  
Line 43: Line 43:
 
|image        = example.jpg
 
|image        = example.jpg
 
|imagesize    =  
 
|imagesize    =  
 +
|imagealt    = {{{imagealt}}}
 
|caption      = {{{caption}}}
 
|caption      = {{{caption}}}
 
|publisher    = {{{publisher}}}
 
|publisher    = {{{publisher}}}
Line 67: Line 68:
 
====Common elements====
 
====Common elements====
 
*Most of the parameters are designed only to show in the infobox if something is entered. They can be left in the template and empty if the item does not pertain to the article or if the information is not known at the time the template is added.
 
*Most of the parameters are designed only to show in the infobox if something is entered. They can be left in the template and empty if the item does not pertain to the article or if the information is not known at the time the template is added.
*The '''name''' field is an exception. If left empty the infobox will not generate a title. If the title for the infobox is the same as the title of the article, '''name''' can either be deleted or commented out. The later is preferable since the name of the article, or the preferred name of the infobox may change.
+
*The '''name''' field is an exception. If left empty, the infobox will not show a title. If the title is the same as the title of the article, '''name''' can either be deleted or commented out. The later is preferable since the name of the article, or the preferred name in the infobox may change.
 
*For multiple items in one field, '''separate each with <nowiki><br /></nowiki>'''.
 
*For multiple items in one field, '''separate each with <nowiki><br /></nowiki>'''.
 
*::''Example:'' creators=Stan Lee<nowiki><br /></nowiki>Jack Kirby
 
*::''Example:'' creators=Stan Lee<nowiki><br /></nowiki>Jack Kirby
*Placing images in the infobox uses two fields:
+
*Placing images uses 4 parameters: ''image'', ''imagesize'', ''imagealt'' and ''caption''.
**'''image''' which is just the filname of the image. The template will add the markup to show the image.
+
**'''image''' is just the filename of the image. ''Example:'' image=example.jpg  
**::''Example:'' image= example.jpg  
+
**'''imagesize''' is the ''width'' of the image. Use number imagesize=200 or upright=1.1 (default: 250).
**'''imagesize''' which is the ''width'' the image will display at. The template will only accept a number here. If left empty or if a string (such as "225px") is entered, the image will default to 250px wide.
+
***If image is too tall, reduce size below 250.
***If you find the image to be too tall, reduce the size below 250px.
+
***The maximum width number is 250; for larger, use imagesize=upright=1.20 or such. Use upright=0.95 for 95% of each user's default image size.
***The parameter is capped at maximum width of 250. Entering values grater than this will result in the default setting being used.  
+
**'''imagealt''' describes the image alt-text. ''Example:'' for [[Superman]], imagealt=Drawing of man in blue bodysuit with chestplate of red "S" stretched across yellow triangle.
***The image will also cap at 450 in height.
+
**'''caption''' appears below the image. Keep it short, but indicate the original published source of the image and artist(s).<br>Example: A comic book issue would have "caption=' 'Wolverine' ' vol 2, #17. Art by John Byrne".
*The '''caption''' will appear below the image. Keep it short, but indicate the original source published source of the image and the artist(s).
+
*'''debut''', is the issue of first appearance of the group. Example: ''Fantastic Four'' #3.
*::''Example:'' A comic book issue cover would be captioned as "''Wolverine'' vol 2, #17. Art by John Byrne."
+
**'''debutmo''' and '''debutyr''' can be used along with '''debut'''. When this is done: ''debut'' is only the title, volume and issue number; ''debutmo'' is the month, season or week of the issue's cover date. This field is optional if no month is shown.
*For '''debut''', provide the first appearance of the organization as such. Example: ''Fantastic Four'' #3.
+
**'''debutyr''' is the four-digit year in the cover date. This links the year to the related "Year in comics" article. If omitted, only text in debut=xx will display.
**'''debutmo''' and '''debutyr''' can be used in conjunction with '''debut'''. When this is done:
+
**For multiple versions of the organization, multiple "First appearances" may be indicated. Use the following:
***'''debut''' is only the title, volume number, and issue number
+
***'''debuthead''' to add a note above the debut as to which version it is.
***'''debutmo''' is the month, season or week specified in the issue's cover date. This field is optional so it can be left out if no "month" is part of the cover date.
+
***'''debut#''', '''debutmo#''', '''debutyr#''', and '''debuthead#''' should be added for the additional debuts. Replace "#" with number 1, 2 or 3 (allows 3 more debuts: '''debut1''', '''debut2''', '''debut3''').
***'''debutyr''' is the four digit year noted in the cover date. This will automatically link the year to the appropriate "Year in comics" list article. If this field is not present, only the information in '''debut''' will show up in the infobox.
 
**If more than one version of the organization has been shown, multiple "First appearances" may be indicated. The following additional fields can be used for this:
 
***'''debuthead''' to add a not above the debut asto which version it is.
 
***'''debut#''', '''debutmo#''', '''debutyr#''', and '''debuthead#''' should be added for the additional debuts. Replace "#" with a number (currently the template is set up for 3 additional debuts).
 
  
 
====Specific elements====
 
====Specific elements====
  
*The '''creators''' field should list the creators of '''the team or group''', not the individual members.
+
*'''creators''' should list the creators of the team or group, not the individual members.
*'''type''' is the type of organization or business. Examples include: newspaper, manufacturing, computer software, government agency, law firm, etc. For teams of adventures, superheroes, and supervillains, leave this field blank.
+
*'''type''' is the type of organization or business. Examples include: type=newspaper, type=manufacturing, or computer software, government agency, law firm, etc. For teams of adventures, superheroes, and supervillains, leave this field blank.
 
*The infobox uses a set of mutually exclusive logical fields to determine how to display '''type'''. These fields are:
 
*The infobox uses a set of mutually exclusive logical fields to determine how to display '''type'''. These fields are:
 
**'''business''' - This will also have the character lists present as "Owner(s)" and "Employee(s)"
 
**'''business''' - This will also have the character lists present as "Owner(s)" and "Employee(s)"
**'''organisation''' - This will also have the character lists present as "Leader(s)" and "Agent(s)". Note that this is for groups that, within the stories, operate in areas not using American English.
+
**'''organisation''' (or "'''organization'''") - This will also have the character lists present as "Leader(s)" and "Agent(s)". **'''team''' - If '''type''' is left blank, this option should be selected so that the infobox properly shows "Leader(s)".
**'''organization''' - This functions just like '''organisation''', only geared to American English.
 
**'''team''' - If '''type''' is left blank, this option should be selected so that the infobox properly shows "Leader(s)".
 
 
*'''owners''' is the list of individual owners (business) or leaders (organizations and teams) of the group. This should be limited to notable characters. For teams, if there is no clear leader, or if it is a rotating title, this field can be left blank in favor of '''members'''.
 
*'''owners''' is the list of individual owners (business) or leaders (organizations and teams) of the group. This should be limited to notable characters. For teams, if there is no clear leader, or if it is a rotating title, this field can be left blank in favor of '''members'''.
 
*'''employees''' is the list of other notable characters associated with the business as employees or the organization as agents. For teams and organizations where "agent" is not appropriate, please use '''members'''
 
*'''employees''' is the list of other notable characters associated with the business as employees or the organization as agents. For teams and organizations where "agent" is not appropriate, please use '''members'''
Line 105: Line 100:
 
This infobox has been designed to automatically place articles its added to into appropriate categories under [[:Category:Fictional organizations]] (''Note:'' [[:Category:Fictional newspapers]] lists under [[:Category:Fictional media]]). To do this the following parameters are used.
 
This infobox has been designed to automatically place articles its added to into appropriate categories under [[:Category:Fictional organizations]] (''Note:'' [[:Category:Fictional newspapers]] lists under [[:Category:Fictional media]]). To do this the following parameters are used.
 
*'''cat''' is used for cases where the primary category is a specific type of organization. Due to the limitations of the template, the entry for this parameter cannot be capitalized.
 
*'''cat''' is used for cases where the primary category is a specific type of organization. Due to the limitations of the template, the entry for this parameter cannot be capitalized.
**'''Subcat''' can be used to enter a comics publisher. In cases where '''<tt>cat= teams</tt>''' is set, '''subcat''' places the category into the "<Publisher> teams". In all other cases, if '''subcat''' is set to either "DC Comics" or "Marvel Comics", the appropriate organizations category will be added, all other publishers will be ignored. Please review the subcategories to make sure a particular combination of '''cat''' and '''subcat''' exists.
+
**'''subcat''' can be used to enter a comics publisher. In cases where <tt>cat=teams</tt> is set, '''subcat''' places the category into the "<Publisher> teams". In all other cases, if ''subcat'' is set to either "DC Comics" or "Marvel Comics", the appropriate organizations category will be added; all other publishers will be ignored. Please review the subcategories to make sure a particular combination of ''cat'' and ''subcat'' exists.
 
*'''altcat''' is used for cases where the of the appropriate category does not end in a particular organization type.
 
*'''altcat''' is used for cases where the of the appropriate category does not end in a particular organization type.
**'''''Note:''''' '''subcat''' and '''altcat''' are mutually exclusive. If both are left empty, the article wil be placed into [[:Category:Fictional organizations]] by default.
+
**'''''Note:''''' '''subcat''' and '''altcat''' are mutually exclusive. If both are left empty, the article will be linked into "[[:Category:Fictional organizations]]" by default.
 
**'''hero''' and '''villain''' are mutually exclusive logical functions. If one is set, '''cat''' and '''subcat''' will place the article into the proper "superhero" or "supervillains" subcategory instead of "teams".  
 
**'''hero''' and '''villain''' are mutually exclusive logical functions. If one is set, '''cat''' and '''subcat''' will place the article into the proper "superhero" or "supervillains" subcategory instead of "teams".  
 
*'''sortkey''' is the title by which the article will be sorted in the categories placed by the template. This sorting will default to <nowiki>{{PAGENAME}}</nowiki> and will override <nowiki>{{DEFAULTSORT}}</nowiki> listings in the article. Due to markup limitations, this parameter will not recognize a leading space.
 
*'''sortkey''' is the title by which the article will be sorted in the categories placed by the template. This sorting will default to <nowiki>{{PAGENAME}}</nowiki> and will override <nowiki>{{DEFAULTSORT}}</nowiki> listings in the article. Due to markup limitations, this parameter will not recognize a leading space.

Revision as of 17:27, 4 April 2012

This template is designed to be used in articles about organizations that appear in comic books. These may be companies, military units, governments, teams, or the like.

Usage

{{Infobox comics organization
<!--Wikipedia:WikiProject Comics-->
| name         = 
| image        = <!-- file name only-->
| imagesize    = <!-- 250 or upright=1.1-->
| imagealt     = <!-- describe image-->
| caption      = 
| publisher    = 
| debut        = 
| debutmo      = 
| debutyr      = 
| debuthead    = 
| debut1       = 
| debutmo1     = 
| debutyr1     = 
| debuthead1   = 
| creators     = 
| type         = 
| business     = 
| organization = <!-- or organisation= -->
| team         = 
| base         = 
| owners       = 
| employees    = 
| members      = 
| fullroster   = 
| cat          = 
| subcat       = 
| altcat       = 
| hero         = 
| villain      = 
| sortkey      = {{PAGENAME}}
}}
{{{name}}}
Publication information
Publisher{{{publisher}}}
First appearance{{{debut}}}
Created by{{{creators}}}
In-story information
Type of ?{{{type}}}
Base(s){{{base}}}
?{{{owners}}}
Member(s){{{employees}}}{{{members}}}
Roster
See: {{{fullroster}}}

Parameter notes

Common elements

  • Most of the parameters are designed only to show in the infobox if something is entered. They can be left in the template and empty if the item does not pertain to the article or if the information is not known at the time the template is added.
  • The name field is an exception. If left empty, the infobox will not show a title. If the title is the same as the title of the article, name can either be deleted or commented out. The later is preferable since the name of the article, or the preferred name in the infobox may change.
  • For multiple items in one field, separate each with <br />.
    Example: creators=Stan Lee<br />Jack Kirby
  • Placing images uses 4 parameters: image, imagesize, imagealt and caption.
    • image is just the filename of the image. Example: image=example.jpg
    • imagesize is the width of the image. Use number imagesize=200 or upright=1.1 (default: 250).
      • If image is too tall, reduce size below 250.
      • The maximum width number is 250; for larger, use imagesize=upright=1.20 or such. Use upright=0.95 for 95% of each user's default image size.
    • imagealt describes the image alt-text. Example: for Superman, imagealt=Drawing of man in blue bodysuit with chestplate of red "S" stretched across yellow triangle.
    • caption appears below the image. Keep it short, but indicate the original published source of the image and artist(s).
      Example: A comic book issue would have "caption=' 'Wolverine' ' vol 2, #17. Art by John Byrne".
  • debut, is the issue of first appearance of the group. Example: Fantastic Four #3.
    • debutmo and debutyr can be used along with debut. When this is done: debut is only the title, volume and issue number; debutmo is the month, season or week of the issue's cover date. This field is optional if no month is shown.
    • debutyr is the four-digit year in the cover date. This links the year to the related "Year in comics" article. If omitted, only text in debut=xx will display.
    • For multiple versions of the organization, multiple "First appearances" may be indicated. Use the following:
      • debuthead to add a note above the debut as to which version it is.
      • debut#, debutmo#, debutyr#, and debuthead# should be added for the additional debuts. Replace "#" with number 1, 2 or 3 (allows 3 more debuts: debut1, debut2, debut3).

Specific elements

  • creators should list the creators of the team or group, not the individual members.
  • type is the type of organization or business. Examples include: type=newspaper, type=manufacturing, or computer software, government agency, law firm, etc. For teams of adventures, superheroes, and supervillains, leave this field blank.
  • The infobox uses a set of mutually exclusive logical fields to determine how to display type. These fields are:
    • business - This will also have the character lists present as "Owner(s)" and "Employee(s)"
    • organisation (or "organization") - This will also have the character lists present as "Leader(s)" and "Agent(s)". **team - If type is left blank, this option should be selected so that the infobox properly shows "Leader(s)".
  • owners is the list of individual owners (business) or leaders (organizations and teams) of the group. This should be limited to notable characters. For teams, if there is no clear leader, or if it is a rotating title, this field can be left blank in favor of members.
  • employees is the list of other notable characters associated with the business as employees or the organization as agents. For teams and organizations where "agent" is not appropriate, please use members
  • For groups that have a list of members as either a subsection of the article or as a separate list article, use fullroster to link to there. In these cases restrict owners, employees, and members to key, or core characters, if the fields are used at all.
  • base should list a group's most significant bases, including the current one (where applicable). Limit this to three at most, however.

Categories

This infobox has been designed to automatically place articles its added to into appropriate categories under Category:Fictional organizations (Note: Category:Fictional newspapers lists under Category:Fictional media). To do this the following parameters are used.

  • cat is used for cases where the primary category is a specific type of organization. Due to the limitations of the template, the entry for this parameter cannot be capitalized.
    • subcat can be used to enter a comics publisher. In cases where cat=teams is set, subcat places the category into the "<Publisher> teams". In all other cases, if subcat is set to either "DC Comics" or "Marvel Comics", the appropriate organizations category will be added; all other publishers will be ignored. Please review the subcategories to make sure a particular combination of cat and subcat exists.
  • altcat is used for cases where the of the appropriate category does not end in a particular organization type.
    • Note: subcat and altcat are mutually exclusive. If both are left empty, the article will be linked into "Category:Fictional organizations" by default.
    • hero and villain are mutually exclusive logical functions. If one is set, cat and subcat will place the article into the proper "superhero" or "supervillains" subcategory instead of "teams".
  • sortkey is the title by which the article will be sorted in the categories placed by the template. This sorting will default to {{PAGENAME}} and will override {{DEFAULTSORT}} listings in the article. Due to markup limitations, this parameter will not recognize a leading space.

See also

Related infoboxes

Composite infoboxes