View source for Template:United States Code/doc

{{Documentation subpage}}
{{High-use}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{Template shortcut|USC|usc}}

==Usage==
This template links to an external site, the Cornell University Law School U.S. Code database. External links should not normally be used in the body of an article; see [[Wikipedia:External links]] for discussion of acceptable and unacceptable uses.

This template uses Cornell's database. You may also use this to specify a range of sections.

{| class="wikitable"
! Usage
! Output
|-
| <code><nowiki>{{UnitedStatesCode|x|y}}</nowiki></code>
| rowspan="2" | {{UnitedStatesCode|x|y}}
|-
| <code><nowiki>{{USC|x|y}}</nowiki></code>
|-
| <code><nowiki>{{UnitedStatesCode|x|y|z}}</nowiki></code>
| rowspan="2" | {{UnitedStatesCode|x|y|z}}
|-
| <code><nowiki>{{USC|x|y|z}}</nowiki></code>
|-
| <code><nowiki>{{UnitedStatesCode|x|y|notitle=1}}</nowiki></code>
| rowspan="2" | {{UnitedStatesCode|x|y|notitle=1}}
|-
| <code><nowiki>{{USC|x|y|notitle=1}}</nowiki></code>
|-
| <code><nowiki>{{UnitedStatesCode|x|y|pipe=Link text}}</nowiki></code>
| rowspan="2" | {{UnitedStatesCode|x|y|pipe=Link text}}
|-
| <code><nowiki>{{USC|x|y|pipe=Link text}}</nowiki></code>
|}

Please note that all titles have Wikipedia articles and the template will link to the Wikipedia article. When citing a series of sections within a single title, one may eliminate redundancy by suppressing the display of the title altogether by adding the parameter {{para|notitle|1}} (see example below).

===Examples===
{| class="wikitable"
! Usage
! Output
|-
| <code><nowiki>{{USC|4|1}}.</nowiki></code>
| {{USC|4|1}}.
|-
| <code><nowiki>{{USC | 25 | 13f }}.</nowiki></code>
| {{USC | 25 | 13f }}.
|-
| <code><nowiki>{{USC|10|371|375}}, {{USC | 10 | 378 | notitle= 1 }}, and {{USC | 10 | 380 | 382 | notitle= 1 }}.</nowiki></code>
| {{USC|10|371|375}}, {{USC | 10 | 378 | notitle= 1 }}, and {{USC | 10 | 380 | 382 | notitle= 1 }}.
|-
| <code><nowiki>{{USC | 26 | 501 | pipe= Exemption from tax on corporations }}.</nowiki></code>
| {{USC | 26 | 501 | pipe= Exemption from tax on corporations }}.
|}

{{United States legal citation templates}}

==TemplateData==
<TemplateData>
{
  "description": "This template links to the Cornell University Law School U.S. Code database and allows for linking to specific titles and sections of the United States Code.",
  "params": {
    "1": {
      "label": "Title",
      "description": "The title number of the U.S. Code.",
      "type": "number",
      "required": true,
      "example": "26"
    },
    "2": {
      "label": "Section",
      "description": "The section number of the U.S. Code.",
      "type": "number",
      "required": true,
      "example": "501"
    },
    "3": {
      "label": "End section",
      "description": "The ending section number for a range of sections in the U.S. Code (optional).",
      "type": "number",
      "required": false,
      "example": "505"
    },
    "pipe": {
      "label": "Link text",
      "description": "Custom text for the hyperlink. If not specified, the default format is used.",
      "type": "string",
      "required": false,
      "example": "Exemption from tax on corporations"
    },
    "notitle": {
      "label": "Suppress title?",
      "description": "Useful for citing multiple sections within a single title.",
      "type": "boolean",
      "required": false,
      "example": "1"
    }
  }
}
</TemplateData>

<includeonly>{{basepage subpage|
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:Law citation templates|US Code]]
[[Category:United States Code templates]]
}}</includeonly>