Template:Ref RFC/doc

Template page

Usage

Template {{Ref RFC}} is used to create references to IETF RFCs, generated from a repository of preformatted references. This way, all references are of high quality, with a minimal chance of errors, and you don't have to create each reference from scratch. You are explicitly invited to add new references or improve existing ones.

It uses templates {{Cite IETF}} and {{Rp}} to generate the reference itself.

Examples

The examples below generate a single full reference in the {{Reflist}} and can be referenced in the text many times.

{{Ref RFC|791}} yields a full reference: <ref name=rfc791>{{Cite IETF|rfc=791|std=5|title=...}} ...Updated by {{IETF RFC|1349|2474|6864|leadout=and|link=no}}.</ref>.REFERENCE FOR RFC791 IS NOT DEFINED YET. You are invited to add it here.
{{Ref RFC|791|repeat=yes}} gives you an empty reference: <ref name=rfc791 />.REFERENCE FOR RFC791 IS NOT DEFINED YET. You are invited to add it here. Make sure the full reference is created elsewhere. When using {{Ref RFC}} exclusively, references are generated automatically (thus having equal content everywhere). Specifying repeat=yes is not necessary in that case, but may be helpful when the full reference was created by other means.
{{Ref RFC|1918|rp=17}} yields a reference with an inline page number: <ref name=rfc1918>{{Cite IETF|rfc=1918|title=...}}{{Rp|page=17}}</ref>.REFERENCE FOR RFC1918 IS NOT DEFINED YET. You are invited to add it here. The reference itself contains no page number. You can add another reference to the same RFC with inline page numbers, e.g. {{Ref RFC|1918|rpp=23-24}}, without adding a new full reference in the list.REFERENCE FOR RFC1918 IS NOT DEFINED YET. You are invited to add it here.
{{Ref RFC|1918|rsection=4.3}} yields a reference with an inline section number: <ref name=rfc1918>{{Cite IETF|rfc=1918|title=...}}{{Rp|at=§4.3}}</ref>.REFERENCE FOR RFC1918 IS NOT DEFINED YET. You are invited to add it here. The reference itself contains no section number. You can add another reference to the same RFC with inline page numbers or section, e.g. {{Ref RFC|1918|rpp=23-24}}, without adding a new full reference in the list.REFERENCE FOR RFC1918 IS NOT DEFINED YET. You are invited to add it here.
{{Ref RFC|8200|notes=no}} yields a reference to RFC 8200 without notes specifying which other RFC are affected by or are affecting this RFC.REFERENCE FOR RFC8200 IS NOT DEFINED YET. You are invited to add it here. It is not possible to add the same reference with notes later.

References with section or page numbers or a quote are generated with an anonymous <ref>...</ref> pair, to create individual full references in the {{Reflist}}.

{{Ref RFC|8201|section=5.4}} yields a reference to RFC 8201 with a section.REFERENCE FOR RFC8201 IS NOT DEFINED YET. You are invited to add it here.
{{Ref RFC|8201|pp=17-18|quote=Removed a "Note" from Section 4.}} yields another reference to RFC 8201, now with page numbers and a quote.REFERENCE FOR RFC8201 IS NOT DEFINED YET. You are invited to add it here.
{{Ref RFC|8201|section=5.3|p=11}} yields another reference to RFC 8201, now with a section and a page number.REFERENCE FOR RFC8201 IS NOT DEFINED YET. You are invited to add it here.

In some cases, you want the full reference, but not within <ref>...</ref> tags:

{{Ref RFC|791|ref=no}} which gives you: REFERENCE FOR RFC791 IS NOT DEFINED YET. You are invited to add it here.

Example references

Template data

Template {{Ref RFC}} is used to create references to RFCs. It uses a repository of preformatted reference texts.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
RFC Number1

The number of the RFC to reference.

Example
8200
Stringsuggested
Notesnotes

Display notes regarding the RFC or not (default: 'yes'). If set to 'no', no notes are displayed.

Example
notes=no
Stringoptional
Refref

If set to 'no', no <ref>...</ref> is generated, just the reference itself.

Example
ref=no
Stringoptional
Quotequote

A quote from the RFC.

Example
quote=Nodes not implementing Path MTU Discovery must use the IPv6 minimum link MTU defined in [RFC8200] as the maximum packet size.
Stringoptional
Repeatrepeat

This reference is a repeat of an earlier one. If set to 'yes', no new reference is created, just an empty <ref name=rfc9999 /> one.

Example
repeat=yes
Stringoptional
Inline page numberrp

Page number alongside the reference itself. Uses {{rp|page=}}.

Example
rp=37
Stringoptional
Inline page numbersrpp

Page numbers alongside the reference itself. Uses {{rp|pages=}}.

Example
rpp=13-15
Stringoptional
Inline section numberrsection

Section number alongside the reference itself. Uses {{rp|at=§}}.

Example
rsection=4.3
Stringoptional
Page numberp

Creates new reference to specific page number. Displays as 'p.'

Example
p=37
Stringoptional
Page numberspp

Creates new reference to specific page numbers. Displays as 'pp.'

Example
pp=37,116-19
Stringoptional
Sectionsection

Creates new reference to a specific section. Displays as 'Sec.'

Example
section=4.3
Stringoptional

See also