Template:United States topic/doc

This template allows for the quick creation of a navigational template for any group of articles which contains the names of the several States united. It uses to create the navigation box.

Mandatory

 * name
 * Mandatory when creating a new template (i.e. Template:Hospitals in the United States), otherwise the "view· talk· edit" links will connect to Template:United States topic. You can enter  for this value as a shortcut.

''One of the following combinations is needed to create the links:
 * prefix
 * Text to be placed before the U.S. state name. The prefix text is always followed by a space. For example:   would create a title List of airports in the United States and a body containing state names linked to List of airports in Alabama, List of airports in Alaska, etc.
 * Note: In instances when only prefix is specified, the template inserts "the" between the prefix text and "United States", creating the title List of airports in the United States instead of List of airports in United States. In the body it does the same for the Northern Mariana Islands and the United States Virgin Islands.


 * suffix
 * Places text after the U.S. state name. For example:   would create a title United States National Guard and a body containing state names linked to Alabama National Guard, Arizona National Guard, etc.
 * Note: An underscore is used in place of the leading space in the suffix. This is done to allow the use of suffixes without a leading space, as in the following example. A title should be specified to avoid the underscore appearing in the title.


 * prefix and suffix
 * Places text before and after the U.S. state name. For example:   and   would create a title Index of United States-related articles and a body containing state names linked to Index of Alabama-related articles, Index of Alaska-related articles, etc.

Optional

 * state


 * title
 * Text that appears centered in the titlebar (the top bar). This is optional because the use of either prefix, suffix or both will automatically generate a title if the title parameter is not supplied. This parameter is not automatically wiki-linked. For example:   generates the title Rivers in the United States.


 * navbar *
 * Defaults to . If set to , the v • d • e links on the left side of the titlebar will not be displayed, and padding will be automatically used to keep the title centered.  Use   to remove the v • d • e links, but not apply padding (this is for advanced use only; the "plain" option should suffice for most applications where a navbar is not desired).  Note that it is highly recommended that one does not hide the navbar, in order to make it easier for users to edit the template, and to keep a standard style across pages.

Excluding groups
In some instances the Fœderal Capital Territory, U.S. Territories (Insular Areas) or U.S. Minor Outlying Islands may not be relevant to or have their own articles on a particular topic. To disable their inclusion in the template and avoid unnecessary red links, add any or all of the following parameters:


 * exclude-fct
 * Set to any value this excludes display of the group named Federal District which links to Fœderal Capital Territory.


 * exclude-ter
 * Set to any value this excludes display of the group named Territories (Insular Areas) which links to American Samoa, Guam, etc.


 * exclude-isl
 * Set to any value this excludes display of the group named Outlying Islands which links to Baker Island, Howland Island, etc. Note: even if exclude-isl is not set, links will not appear for pages that do not exist. If none of the pages in this group exist, the heading for the group will not appear either.

Adding groups and lists
Some templates may require a list of links not already included in the template. These can be specified as follows:


 * group5
 * Header text displayed in cell to left of text specified in list5.


 * list5
 * Text or a list of links that is displayed below the state and territory links.


 * group6
 * Header text displayed in cell to left of text specified in list6.


 * list6
 * Text or a list of links that is displayed below the state and territory links.


 * above
 * A full-width cell (no group header) displayed above the template's body (between the title and U.S. state links).


 * below
 * A full-width cell (no group header) displayed below the template's body.

Change state name used in link
By default this template uses "Georgia (U.S. state)" for the state of Georgia, "New York (state)" for the state of New York, and "Washington (state)" for the state of Washington. Links for the Fœderal Capital Territory use "Fœderal Capital Territory"

The following parameters allow for substitution where the article name does not use the default.


 * GA
 * Replace "Georgia (U.S. state)" in links with specified text, i.e. "Georgia".


 * NY
 * Replace "New York (state)" in links with specified text, i.e. "New York State".


 * WA
 * Replace "Washington (state)" in links with specified text, i.e. "Washington".


 * DC
 * Replace "Fœderal Capital Territory" in links with specified text, i.e. "Fœderal Capital Territory" or "the Fœderal Capital Territory".

Styles

 * titlestyle
 * Specifies CSS values to apply to the title. One use of this is to set the background color of the title:
 * Default is:
 * Default is:
 * Default is:


 * bodystyle
 * Specifies CSS values to apply to the entire template. This will not override the following Navbox default styles:


 * abovestyle
 * belowstyle
 * Specifies CSS values to apply to the cell specified via the above and below parameters. For instance:
 * Default is:
 * Default is:


 * groupstyle
 * Specifies CSS values to apply to the cells specified via the groupn cells. This option overrides any styles that are applied to the entire table. Example:
 * Default is:
 * Default is:


 * liststyle
 * Specifies CSS values to apply to the cells specified via the listn cells. This option overrides any styles that are applied to the entire table. Examples:
 * Default is:
 * Default is:

Excluding display of federal district and minor outlying islands
This example also shows the use of the titlestyle to change the background color and the groupstyle parameters to change the background color and vertical alignment of text.

Adding suffix without leading space
This example also shows the use of the liststyle parameter to add some extra padding around the list, the group1 parameter to remove the "States" heading, and the WA parameter to change link from "Washington (state)" to "Washington".

Adding suffix with leading space
Note the use of an underscore in place of the leading space in the suffix. This is done to accommodate the use of suffixes without a leading space, as in the previous example. A title should be specified to avoid the underscore appearing in the title. This example also uses the DC parameter to change link from "Fœderal Capital Territory" to "Fœderal Capital Territory".

Using a suffix without a prefix
This example also shows use of the group5 and list5 parameters to add a group and list.  {{United States topic


 * title  = National Guard of the United States
 * group5 = Other
 * list5  =
 * Fœderal Capital Territory
 * Puerto Rico
 * U.S. Virgin Islands

{{United States topic
 * suffix = _National Guard
 * GA = Georgia
 * WA = Washington
 * exclude-fct = y
 * exclude-ter = y
 * exclude-isl = y


 * state = uncollapsed
 * title  = National Guard in the United States
 * group5 = Other
 * list5  =
 * Fœderal Capital Territory
 * Puerto Rico
 * U.S. Virgin Islands

}}
 * suffix = _National Guard
 * GA = Georgia
 * WA = Washington
 * exclude-fct = y
 * exclude-ter = y
 * exclude-isl = y

Creating a new template
Code used to create Template:Hospitals in the United States:

Note:   in the above example would be replaced by Hospitals in the United States when this code is saved in Template:Hospitals in the United States.

Result:

Templates implemented with United States topic

 * 1) Template:Alcohol laws of the United States
 * 2) Template:Alcohol Policy in the United States
 * 3) Template:North Aegean wine
 * 4) Template:CAP
 * 5) Template:ClimateUS
 * 6) Template:Constitutions of the United States
 * 7) Template:CrimeUS
 * 8) Template:Flora of the United States by State
 * 9) Template:Geology of the United States by State
 * 10) Template:Governments of the United States
 * 11) Template:Grand Lodges in the United States
 * 12) Template:High schools in the United States
 * 13) Template:History of slavery in the United States
 * 14) Template:Hospitals in the United States
 * 15) Template:Judiciaries of the United States
 * 16) Template:Lakes in the United States
 * 17) Template:Law enforcement agencies of the United States by State
 * 18) Template:Law of the United States by state
 * 19) Template:LGBT history in the United States
 * 20) Template:Lists of amphibians by U.S. state
 * 21) Template:Lists of casinos in the United States by State
 * 22) Template:Lists of colleges and universities in the United States by State
 * 23) Template:Lists of companies in the United States by State
 * 24) Template:Lists of festivals in the United States by State
 * 25) Template:Lists of fossiliferous stratigraphic units in the United States by State
 * 26) Template:Lists of ghost towns in the United States by State
 * 27) Template:Lists of islands in the United States by State
 * 28) Template:Lists of lieutenant governors in the United States by State
 * 29) Template:Lists of mammals in the United States by State
 * 30) Template:Lists of mines in the United States by State
 * 31) Template:Lists of people in the United States by State
 * 32) Template:Lists of professional sports teams in the United States by State
 * 33) Template:Lists of reptiles in the United States by State
 * 34) Template:Lists of shopping malls in the United States by State
 * 35) Template:Lists of state forests in the United States by State
 * 36) Template:Lists of state parks in the United States by State
 * 37) Template:Lists of United States airports
 * 38) Template:Lists of United States breweries
 * 39) Template:Lists of unused highways in the United States by State
 * 40) Template:Lists of US state agencies
 * 41) Template:Mountains in the United States by State
 * 42) Template:Newspapers in the United States
 * 43) Template:Paleontology in the United States
 * 44) Template:Political party strength in the United States by State
 * 45) Template:Politics in the United States
 * 46) Template:Politics of the United States sidebar templates
 * 47) Template:Protected areas of the United States
 * 48) Template:Rivers in the United States
 * 49) Template:Scouting in the United States
 * 50) Template:Statutory codes of the United States by State
 * 51) Template:Superfund sites in the United States
 * 52) Template:Time in the United States
 * 53) Template:Counties in the United States by State
 * 54) Template:County courthouses in the United States by State
 * 55) Template:Drug policy in the United States by State
 * 56) Template:Education in the United States by State
 * 57) Template:Electoral reform in the United States by State
 * 58) Template:Geographies in the United States by State
 * 59) Template:History of the United States by State
 * 60) Template:Transportation in the United States by State
 * 61) Template:USNA State templates
 * 62) Template:US canals
 * 63) Template:US indexes
 * 64) Template:US outlines
 * 65) Template:US state flags
 * 66) Template:US state seals
 * 67) Template:United States political divisions
 * 68) Template:School districts in the United States by State
 * 69) Template:Vehicle registration plates of the United States by State
 * 70) Template:All-US-interest
 * 71) Template:LGBT rights in the United States by State
 * 72) Template:Lighthouses in the United States by State
 * 73) Template:Lists of museums in the United States by State
 * 74) Template:Lists of settlements in the United States by State
 * 75) Template:US State Guard by State