![]() | This is a documentation subpage for Template:Cite IETF. It may contain usage information, categories and other content that is not part of the original template page. |
This is a template to cite IETF documents[1][2] including:
- Request for Comments (RFC)[3]
- For Your Information (FYI)[4][5]
- Internet Draft (I-D)
- Internet Standard (STD)[6][7]
- Best current practice (BCP)[8]
- Internet Experiment Note (IEN)
- RARE Technical Reports (RTR)[9]
Usage
This template supports most of the parameters available to {{Citation}}
. For information about those parameters see that template's documentation.
Note: All parameter names must be in lowercase.
Cite IETF specific parameters
|appendix=
– Appendix number of the document.|appendix=A.1
produces "sec. A.1" Also used to create an anchor link for the document's URL.|autolink=
–|autolink=yes
or|autolink=no
Automatically generate a link to ietf.org for documents specified with|rfc=
,|std=
,|bcp=
,|fyi=
,|draft=
,|ien=
, or|rtr=
. (enabled by default)|bcp=
– Number of the Best Current Practice (BCP) document. Also used to automatically generate a link to ietf.org.|draft=
– Name of the Internet Draft (I-D) document, including the leading draft-. Also used to automatically generate a link to ietf.org.|fyi=
– Number of the For Your Information (FYI) document. Also used to automatically generate a link to ietf.org.|idanchor=
– Anchor link target. By default, no anchor link is generated. The special value|idanchor=ietf
generates an anchor link suitable for use with this template's|ref=
parameter. Requires one of|id=
,|rfc=
,|std=
,|bcp=
,|fyi=
,|draft=
,|ien=
or|rtr=
fields to be present for the anchor link text.|idlink=
– Internal document anchor or title of a OODA WIKI article to link via the document identifier. Article should already exist. Must not be wikilinked itself. Do not use this on its own, but along with|id=
,|rfc=
,|std=
,|bcp=
,|fyi=
,|draft=
,|ien=
or|rtr=
.|idlinktype=
– One of the values:|id=
,|rfc=
,|std=
,|bcp=
,|fyi=
,|draft=
,|ien=
or|rtr=
can be given to|idlinktype=
to force the template to use the specified document identifier as the link text for|idanchor=
or|idlink=
. Do not use this on its own, but along with|idanchor=
or|idlink=
and|id=
,|rfc=
,|std=
,|bcp=
,|fyi=
,|draft=
,|ien=
or|rtr=
.|ien=
– Number of the Internet Experiment Note (IEN) document. Also used to automatically generate a link to ietf.org.|nosec=
– Using|section=
,|sections=
, or|appendix=
automatically places the sec. notation. Se|nosec=y
to hide the sec. notation.|referenceid=
– Reference id for the document. Used to create an anchor link for the document's URL.|rfc=
– Number of the Request for Comments (RFC) document. Also used to automatically generate a link to ietf.org.|rtr=
– Number of the RARE Technical Reports (RTR) document. Also used to automatically generate a link to ietf.org.|section=
– Section number of the document.|section=4.3.1
produces "sec. 4.3.1" Also used to create an anchor link for the document's URL. Can also be used in combination with|sections=
to link to the first section in the given section range.|sections=
– Section range of the document.|sections=4.3-4.7
produces "sec. 4.3-4.7"|sectionname=
– The section name or section title of the document, written in full; displays before|title=
and enclosed in quotes.|std=
– Number of the Internet Standard (STD) document. Also used to automatically generate a link to ietf.org.
As with all cs1|2 templates, |title=
is required. If omitted, the template will attempt to auto-generate a title using the first of |rfc=
, |std=
, |bcp=
, |fyi=
, |draft=
, |ien=
, |rtr=
or |id=
document identifier parameters, in that order.
Copy a blank version to use. Remember to use the "|" (pipe) character between each parameter. Please delete any unused parameters to avoid clutter in the edit window.
Full version (copy and paste text below and delete parameters you don't need) | ||
---|---|---|
| ||
Most commonly used parameters (use this and you won't have to delete as much) | ||
| ||
Example 1 |
{{Cite IETF |title=The Tao of IETF: A novice's guide to the Internet Engineering Task Force |rfc=4677 |fyi=17 |last1=Hoffman |first1=P. |authorlink1=Paul Hoffman (engineer) |last2=Harris |first2=S. |date=September 2006 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=October 20, 2009 |doi=10.17487/RFC4677}} |
Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value). |
Example 2 | {{Cite IETF |title=Telnet protocol specification |rfc=854 |std=8 |sectionname=Are you there (AYT) |page=8 |last1=Postel |first1=J. |author-link1=Jon Postel |last2=Reynolds |first2=J. |author-link2=Joyce K. Reynolds |date=May 1983 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=October 20, 2009 |doi=10.17487/RFC0854 }} |
Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value). |
Examples
- {{Cite IETF |title=JSON |rfc=7159 |sectionname=IANA considerations |section=11 |author=T. Bray |authorlink=Tim Bray |date=March 2014 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=November 26, 2017 |doi=10.17487/RFC7159 }}
→ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- {{Cite IETF |title=Hypertext transfer protocol -- HTTP/1.1 |rfc=2616 |first1=R. |last1=Fielding |authorlink1=Roy Fielding |first2=J. |last2=Gettys |authorlink2=Jim Gettys |first3=J. |last3=Mogul |first4=H. |last4=Frystyk |authorlink4=Henrik Frystyk Nielsen |first5=L. |last5=Masinter |first6=P. |last6=Leach |first7=T. |last7=Berners-Lee |authorlink7=Tim Berners-Lee |date=June 1999 |publisher=[[Internet Engineering Task Force|IETF]] |doi=10.17487/RFC2616 }}
→ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- {{Cite IETF |title=Domain names - concepts and facilities |rfc=1034 |sectionname=Name space specifications and terminology |section=3.1 |author=P. Mockapetris |authorlink=Paul Mockapetris |date=November 1987 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=August 3, 2008
|doi=10.17487/RFC1034 |quote=A domain is a subdomain of another domain if it is contained within that domain. This relationship can be tested by seeing if the subdomain's name ends with the containing domain's name. For example, A.B.C.D is a subdomain of B.C.D, C.D, D, and ' '. }}
→ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
Technical notes
Regression testing
Regression tests are available here:
Subtemplates
{{Cite IETF}} uses the following subtemplates:
- {{Cite IETF/doctypes}}
- {{Cite IETF/makelink}}
- {{Cite IETF/refanchor}}
URL generation
Request for Comments (RFC), For Your Information (FYI), and Internet Draft (I-D) documents are stored by https://datatracker.ietf.org/doc/html/
and are linked in the following way:
https://datatracker.ietf.org/doc/html/rfc<document number>
https://datatracker.ietf.org/doc/fyi<document number>
https://datatracker.ietf.org/doc/html/draft-<draft name>
Internet Standard (STD), Best Current Practice (BCP), Internet Experiment Note (IEN), and RARE Technical Reports (RTR) documents are stored by https://rfc-editor.org
and are linked in the following way:
https://www.rfc-editor.org/info/std<document number>
https://www.rfc-editor.org/info/bcp<document number>
https://rfc-editor.org/in-notes/ien/ien<document number>.txt
https://rfc-editor.org/in-notes/museum/RAREreports/rtr<document number>.txt
URL anchor generation
Anchors are generated for the URL using four parameters:
|section=number
generates#section-<number>
|appendix=number
generates#appendix-<number>
|referenceid=id
generates#ref-<id>
|page=number
generates#page-<number>
The template will give priority to the first of the parameters: |section=
, |appendix=
, |referenceid=
, or |page=
in this order and create an anchor using the first matching parameter.
See also
- {{Ref RFC}} – pre-populated citations
References
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- ↑ Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
Further reading
- Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
- Lua error in Module:Citation/CS1/Configuration at line 2088: attempt to index field '?' (a nil value).
This template produces COinS metadata; see COinS in OODA WIKI for background information.