Difference between revisions of "Template:Cite IETF/doc"

From blackwiki
Jump to navigation Jump to search
imported>Gadget850
(update obsolete HTML)
imported>Debresser
m (Add dash to "access-date".)
 
(25 intermediate revisions by 10 users not shown)
Line 11: Line 11:
 
| last2      = Harris
 
| last2      = Harris
 
| first2      = Susan
 
| first2      = Susan
| year       = 2006
+
| date       = September 2006
| month      = September
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC4677
 
}}</ref><ref>{{cite IETF
 
}}</ref><ref>{{cite IETF
 
| title      = A Primer On Internet and TCP/IP Tools
 
| title      = A Primer On Internet and TCP/IP Tools
Line 24: Line 24:
 
| last2      = Shepard
 
| last2      = Shepard
 
| first2      = Steven D.
 
| first2      = Steven D.
| year       = 1994
+
| date       = December 1994
| month      = December
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC1739
 
| ref        = ietf
 
| ref        = ietf
 
}}</ref> including:
 
}}</ref> including:
 
*[[Request for Comments]] (RFC)<ref>{{cite IETF
 
*[[Request for Comments]] (RFC)<ref>{{cite IETF
 
| rfc        = 1739
 
| rfc        = 1739
 +
|title=A Primer On Internet and TCP/IP Tools
 
| sectionname = Request for Comments (RFCs)
 
| sectionname = Request for Comments (RFCs)
 
| section    = 4.1
 
| section    = 4.1
| pages      = 36&nbsp;– 38
+
| pages      = 36–38
 
| idanchor    = ietf
 
| idanchor    = ietf
 
}}</ref>
 
}}</ref>
Line 44: Line 45:
 
| first      = Scott O.
 
| first      = Scott O.
 
| authorlink  = Scott Bradner
 
| authorlink  = Scott Bradner
| year       = 1996
+
| date       = October 1996
| month      = October
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC2026
 
}}</ref><ref>{{cite IETF
 
}}</ref><ref>{{cite IETF
 
| rfc        = 1739
 
| rfc        = 1739
 +
|title=A Primer On Internet and TCP/IP Tools
 
| sectionname = Internet Standards
 
| sectionname = Internet Standards
 
| section    = 4.2
 
| section    = 4.2
| pages      = 38&nbsp;– 39
+
| pages      = 38–39
 
| idanchor    = ietf
 
| idanchor    = ietf
 
}}</ref>
 
}}</ref>
Line 67: Line 69:
 
| last3      = Li
 
| last3      = Li
 
| first3      = Tony
 
| first3      = Tony
| year       = 1995
+
| date       = August 1995
| month      = August
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC1818
 
}}</ref>
 
}}</ref>
 
*[[For Your Information]] (FYI)<ref>{{cite IETF
 
*[[For Your Information]] (FYI)<ref>{{cite IETF
Line 81: Line 83:
 
| first2      = Joyce K.
 
| first2      = Joyce K.
 
| authorlink2 = Joyce K. Reynolds
 
| authorlink2 = Joyce K. Reynolds
| year       = 1990
+
| date       = March 1990
| month      = March
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC1150
 
}}</ref><ref>{{cite IETF
 
}}</ref><ref>{{cite IETF
 
| rfc        = 1739
 
| rfc        = 1739
 +
|title=A Primer On Internet and TCP/IP Tools
 
| sectionname = For Your Information Documents
 
| sectionname = For Your Information Documents
 
| section    = 4.3
 
| section    = 4.3
Line 96: Line 99:
 
*[[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR)<ref>{{cite IETF
 
*[[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR)<ref>{{cite IETF
 
| rfc        = 1739
 
| rfc        = 1739
 +
|title=A Primer On Internet and TCP/IP Tools
 
| sectionname = RARE Technical Reports
 
| sectionname = RARE Technical Reports
 
| section    = 4.4
 
| section    = 4.4
Line 105: Line 109:
  
 
== Usage ==
 
== Usage ==
 +
This template supports most of the parameters available to {{tlx|citation}}.  For information about those parameters see that template's documentation.
  
 
'''''Note''''': All parameter names '''must''' be in [[lowercase]].
 
'''''Note''''': All parameter names '''must''' be in [[lowercase]].
 +
 +
===cite IETF specific parameters===
 +
*{{para|appendix}} – Appendix number of the document. {{para|appendix|A.1}} produces "sec. A.1" Also used to create an anchor link for the document's URL.
 +
*{{para|autolink}} – {{para|autolink|<var>yes</var>}} or {{para|autolink|<var>no</var>}} Automatically generate a link to ietf.org for documents specified with {{para|rfc}}, {{para|std}}, {{para|bcp}}, {{para|fyi}}, {{para|draft}}, {{para|ien}}, or {{para|rtr}}. (enabled by default)
 +
*{{para|bcp}} – Number of the [[Best Current Practice]] (BCP) document. Also used to automatically generate a link to ietf.org.
 +
*{{para|draft}} – Name of the [[Internet Draft]] (I-D) document, including the leading draft-. Also used to automatically generate a link to ietf.org.
 +
*{{para|fyi}} – Number of the [[For Your Information]] (FYI) document. Also used to automatically generate a link to ietf.org.
 +
*{{para|idanchor}} – Anchor link target. By default, no anchor link is generated. The special value {{para|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.
 +
*{{para|idlink}} – Internal document anchor or title of a Wikipedia 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'''.
 +
*{{para|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'''.
 +
*{{para|ien}} – Number of the [[Internet Experiment Note]] (IEN) document. Also used to automatically generate a link to ietf.org.
 +
*{{para|nosec}} – Using '''section''', ''''sections''', or '''appendix''' automatically places the sec. notation. Se {{para|nosec|y}} to hide the sec. notation.
 +
*{{para|referenceid}} – Reference id for the document. Used to create an anchor link for the document's URL.
 +
*{{para|rfc}} – Number of the [[Request for Comments]] (RFC) document. Also used to automatically generate a link to ietf.org.
 +
*{{para|rtr}} – Number of the [[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR) document. Also used to automatically generate a link to ietf.org.
 +
*{{para|section}} – Section number of the document. {{para|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.
 +
*{{para|sections}} – Section range of the document. {{para|sections|4.3-4.7}} produces "sec. 4.3-4.7"
 +
*{{para|sectionname}} – The section name or section title of the document, written in full; displays before '''title''' and enclosed in quotes.
 +
*{{para|std}} – Number of the [[Internet Standard]] (STD) document. Also used to automatically generate a link to ietf.org.
 +
 +
As with all cs1|2 templates, {{para|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.
 
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.
Line 114: Line 140:
 
|- width="50%" style="vertical-align:top;"
 
|- width="50%" style="vertical-align:top;"
 
| colspan="3" |
 
| colspan="3" |
:<code><nowiki>{{cite IETF |title= |rfc= |std= |bcp= |fyi= |draft= |ien= |rtr= |sectionname= |section= |sections= |appendix= |referenceid= |page= |pages= |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |authormask= |coauthors= |editor1-last= |editor1-first= |editor1-link= |others= |date= |year= |month= |origyear= |publisher=[[Internet Engineering Task Force|IETF]] |location= |language= |format= |accessdate= |url= |section-url= |page-url= |autolink= |id= |idanchor= |idlink= |idlinktype= |doi= |doi_brokendate= |issn= |archiveurl= |archivedate= |quote= |nopp= |nosec= |ref= |laysummary= |laydate= |separator= |postscript= |lastauthoramp= }}</nowiki></code>
+
:<code><nowiki>{{cite IETF |title= |rfc= |std= |bcp= |fyi= |draft= |ien= |rtr= |sectionname= |section= |sections= |appendix= |referenceid= |page= |pages= |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |authormask= |editor1-last= |editor1-first= |editor1-link= |others= |date= |year= |orig-year= |publisher=[[Internet Engineering Task Force|IETF]] |location= |language= |format= |access-date= |url= |section-url= |page-url= |autolink= |id= |idanchor= |idlink= |idlinktype= |doi= |doi-broken-date= |issn= |archive-url= |archive-date= |quote= |nopp= |nosec= |ref= |lay-summary= |lay-date= |postscript= |last-author-amp=}}</nowiki></code>
 
|- width="50%" style="vertical-align:top;"
 
|- width="50%" style="vertical-align:top;"
 
! colspan="3" | Most commonly used parameters (use this and you won't have to delete as much)
 
! colspan="3" | Most commonly used parameters (use this and you won't have to delete as much)
 
|- width="50%" style="vertical-align:top;"
 
|- width="50%" style="vertical-align:top;"
 
| colspan="3" |
 
| colspan="3" |
:<code><nowiki>{{cite IETF |title= |rfc= |sectionname= |section= |page= |last= |first= |authorlink= |coauthors= |year= |month= |publisher=[[Internet Engineering Task Force|IETF]] |accessdate= }}</nowiki></code>
+
:<code><nowiki>{{cite IETF |title= |rfc= |sectionname= |section= |page= |last= |first= |author-link= |date= |publisher=[[Internet Engineering Task Force|IETF]] |access-date= |doi=}}</nowiki></code>
 
|- width="50%" style="vertical-align:top;"
 
|- width="50%" style="vertical-align:top;"
 
! Example 1
 
! Example 1
 
| style="vertical-align: top;" |
 
| style="vertical-align: top;" |
<code><nowiki>{{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 (VPNC) |last2= Harris |first2= S. |year= 2006 |month= September |publisher=[[Internet Engineering Task Force|IETF]] |accessdate=October 20, 2009}}</nowiki></code>
+
<code><nowiki>{{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 (VPNC) |last2=Harris |first2=S. |date=September 2006 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=October 20, 2009 |doi=10.17487/RFC4677}}</nowiki></code>
 
| style="vertical-align: top;" |
 
| style="vertical-align: top;" |
{{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 (VPNC) |last2= Harris |first2= S. |year= 2006 |month= September |publisher=[[Internet Engineering Task Force|IETF]] |accessdate=October 20, 2009}}
+
{{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. |author-link1=Paul Hoffman (VPNC) |last2=Harris |first2=S. |date=September 2006 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=October 20, 2009 |doi=10.17487/RFC4677}}
 
|- width="50%" style="vertical-align:top;"
 
|- width="50%" style="vertical-align:top;"
 
! Example 2
 
! Example 2
Line 136: Line 162:
 
| last1 = Postel
 
| last1 = Postel
 
| first1 = J.
 
| first1 = J.
| authorlink1 = Jon Postel
+
| author-link1 = Jon Postel
 
| last2 = Reynolds
 
| last2 = Reynolds
 
| first2 = J.
 
| first2 = J.
| authorlink2 = Joyce K. Reynolds
+
| author-link2 = Joyce K. Reynolds
| year = 1983
+
| date = May 1983
| month = May
 
 
| publisher = [[Internet Engineering Task Force|IETF]]
 
| publisher = [[Internet Engineering Task Force|IETF]]
| accessdate =October 20, 2009
+
| access-date = October 20, 2009
 +
| doi = 10.17487/RFC0854
 
}}</pre>
 
}}</pre>
 
| style="vertical-align: top;" |
 
| style="vertical-align: top;" |
Line 154: Line 180:
 
| last1 = Postel
 
| last1 = Postel
 
| first1 = J.
 
| first1 = J.
| authorlink1 = Jon Postel
+
| author-link1 = Jon Postel
 
| last2 = Reynolds
 
| last2 = Reynolds
 
| first2 = J.
 
| first2 = J.
| authorlink2 = Joyce K. Reynolds
+
| author-link2 = Joyce K. Reynolds
| year = 1983
+
| date = May 1983
| month = May
 
 
| publisher = [[Internet Engineering Task Force|IETF]]
 
| publisher = [[Internet Engineering Task Force|IETF]]
| accessdate =October 20, 2009
+
| access-date = October 20, 2009
 +
| doi = 10.17487/RFC0854
 
}}
 
}}
|}
 
 
{| class="wikitable"
 
|- width="50%" style="vertical-align:top;"
 
! Vertical list !! Prerequisites !! Brief instructions
 
|- width="50%" style="vertical-align:top;"
 
| style="vertical-align:top;padding:1ex;" |<pre>
 
{{cite IETF
 
| title      =
 
| rfc        =
 
| std        =
 
| bcp        =
 
| fyi        =
 
| draft      =
 
| ien        =
 
| rtr        =
 
| sectionname =
 
| section    =
 
| sections    =
 
| appendix    =
 
| referenceid =
 
| page        =
 
| pages      =
 
| last        =
 
| first      =
 
| authorlink  =
 
| authormask  =
 
| coauthors  =
 
| lastN      =
 
| firstN      =
 
| authorN-link =
 
| editor      =
 
| editorN    =
 
| editorN-last =
 
| editorN-first =
 
| editor-link =
 
| editorN-link =
 
| others      =
 
| date        =
 
| year        =
 
| month      =
 
| origyear    =
 
| publisher  =
 
| location    =
 
| language    =
 
| format      =
 
| accessdate  =
 
| url        =
 
| section-url =
 
| page-url    =
 
| autolink    =
 
| id          =
 
| idanchor    =
 
| idlink      =
 
| idlinktype  =
 
| doi        =
 
| doi_brokendate =
 
| issn        =
 
| archiveurl  =
 
| archivedate =
 
| quote      =
 
| nopp        =
 
| nosec      =
 
| ref        =
 
| laysummary  =
 
| laydate    =
 
| separator  =
 
| postscript  =
 
| lastauthoramp =
 
}}</pre>
 
| style="vertical-align:top;padding:1ex;" |<pre>
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
last
 
last
 
&nbsp;
 
last
 
&nbsp;
 
lastN
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
editorN-last
 
editor or editor-last
 
editorN or editorN-last
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
year
 
year or date
 
&nbsp;
 
publisher
 
&nbsp;
 
&nbsp;
 
rfc, std, bcp, fyi, draft, ien, rtr, or url
 
&nbsp;
 
sectionname
 
sectionname
 
rfc, std, bcp, fyi, draft, ien, rtr, or url
 
&nbsp;
 
id, rfc, std, bcp, fyi, draft, ien, or rtr
 
id, rfc, std, bcp, fyi, draft, ien, or rtr
 
idanchor or idlink
 
&nbsp;
 
doi
 
&nbsp;
 
url, rfc, std, bcp, fyi, draft, ien, or rtr
 
archiveurl
 
&nbsp;
 
page or pages
 
section, sections, or appendix
 
&nbsp;
 
&nbsp;
 
laysummary
 
&nbsp;
 
&nbsp;
 
coauthors or >1 lastN
 
&nbsp;</pre>
 
| style="vertical-align:top;padding:1ex;" |<pre>
 
&nbsp;
 
(no wikilink) RFC number; 4677
 
(no wikilink) STD number
 
(no wikilink) BCP number
 
(no wikilink) FYI number; 17
 
(no wikilink) I-D (internet draft) name
 
(no wikilink) IEN number
 
(no wikilink) RTR number
 
&nbsp;
 
(no wikilink) section number; 3.3
 
(no wikilink) section range (can be used together with the section parameter)
 
(no wikilink) appendix number; A.1
 
(no wikilink) reference id
 
(no wikilink) page number
 
(no wikilink) page range (can be used together with the page parameter)
 
&nbsp;
 
(no wikilink)
 
(no wikilink)
 
&nbsp;
 
&nbsp;
 
alternative to first2, last2...first9, last9
 
(no wikilink) N=1 through 9
 
N=1 through 9
 
N=1 through 9
 
&nbsp;
 
N=1 through 4
 
N=1 through 4
 
N=1 through 4
 
&nbsp;
 
N=1 through 4
 
&nbsp;
 
preferred (no wikilink) This is the preferred parameter with its alternates listed below.
 
alternative to date
 
&nbsp;
 
&nbsp;
 
should be <nowiki>[[Internet Engineering Task Force|IETF]]</nowiki> for IETF documents.
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
hides automatic 'p.' or 'pp.'
 
hides automatic 'sec.'
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;
 
&nbsp;</pre>
 
 
|}
 
|}
  
Line 366: Line 194:
 
*<nowiki>{{cite IETF
 
*<nowiki>{{cite IETF
 
| title      = JSON
 
| title      = JSON
| rfc        = 4267
+
| rfc        = 7159
 
| sectionname = IANA Considerations
 
| sectionname = IANA Considerations
| section    = 6
+
| section    = 11
| author      = Douglas Crockford
+
| author      = T. Bray
| authorlink  = Douglas Crockford
+
| authorlink  = Tim Bray
| date        = July 2006
+
| date        = March 2014
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =July 3, 2009
+
| access-date = November 26, 2017
 +
| doi        = 10.17487/RFC7159
 
}}</nowiki><br/>→ <span style="background:white">{{cite IETF
 
}}</nowiki><br/>→ <span style="background:white">{{cite IETF
 
| title      = JSON
 
| title      = JSON
| rfc        = 4267
+
| rfc        = 7159
 
| sectionname = IANA Considerations
 
| sectionname = IANA Considerations
| section    = 6
+
| section    = 11
| author      = Douglas Crockford
+
| author      = T. Bray
| authorlink  = Douglas Crockford
+
| authorlink  = Tim Bray
| date        = July 2006
+
| date        = March 2014
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =July 3, 2009
+
| access-date = November 26, 2017
 +
| doi        = 10.17487/RFC7159
 
}}</span>
 
}}</span>
  
Line 407: Line 237:
 
| last7      = Berners-Lee
 
| last7      = Berners-Lee
 
| authorlink7 = Tim Berners-Lee
 
| authorlink7 = Tim Berners-Lee
| year        = 1999
+
|date=June 1999
| month      = June
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 +
| doi        = 10.17487/RFC2616
 
}}</nowiki><br/>→ <span style="background:white">{{cite IETF
 
}}</nowiki><br/>→ <span style="background:white">{{cite IETF
 
| title      = Hypertext Transfer Protocol -- HTTP/1.1
 
| title      = Hypertext Transfer Protocol -- HTTP/1.1
Line 431: Line 261:
 
| last7      = Berners-Lee
 
| last7      = Berners-Lee
 
| authorlink7 = Tim Berners-Lee
 
| authorlink7 = Tim Berners-Lee
| year        = 1999
+
|date=June 1999
| month      = June
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 +
| doi        = 10.17487/RFC2616
 
}}</span>
 
}}</span>
  
Line 443: Line 273:
 
| author      = P. Mockapetris
 
| author      = P. Mockapetris
 
| authorlink  = Paul Mockapetris
 
| authorlink  = Paul Mockapetris
| year        = 1987
+
|date=November 1987
| month      = November
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate =August 3, 2008
+
| 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 ' '.
 
| 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 ' '.
 
}}</nowiki><br/>→ <span style="background:white">{{cite IETF
 
}}</nowiki><br/>→ <span style="background:white">{{cite IETF
Line 455: Line 285:
 
| author      = P. Mockapetris
 
| author      = P. Mockapetris
 
| authorlink  = Paul Mockapetris
 
| authorlink  = Paul Mockapetris
| year        = 1987
+
|date=November 1987
| month      = November
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =August 3, 2008
+
| 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 ' '.
 
| 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 ' '.
 
}}</span>
 
}}</span>
  
==Parameters==
+
==Technical notes==
===Syntax===
 
{{csdoc|syntax}}
 
 
 
{{csdoc|coins}}
 
 
 
{{csdoc|sep_period}}
 
 
 
===Description===
 
====Authors====
 
{{csdoc|author|others=yes}}
 
 
 
====Title====
 
* '''title''': Title of the document; displays in italics. If {{em|both}} '''title''' and '''sectionname''' are omitted, then the template will attempt to auto-generate a title using the first of the '''rfc''', '''std''', '''bcp''', '''fyi''', '''draft''', '''ien''', '''rtr''' or '''id''' document identifier parameters, in that order.
 
:Titles containing certain characters will display and link incorrectly unless those characters are encoded.
 
{| class="wikitable" style="margin-left: 5em"
 
! newline !! [ !! ] !! &#124;
 
|-
 
| space || &amp;#91; || &amp;#93; || &amp;#124;
 
|}
 
* '''sectionname''': The section name or section title of the document, written in full; displays before '''title''' and enclosed in quotes.
 
{{csdoc|language}}
 
 
 
====Date====
 
{{csdoc|date}}
 
 
 
====Publisher====
 
* '''publisher''': Name of publisher; may be wikilinked if relevant. Not normally included for periodicals. Corporate designations such as "Ltd", "Inc" or "GmbH" are not usually included. Displays after '''title'''.
 
:Should normally be set to [[Internet Engineering Task Force|IETF]] for RFC, STD, BCP, FYI, I-D (internet draft), IEN, and RTR documents.
 
:Note: There are reasons this can't just be the default; see [[Template talk:Cite IETF#Make publisher always IETF?]]
 
* '''location''': Geographical place of publication; generally not wikilinked; omit when the name of the work includes the location (examples: ''The Boston Globe'', ''The Times of India''). Displays preceding '''publisher'''.
 
<!--* '''publication-date''': Date of publication when different from the date the work was written. Displays only if '''year''' or '''date''' are defined and only if different, else '''publication-date''' is used and displayed as '''date'''. Use the same format as other dates in the article; do not wikilink. Follows '''publisher'''; preceded by "published" and enclosed in parenthesis.-->
 
 
 
====In-source locations====
 
* '''page''': Page in the source that supports the content. Displays preceded with {{code|p.}} unless {{para|nopp|y}}. Also used to create an anchor link for the document's URL. If either '''section''' or '''appendix''' is also given, the anchor will link to the section or appendix instead of the page. Can also be used in combination with '''pages''' to link to the first page in the given page range if '''section''' and '''appendix''' are not specified.
 
* OR: '''pages''': Pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source. Displays preceded with {{code|pp.}} unless {{para|nopp|y}}.
 
** '''nopp''': Set to <var>y</var> to suppress the {{code|p.}} or {{code|pp.}} notations where this is inappropriate; for example, where {{para|page|Front cover}}.
 
* '''section''': Section number of the document. {{para|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. {{para|sections|4.3-4.7}} produces "sec. 4.3-4.7"
 
* OR: '''appendix''': Appendix number of the document. {{para|appendix|A.1}} produces "sec. A.1" Also used to create an anchor link for the document's URL.
 
* OR: '''referenceid''': Reference id for the document. Used to create an anchor link for the document's URL.
 
* '''nosec''': Using '''section''', ''''sections''', or '''appendix''' automatically places the sec. notation. Se {{para|nosec|y}} to hide the sec. notation.
 
 
 
====URL====
 
{{csdoc|url}}
 
* '''section-url''': URL to an individual section of the document (including an anchor if required). Overrides an automatically generated URL and should not be specified unless absolutely necessary. Should be at the same site as {{para|url}}, if any.
 
* '''page-url''': URL to an individual page of the document (including an anchor if required). Overrides an automatically generated URL and should not be specified unless absolutely necessary. Should be at the same site as {{para|url}}, if any.
 
* '''autolink''': {{para|autolink|<var>yes</var>}} or {{para|autolink|<var>no</var>}} Automatically generate a link to ietf.org for documents specified with {{para|rfc}}, {{para|std}}, {{para|bcp}}, {{para|fyi}}, {{para|draft}}, {{para|ien}}, or {{para|rtr}}. (enabled by default)
 
 
 
====Anchor====
 
{{csdoc|ref}} The special value {{para|ref|ietf}} generates an anchor suitable for use with this template's '''idanchor''' parameter.
 
 
 
====Identifiers====
 
* '''rfc''': Number of the [[Request for Comments]] (RFC) document. Also used to automatically generate a link to ietf.org.
 
* '''std''': Number of the [[Internet Standard]] (STD) document. Also used to automatically generate a link to ietf.org.
 
* '''bcp''': Number of the [[Best Current Practice]] (BCP) document. 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.
 
* '''draft''': Name of the [[Internet Draft]] (I-D) document, including the leading draft-. Also used to automatically generate a link to ietf.org.
 
* '''ien''': Number of the [[Internet Experiment Note]] (IEN) document. Also used to automatically generate a link to ietf.org.
 
* '''rtr''': Number of the [[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR) document. Also used to automatically generate a link to ietf.org.
 
* '''id''': A [[unique identifier]] for the document, used if none of the above are applicable. Overrides automatically generated document identifiers—'''rfc''', '''std''', '''bcp''', '''fyi''', '''draft''', '''ien''' or '''rtr'''—and should not be specified unless absolutely necessary. If used, you also need to specify the kind of identifier you are using. Don't wikilink, use '''idlink''' instead.
 
* '''idanchor''': Anchor link target. By default, no anchor link is generated. The special value {{para|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.
 
* OR: '''idlink''': Internal document anchor or title of a Wikipedia 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'''.
 
* '''doi''': A [[digital object identifier]] for the document, such as ''10.1038/news070508-7''. The field must not be wikilinked as the template automatically creates a link.
 
** '''doi_brokendate''': The date that the DOI was determined to be broken
 
* '''issn''': [[International Standard Serial Number]] for the document; 8 characters; may be split into two groups of four using a hyphen. The field must not be wikilinked as the template automatically creates a link.
 
 
 
====Quote====
 
{{csdoc|quote}}
 
 
 
====Editors====
 
{{csdoc|editor}}
 
 
 
====Laysummary====
 
{{csdoc|lay}}
 
 
 
====Display options====
 
{{csdoc|display}}
 
 
 
==Citation styles==
 
Established citation styles for coauthors:
 
 
 
*[http://www.english.uiuc.edu/cws/wworkshop/writer_resources/citation_styles/mla/mla.htm MLA style]: Last, First and First Last. "If there are more than three authors, you may list only the first author followed by the phrase ''et al''."
 
*[http://www.english.uiuc.edu/cws/wworkshop/writer_resources/citation_styles/apa/apa.htm APA style]: Last, F. & Last, F.
 
*[http://www.liunet.edu/cwis/cwp/library/workshop/citchi.htm Chicago Manual of Style]: Last, First, and First Last.
 
*[http://www.liunet.edu/cwis/cwp/library/workshop/cittur.htm Turabian]: same as Chicago Reference List, above.
 
*[http://www.library.uq.edu.au/training/citation/harvard.html Harvard]: Last, F., Last, F. & Last, F.
 
  
==Technical notes==
 
 
===Regression testing===
 
===Regression testing===
 
[[Regression testing|Regression tests]] are available here:
 
[[Regression testing|Regression tests]] are available here:
Line 564: Line 306:
 
===URL generation===
 
===URL generation===
 
HTML versions of the [[Internet Engineering Task Force|IETF]] documents are created with the Rfcmarkup tool from Henrik Levkowetz.<ref>{{cite web
 
HTML versions of the [[Internet Engineering Task Force|IETF]] documents are created with the Rfcmarkup tool from Henrik Levkowetz.<ref>{{cite web
| url        = http://tools.ietf.org/tools/rfcmarkup/
+
| url        = https://tools.ietf.org/tools/rfcmarkup/
 
| title      = Rfcmarkup Tool
 
| title      = Rfcmarkup Tool
| accessdate  =November 2, 2009
+
| access-date = November 26, 2017
 
| last        = Levkowetz
 
| last        = Levkowetz
 
| first      = Henrik
 
| first      = Henrik
| date        = October 16, 2009
+
| date        = March 7, 2017
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
}}</ref><ref>{{cite web
 
}}</ref><ref>{{cite web
| url        = http://tools.ietf.org/tools/rfcmarkup/rfcmarkup-1.85.tgz
+
| url        = https://tools.ietf.org/tools/rfcmarkup/rfcmarkup-1.121.tgz
| title      = rfcmarkup-1.85.tgz (25 KB)
+
| title      = rfcmarkup-1.121.tgz (29.7 KB)
| accessdate  =November 2, 2009
+
| access-date = November 26, 2017
 
| last        = Levkowetz
 
| last        = Levkowetz
 
| first      = Henrik
 
| first      = Henrik
| date        = October 16, 2009
+
| date        = July 13, 2016
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
}}</ref>
 
}}</ref>
  
[[Request for Comments]] (RFC), [[Best Current Practice]] (BCP), and [[Internet Draft]] (I-D) documents which have been processed by the Rfcmarkup tool are cached by <code><nowiki>tools.ietf.org/html/</nowiki></code><ref>{{cite web
+
[[Request for Comments]] (RFC), [[Best Current Practice]] (BCP), and [[Internet Draft]] (I-D) documents which have been processed by the Rfcmarkup tool are cached by <code><nowiki>https://tools.ietf.org/html/</nowiki></code><ref>{{cite web
| url        = http://tools.ietf.org/html/
+
| url        = https://tools.ietf.org/html/
 
| title      = IETF Documents
 
| title      = IETF Documents
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
}}</ref><ref>{{cite web
 
}}</ref><ref>{{cite web
| url        = http://tools.ietf.org/html/code.txt
+
| url        = https://tools.ietf.org/html/code.txt
 
| title      = HTTP 404 handler for a directory of htmlized documents
 
| title      = HTTP 404 handler for a directory of htmlized documents
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 
| date        = October 14, 2009
 
| date        = October 14, 2009
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
}}</ref> and are linked via:
 
}}</ref> and are linked via:
:<code><nowiki>http://tools.ietf.org/html/rfc</nowiki><var><document number></var></code>
+
:<code><nowiki>https://tools.ietf.org/html/rfc</nowiki><var><document number></var></code>
:<code><nowiki>http://tools.ietf.org/html/bcp</nowiki><var><document number></var></code>
+
:<code><nowiki>https://tools.ietf.org/html/bcp</nowiki><var><document number></var></code>
:<code><nowiki>http://tools.ietf.org/html/draft-</nowiki><draft name></var></code>
+
:<code><nowiki>https://tools.ietf.org/html/draft-</nowiki><var><draft name></var></code>
  
 
[[Internet Standard]] (STD) and [[For Your Information]] (FYI) documents are linked via the Rfcmarkup tool using the <code>doc=</code> parameter:
 
[[Internet Standard]] (STD) and [[For Your Information]] (FYI) documents are linked via the Rfcmarkup tool using the <code>doc=</code> parameter:
:<code><nowiki>http://tools.ietf.org/rfcmarkup?doc=std</nowiki><document number></var></code>
+
:<code><nowiki>https://tools.ietf.org/rfcmarkup?doc=std</nowiki><var><document number></var></code>
:<code><nowiki>http://tools.ietf.org/rfcmarkup?doc=fyi</nowiki><document number></var></code>
+
:<code><nowiki>https://tools.ietf.org/rfcmarkup?doc=fyi</nowiki><var><document number></var></code>
  
 
[[Internet Experiment Note]] (IEN) and [[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR) documents are linked via the Rfcmarkup tool using the <code>url=</code> parameter and a path to the document:
 
[[Internet Experiment Note]] (IEN) and [[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR) documents are linked via the Rfcmarkup tool using the <code>url=</code> parameter and a path to the document:
:<code><nowiki>http://tools.ietf.org/rfcmarkup?url=ftp://ftp.rfc-editor.org/in-notes/ien/ien</nowiki><document number>.txt</var></code>
+
:<code><nowiki>https://tools.ietf.org/rfcmarkup?url=ftp://ftp.rfc-editor.org/in-notes/ien/ien</nowiki><var><document number>.txt</var></code>
:<code><nowiki>http://tools.ietf.org/rfcmarkup?url=ftp://ftp.rfc-editor.org/in-notes/museum/RAREreports/rtr</nowiki><document number>.txt</var></code>
+
:<code><nowiki>https://tools.ietf.org/rfcmarkup?url=ftp://ftp.rfc-editor.org/in-notes/museum/RAREreports/rtr</nowiki><var><document number>.txt</var></code>
  
 
===URL anchor generation===
 
===URL anchor generation===
Line 621: Line 363:
 
| rfc        = 5000
 
| rfc        = 5000
 
| std        = 1
 
| std        = 1
| year       = 2008
+
| date       = May 2008
| month      = May
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC5000
 
}}
 
}}
 
*{{cite IETF
 
*{{cite IETF
Line 637: Line 379:
 
| first3      = Steve
 
| first3      = Steve
 
| authorlink3 = Steve Crocker
 
| authorlink3 = Steve Crocker
| year       = 1995
+
| date       = April 1995
| month      = April
 
 
| publisher  = [[Internet Engineering Task Force|IETF]]
 
| publisher  = [[Internet Engineering Task Force|IETF]]
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 +
| doi        = 10.17487/RFC1796
 
}}
 
}}
 
*{{cite web
 
*{{cite web
 
| url        = http://www.livinginternet.com/i/ia_rfc_ref.htm
 
| url        = http://www.livinginternet.com/i/ia_rfc_ref.htm
 
| title      = Related RFC's, BCP, FYI, IEN, RTR, STD
 
| title      = Related RFC's, BCP, FYI, IEN, RTR, STD
| accessdate  =November 2, 2009
+
| access-date = November 2, 2009
 
| last        = Stewart
 
| last        = Stewart
 
| first      = William
 
| first      = William
Line 655: Line 397:
 
{{UF-COinS}}
 
{{UF-COinS}}
  
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
+
<includeonly>{{Sandbox other|
 
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
 
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
 
[[Category:Citation Style 1 specific-source templates]]
 
[[Category:Citation Style 1 specific-source templates]]
 
[[Category:Specific-source templates]]
 
[[Category:Specific-source templates]]
 
[[Category:Templates generating COinS]]
 
[[Category:Templates generating COinS]]
 +
[[Category:Computer networking templates]]
 
}}</includeonly>
 
}}</includeonly>

Latest revision as of 20:26, 30 August 2020

This is a template to cite IETF documents[1][2] including:

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 Wikipedia 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)
{{cite IETF |title= |rfc= |std= |bcp= |fyi= |draft= |ien= |rtr= |sectionname= |section= |sections= |appendix= |referenceid= |page= |pages= |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |authormask= |editor1-last= |editor1-first= |editor1-link= |others= |date= |year= |orig-year= |publisher=[[Internet Engineering Task Force|IETF]] |location= |language= |format= |access-date= |url= |section-url= |page-url= |autolink= |id= |idanchor= |idlink= |idlinktype= |doi= |doi-broken-date= |issn= |archive-url= |archive-date= |quote= |nopp= |nosec= |ref= |lay-summary= |lay-date= |postscript= |last-author-amp=}}
Most commonly used parameters (use this and you won't have to delete as much)
{{cite IETF |title= |rfc= |sectionname= |section= |page= |last= |first= |author-link= |date= |publisher=[[Internet Engineering Task Force|IETF]] |access-date= |doi=}}
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 (VPNC) |last2=Harris |first2=S. |date=September 2006 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=October 20, 2009 |doi=10.17487/RFC4677}}

Hoffman, P.; Harris, S. (September 2006). The Tao of IETF: A Novice's Guide to the Internet Engineering Task Force. IETF. doi:10.17487/RFC4677. FYI 17. RFC 4677. Retrieved October 20, 2009.

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
}}

Postel, J.; Reynolds, J. (May 1983). "Are You There (AYT)". Telnet protocol specification. IETF. p. 8. doi:10.17487/RFC0854. STD 8. RFC 854. Retrieved October 20, 2009.

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 }}
    T. Bray (March 2014). "IANA Considerations". JSON. IETF. sec. 11. doi:10.17487/RFC7159. RFC 7159. Retrieved November 26, 2017.
  • {{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 }}
    Fielding, R.; Gettys, J.; Mogul, J.; Frystyk, H.; Masinter, L.; Leach, P.; Berners-Lee, T. (June 1999). Hypertext Transfer Protocol -- HTTP/1.1. IETF. doi:10.17487/RFC2616. RFC 2616.
  • {{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 ' '. }}
    P. Mockapetris (November 1987). "Name space specifications and terminology". Domain names - concepts and facilities. IETF. sec. 3.1. doi:10.17487/RFC1034. RFC 1034. Retrieved August 3, 2008. 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 ' '.

Technical notes

Regression testing

Regression tests are available here:

Subtemplates

{{Cite IETF}} uses the following subtemplates:

URL generation

HTML versions of the IETF documents are created with the Rfcmarkup tool from Henrik Levkowetz.[10][11]

Request for Comments (RFC), Best Current Practice (BCP), and Internet Draft (I-D) documents which have been processed by the Rfcmarkup tool are cached by https://tools.ietf.org/html/[12][13] and are linked via:

https://tools.ietf.org/html/rfc<document number>
https://tools.ietf.org/html/bcp<document number>
https://tools.ietf.org/html/draft-<draft name>

Internet Standard (STD) and For Your Information (FYI) documents are linked via the Rfcmarkup tool using the doc= parameter:

https://tools.ietf.org/rfcmarkup?doc=std<document number>
https://tools.ietf.org/rfcmarkup?doc=fyi<document number>

Internet Experiment Note (IEN) and RARE Technical Reports (RTR) documents are linked via the Rfcmarkup tool using the url= parameter and a path to the document:

https://tools.ietf.org/rfcmarkup?url=ftp://ftp.rfc-editor.org/in-notes/ien/ien<document number>.txt
https://tools.ietf.org/rfcmarkup?url=ftp://ftp.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.

References

  1. Hoffman, Paul; Harris, Susan (September 2006). The Tao of IETF: A Novice's Guide to the Internet Engineering Task Force. IETF. doi:10.17487/RFC4677. FYI 17. RFC 4677. Retrieved November 2, 2009.
  2. Kessler, Gary C.; Shepard, Steven D. (December 1994). "Internet Documentation". A Primer On Internet and TCP/IP Tools. IETF. sec. 4. doi:10.17487/RFC1739. RFC 1739. Retrieved November 2, 2009.
  3. "Request for Comments (RFCs)". A Primer On Internet and TCP/IP Tools. pp. 36–38. sec. 4.1. doi:10.17487/RFC1739. RFC 1739.
  4. Bradner, Scott O. (October 1996). The Internet Standards Process -- Revision 3. IETF. doi:10.17487/RFC2026. BCP 9. RFC 2026. Retrieved November 2, 2009.
  5. "Internet Standards". A Primer On Internet and TCP/IP Tools. pp. 38–39. sec. 4.2. doi:10.17487/RFC1739. RFC 1739.
  6. Postel, Jon; Rekhter, Yakov; Li, Tony (August 1995). Best Current Practices. IETF. doi:10.17487/RFC1818. BCP 1. RFC 1818. Retrieved November 2, 2009.
  7. Malkin, Gary Scott; Reynolds, Joyce K. (March 1990). F.Y.I. on F.Y.I.: Introduction to the F.Y.I. Notes. IETF. doi:10.17487/RFC1150. FYI 1. RFC 1150. Retrieved November 2, 2009.
  8. "For Your Information Documents". A Primer On Internet and TCP/IP Tools. p. 39. sec. 4.3. doi:10.17487/RFC1739. RFC 1739.
  9. "RARE Technical Reports". A Primer On Internet and TCP/IP Tools. p. 40. sec. 4.4. doi:10.17487/RFC1739. RFC 1739.
  10. Levkowetz, Henrik (March 7, 2017). "Rfcmarkup Tool". IETF. Retrieved November 26, 2017.
  11. Levkowetz, Henrik (July 13, 2016). "rfcmarkup-1.121.tgz (29.7 KB)". IETF. Retrieved November 26, 2017.
  12. "IETF Documents". IETF. Retrieved November 2, 2009.
  13. "HTTP 404 handler for a directory of htmlized documents". IETF. October 14, 2009. Retrieved November 2, 2009.

Further reading

This template produces COinS metadata; see COinS in Wikipedia for background information.