Template:Cite IETF/makelink/sandbox
 | This is the template sandbox page for Template:Cite IETF/makelink (diff). |
This template is a "subroutine" of {{Cite IETF}} used for conditionally creating links for different types of documents.
This "subroutine" is designed for {{Cite IETF}} and makes assumptions that may not be valid elsewhere.
Background
[edit]It uses the following algorithm:
- If the
|Url=parameter is given the template will simply display that value along with an optional anchor generated from|Anchor=appended. - If the
|Url=parameter is not given and the|Autolink=parameter evaluates to anything other thanno, then the template attempts to generate a URL:- In the order of
|Rfc=,|Std=,|Bcp=,|Fyi=,|Draft=,|Ien=, or|Rtr=, the template looks for the first nonempty parameter and create a link with it.- In the case of
|Rfc=, if|Style=is set to "html" or empty, it uses the new-style rfc-editor.org website. This new website provides a true HTML rendering with proportional text for the newer RFC pages and provides a simple "htmlized" view for the older pages with monospace font. Otherwise it uses the datatracker.ietf.org website, which always provides an "htmlized" view but offers a helpful sidebar. - In the case of
|Draft=, if|Style=is set to "text" or empty, it uses the old-style datatracker.ietf.org rendering. Otherwise it uses the new-style www.ietf.org/archive website, which offers a true HTML rendering for the newer pages but returns 404 Not Found for the older pages.
- In the case of
- If the
|Anchor=parameter is given, it will be appended to the generated url.
- In the order of
- If the
|Anchor=parameter is given but no Url is provided or auto-generated, a{{preview warning}}is produced. It may still end up invisible when passed to the bowels of{{Cite IETF}}.
Use
[edit]It is invoked as:
- {{Cite IETF/makelink
- | Url = <value of
|url=or|archiveurl=parameters> - | Anchor = <section or page anchor generated from the value of the
|section=or|page=parameters> - | Autolink = <value of
|autolink=parameter> - | Rfc = <value of
|rfc=parameter> - | Std = <value of
|std=parameter> - | Bcp = <value of
|bcp=parameter> - | Fyi = <value of
|fyi=parameter> - | Draft = <value of
|draft=parameter> - | Ien = <value of
|ien=parameter> - | Rtr = <value of
|rtr=parameter>
- | Url = <value of
- }}
Examples
[edit]{{Cite IETF/makelink |Fyi=17 |Anchor=#page-5}}
{{Cite IETF/makelink |Url=https://datatracker.ietf.org/doc/html/rfc2119 |Anchor=#section-1}}
{{Cite IETF/makelink |Rfc=1122 |Std=3}}
{{Cite IETF/makelink |Rfc=822 |Std=11 |Anchor=#section-4}}
{{Cite IETF/makelink |Rfc=854 |Std=8}}
{{Cite IETF/makelink |Anchor=#section-4}}
{{Cite IETF/makelink |Autolink=no |Anchor=#section-4}}