imported>Artoria2e5: /* URL anchor generation */

2023-04-11T05:58:23Z

URL anchor generation

← Older revision		Revision as of 06:58, 11 April 2023
Line 140:		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= \|editor1-last= \|editor1-first= \|editor1-link= \|others= \|date= \|year= \|orig-date= \|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>		:<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-date= \|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= \|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)
Line 354:		Line 354:
	:{{para\|page\|<var>number</var>}} generates <code>#page-<var><number></var></code>		:{{para\|page\|<var>number</var>}} generates <code>#page-<var><number></var></code>
	The template will give priority to the first of the parameters: {{para\|section}}, {{para\|appendix}}, {{para\|referenceid}}, or {{para\|page}} in this order and create an anchor using the first matching parameter.		The template will give priority to the first of the parameters: {{para\|section}}, {{para\|appendix}}, {{para\|referenceid}}, or {{para\|page}} in this order and create an anchor using the first matching parameter.

			== See also ==
			* {{tl\|Ref RFC}} – pre-populated citations

	==References==		==References==

Richardpruen: 1 revision imported: Templates and CSS files

2022-12-04T18:23:05Z

1 revision imported: Templates and CSS files

← Older revision	Revision as of 19:23, 4 December 2022
(No difference)

wikipedia>AManWithNoPlan: canonical parameters

2021-12-07T19:25:33Z

canonical parameters

New page

{{Documentation subpage}}<includeonly>{{Intricate template}}</includeonly>


This is a template to cite [[Internet Engineering Task Force|IETF]] documents<ref>{{cite IETF
| title = The Tao of IETF: A Novice's Guide to the Internet Engineering Task Force
| rfc = 4677
| fyi = 17
| last1 = Hoffman
| first1 = Paul
| authorlink1 = Paul Hoffman (VPNC)
| last2 = Harris
| first2 = Susan
| date = September 2006
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC4677
}}</ref><ref>{{cite IETF
| title = A Primer On Internet and TCP/IP Tools
| rfc = 1739
| sectionname = Internet Documentation
| section = 4
| last1 = Kessler
| first1 = Gary C.
| last2 = Shepard
| first2 = Steven D.
| date = December 1994
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC1739
| ref = ietf
}}</ref> including:
*[[Request for Comments]] (RFC)<ref>{{cite IETF
| rfc = 1739
|title=A Primer On Internet and TCP/IP Tools
| sectionname = Request for Comments (RFCs)
| section = 4.1
| pages = 36–38
| idanchor = ietf
}}</ref>
*[[Internet Standard]] (STD)<ref>{{cite IETF
| title = The Internet Standards Process -- Revision 3
| rfc = 2026
| bcp = 9
| last = Bradner
| first = Scott O.
| authorlink = Scott Bradner
| date = October 1996
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC2026
}}</ref><ref>{{cite IETF
| rfc = 1739
|title=A Primer On Internet and TCP/IP Tools
| sectionname = Internet Standards
| section = 4.2
| pages = 38–39
| idanchor = ietf
}}</ref>
*[[Best current practice]] (BCP)<ref>{{cite IETF
| title = Best Current Practices
| rfc = 1818
| bcp = 1
| last1 = Postel
| first1 = Jon
| authorlink1 = Jon Postel
| last2 = Rekhter
| first2 = Yakov
| authorlink2 = Yakov Rekhter
| last3 = Li
| first3 = Tony
| date = August 1995
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC1818
}}</ref>
*[[For Your Information]] (FYI)<ref>{{cite IETF
| title = F.Y.I. on F.Y.I.: Introduction to the F.Y.I. Notes
| rfc = 1150
| fyi = 1
| last1 = Malkin
| first1 = Gary Scott
| last2 = Reynolds
| first2 = Joyce K.
| authorlink2 = Joyce K. Reynolds
| date = March 1990
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC1150
}}</ref><ref>{{cite IETF
| rfc = 1739
|title=A Primer On Internet and TCP/IP Tools
| sectionname = For Your Information Documents
| section = 4.3
| page = 39
| idanchor = ietf
}}</ref>
*[[Internet Draft]] (I-D)
*[[Internet Experiment Note]] (IEN)
*[[Réseaux Associés pour la Recherche Européenne|RARE]] Technical Reports (RTR)<ref>{{cite IETF
| rfc = 1739
|title=A Primer On Internet and TCP/IP Tools
| sectionname = RARE Technical Reports
| section = 4.4
| page = 40
| idanchor = ietf
}}</ref>

{{TOC limit|3}}

== 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]].

===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.

{| class="wikitable"
! colspan="3" | Full version (copy and paste text below and delete parameters you don't need)
|- width="50%" style="vertical-align:top;"
| 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= |editor1-last= |editor1-first= |editor1-link= |others= |date= |year= |orig-date= |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;"
! colspan="3" | Most commonly used parameters (use this and you won't have to delete as much)
|- width="50%" style="vertical-align:top;"
| colspan="3" |
:<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;"
! Example 1
| 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. |date=September 2006 |publisher=[[Internet Engineering Task Force|IETF]] |access-date=October 20, 2009 |doi=10.17487/RFC4677}}</nowiki></code>
| 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. |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;"
! Example 2
| style="vertical-align: top;" |<pre>{{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
}}</pre>
| style="vertical-align: top;" |
{{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
}}
|}

==Examples==
*<nowiki>{{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
}}</nowiki> → {{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
}}

*<nowiki>{{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
}}</nowiki> → {{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
}}

*<nowiki>{{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 ' '.
}}</nowiki> → {{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 ' '.
}}

==Technical notes==

===Regression testing===
[[Regression testing|Regression tests]] are available here:
*{{tl|Cite IETF/regression tests}}

===Subtemplates===
{{tl|Cite IETF}} uses the following subtemplates:
*{{tl|Cite IETF/doctypes}}
*{{tl|Cite IETF/makelink}}
*{{tl|Cite IETF/refanchor}}

===URL generation===
HTML versions of the [[Internet Engineering Task Force|IETF]] documents are created with the Rfcmarkup tool from Henrik Levkowetz.<ref>{{cite web
| url = https://tools.ietf.org/tools/rfcmarkup/
| title = Rfcmarkup Tool
| access-date = November 26, 2017
| last = Levkowetz
| first = Henrik
| date = March 7, 2017
| publisher = [[Internet Engineering Task Force|IETF]]
}}</ref><ref>{{cite web
| url = https://tools.ietf.org/tools/rfcmarkup/rfcmarkup-1.121.tgz
| title = rfcmarkup-1.121.tgz (29.7 KB)
| access-date = November 26, 2017
| last = Levkowetz
| first = Henrik
| date = July 13, 2016
| publisher = [[Internet Engineering Task Force|IETF]]
}}</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>https://tools.ietf.org/html/</nowiki></code><ref>{{cite web
| url = https://tools.ietf.org/html/
| title = IETF Documents
| access-date = November 2, 2009
| publisher = [[Internet Engineering Task Force|IETF]]
}}</ref><ref>{{cite web
| url = https://tools.ietf.org/html/code.txt
| title = HTTP 404 handler for a directory of htmlized documents
| access-date = November 2, 2009
| date = October 14, 2009
| publisher = [[Internet Engineering Task Force|IETF]]
}}</ref> and are linked via:
:<code><nowiki>https://tools.ietf.org/html/rfc</nowiki><var><document number></var></code>
:<code><nowiki>https://tools.ietf.org/html/bcp</nowiki><var><document number></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:
:<code><nowiki>https://tools.ietf.org/rfcmarkup?doc=std</nowiki><var><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:
:<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>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===
Anchors are generated for the URL using four parameters:
:{{para|section|<var>number</var>}} generates <code>#section-<var><number></var></code>
:{{para|appendix|<var>number</var>}} generates <code>#appendix-<var><number></var></code>
:{{para|referenceid|<var>id</var>}} generates <code>#ref-<var><id></var></code>
:{{para|page|<var>number</var>}} generates <code>#page-<var><number></var></code>
The template will give priority to the first of the parameters: {{para|section}}, {{para|appendix}}, {{para|referenceid}}, or {{para|page}} in this order and create an anchor using the first matching parameter.

==References==
{{reflist|2}}

==Further reading==
*{{cite IETF
| title = Internet Official Protocol Standards
| rfc = 5000
| std = 1
| date = May 2008
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC5000
}}
*{{cite IETF
| title = Not All RFCs are Standards
| rfc = 1796
| last1 = Huitema
| first1 = Christian
| last2 = Postel
| first2 = Jon
| authorlink2 = Jon Postel
| last3 = Crocker
| first3 = Steve
| authorlink3 = Steve Crocker
| date = April 1995
| publisher = [[Internet Engineering Task Force|IETF]]
| access-date = November 2, 2009
| doi = 10.17487/RFC1796
}}
*{{cite web
| url = http://www.livinginternet.com/i/ia_rfc_ref.htm
| title = Related RFC's, BCP, FYI, IEN, RTR, STD
| access-date = November 2, 2009
| last = Stewart
| first = William
| publisher = LivingInternet.com
}}

{{Citation Style 1}}
{{Wikipedia referencing}}
{{UF-COinS}}

<includeonly>{{Sandbox other|
| 
[[Category:Citation Style 1 specific-source templates]]
[[Category:Specific-source templates]]
[[Category:Templates generating COinS]]
[[Category:Computer networking templates]]
}}</includeonly>

Template:Cite IETF/doc - Revision history

imported>Artoria2e5: /* URL anchor generation */

Richardpruen: 1 revision imported: Templates and CSS files

wikipedia>AManWithNoPlan: canonical parameters