View source for Template:USBill/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

==Description==
This links to a specific bill via [https://www.congress.gov/ Congress.gov].

Bills and Resolutions from the [[6th United States Congress|6th Congress]] through the [[42nd United States Congress|42nd Congress]] are available separately through the Library of Congress.

*[https://memory.loc.gov/ammem/amlaw/lwhblink.html House bills], 6th through 42nd Congress
*[https://memory.loc.gov/ammem/amlaw/lwsblink.html Senate bills], 16th through 42nd Congress
*[https://memory.loc.gov/ammem/amlaw/lwsrlink.html Senate Joint Resolutions], 18th through 42nd Congress

This template links to external sites. External links should not normally be used in the body of an article; see [[Wikipedia:External links]] for discussion of acceptable and unacceptable uses.

==Usage==

{{tlx|USBill|<var>congress number</var>|<var>bill type</var>|<var>bill number</var>}}

== Parameters ==
; {{para|1}}: '''Congress''' (93-present). (1-92 will provide the right output, but it won't be linked).
{| class=wikitable style="text-align:center"

|- style="vertical-align:bottom;"
! rowspan=2 | {{para|1|<var>congress number</var>}}
! colspan=2 | Result

|-
! Link
! Format

|-
| 93-{{USCongressOrd|present}} (present)
| Links to Congress.gov bill
| Formats properly

|-
| 1-92
| No link
| Formats properly

|}

; {{para|2|<var>bill type</var>}}
{| class=wikitable style="text-align:center"

|- style="vertical-align:bottom;"
! Spaces and periods are optional, but in the piped result, spaces will be ''dropped'' and periods will be ''added''
! Type
! Piped result

|-
| {{mono|h, hr}}
| House Bill{{Small|<br/><br/>''Note: H.R. is a House Bill, not a House Resolution.''}}
| H.R.

|-
| {{mono|hres}}
| House Resolution
| H.Res.

|-
| {{mono|hj, hjr, hjres}}
| House Joint Resolution
| H.J.Res.

|-
| {{mono|hconres, hcr}}
| House Concurrent Resolution
| H.Con.Res.

|-
| {{mono|ha, hamdt}}
| House Amendment
| H.Amdt.

|-
| {{mono|hrept}}
| House Report
| H.Rept.

|-
| {{mono|s}}
| Senate Bill
| S.

|-
| {{mono|sr, sres}}
| Senate Resolution
| S.Res.

|-
| {{mono|sj, sjr, sjres}}
| Senate Joint Resolution
| S.J.Res.

|-
| {{mono|sconres, scr, scon}}
| Senate Concurrent Resolution
| S.Con.Res.

|-
| {{mono|samt, sa, samdt}}
| Senate Amendment
| S.Amdt.

|-
| {{mono|srept}}
| Senate Report
| S.Rept.

|}
* {{para|3}}: '''Bill number''' (1-?)
* {{para|which}}: Optional field.  If any data is here (i.e., non-blank), then adds "(Cong.)" to differentiate to the reader the Congress in which the bill was considered.
* {{para|pipe}}: Optional field if you'd rather use '''piped text'''
* {{para|site}}: Optional field.  If any data is here (i.e., non-blank), it adds " at [[Congress.gov]]."  "Site" will not apply if there's no link, (i.e. {{para|1}}<93).  "Site" is useful when including bills in lists, such as External links.

==Examples==
'''Senate Joint Resolution 52 of the 101st Congress''':
:{{mono|<nowiki>{{USBill|101|SJ|52}}</nowiki>}} returns {{USBill|101|SJ|52}}

'''House bill 889 of the 109th Congress''':
:{{mono|<nowiki>{{USBill|109|HR|889}}</nowiki>}} returns {{USBill|109|HR|889}}
:{{mono|<nowiki>{{USBill|109|HR|889|which=109}}</nowiki>}} returns {{USBill|109|HR|889|which=109}}

'''House Resolution 4954 of the 109th Congress, known as the "SAFE Port Act"''':
:{{mono|<nowiki>{{USBill|109|HR|4954|pipe=Text of the SAFE Port Act|site=yes}}</nowiki>}} returns {{USBill|109|HR|4954|pipe=Text of the SAFE Port Act|site=yes}}

'''Examples of ''Senate'' legislation from the Library of Congress''':
:{{mono|<nowiki>{{USBill|110|S|254}}</nowiki>}} returns {{USBill|110|S|254}}
:{{mono|<nowiki>{{USBill|110|SJ|10}}</nowiki>}} returns {{USBill|110|SJ|10
|}}
:{{mono|<nowiki>{{USBill|110|SConRes|33}}</nowiki>}} returns {{USBill|110|SConRes|33}}
:{{mono|<nowiki>{{USBill|110|SRes|69}}</nowiki>}} returns {{USBill|110|SRes|69}}
:{{mono|<nowiki>{{USBill|110|SA|43}}</nowiki>}} returns {{USBill|110|SA|43}}

'''Examples of ''House of Representatives'' legislation from the Library of Congress''':
:{{mono|<nowiki>{{USBill|110|HR|622}}</nowiki>}} returns {{USBill|110|HR|622}}
:{{mono|<nowiki>{{USBill|110|HJ|65}}</nowiki>}} returns {{USBill|110|HJ|65}}
:{{mono|<nowiki>{{USBill|110|HConRes|27}}</nowiki>}} returns {{USBill|110|HConRes|27}}
:{{mono|<nowiki>{{USBill|110|HRes|655|site=yes}}</nowiki>}} returns {{USBill|110|HRes|655|site=yes}}
:{{mono|<nowiki>{{USBill|110|HA|234|site=yes}}</nowiki>}} returns {{USBill|110|HA|234|site=yes}}

'''Example of an unlinked bill''':
:{{mono|<nowiki>{{USBill|82|HRes|5678|site=yes}}</nowiki>}} returns {{USBill|82|HRes|5678|site=yes}}

==See also==
* {{tl|UK SI}}, an analogous template for "[[Statutory Instrument (UK)]]"
* [[s:Template:USBill]] — When changes are made, please change them at Wikisource, too.

==External link==
* [https://www.congress.gov/help/faq/linking-to-congress-gov Linking to Congress.gov]

{{United States legal citation templates}}
<includeonly>{{Sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Law citation templates|{{PAGENAME}}]]
[[Category:United States law templates|{{PAGENAME}}]]
[[Category:United States Congress external link templates|{{PAGENAME}}]]

[[ja:Template:USBill]]
}}</includeonly> 
<templatedata>
{
	"params": {
		"1": {
			"label": "Congress number",
			"description": "93–present",
			"example": "111",
			"type": "number",
			"required": true
		},
		"2": {
			"label": "Type",
			"description": "hr for House bill, hres for House Resolution, hjres for House Joint Resolution, hconres for House Concurrent Resolution, ha for House Amendment, s for Senate Bill, sres, sjres, sconres, sa",
			"example": "hr",
			"type": "string",
			"required": true
		},
		"3": {
			"label": "Bill number",
			"example": "383",
			"type": "number",
			"required": true
		},
		"which": {
			"description": "If any data is here (i.e., non-blank), then adds \"(Cong.)\" to differentiate to the reader the Congress in which the bill was considered",
			"example": "yes"
		},
		"pipe": {
			"description": "If any data is here (i.e., non-blank), then overwrites generated text and adds piped text to link",
			"example": "HR383",
			"type": "string"
		},
		"site": {
			"description": "If any data is here (i.e., non-blank), it adds \" at Congress.gov.\" \"Site\" will not apply if there's no link, (i.e. {{{1}}}<93). \"Site\" is useful when including bills in lists, such as External links"
		}
	},
	"description": "Links to a specific bill via Congress.gov",
	"format": "inline"
}
</templatedata>