មើលកូដរបស់ ទំព័រគំរូ:Refn/doc

===Purpose===
This template is used to [[Help:Footnotes|create footnotes in Wikipedia]], as an alternative and complement to the {{tag|ref|o}} tag. [[:mw:Extension:Cite/Cite.php#Substitution and embedded parser functions|Because of a technical limitation]], some of the standard Wikipedia markup elements that are often used in the article prose do not work within a set of {{tag|ref}} tags, including but not limited to [[Help:Pipe trick|the pipe trick]], [[Wikipedia:Substitution|template substitution]] and another "nested" set of {{tag|ref}} tags. For example, the following does not work as expected:
# {{tag|ref|content=<nowiki>[[Help:Footnotes|]]</nowiki>}} (Generates: <nowiki>[[Help:Footnotes|]]</nowiki> instead of a wikilink)
# {{tag|ref|content=<nowiki>{{SUBST:TODAY}}</nowiki>}} (Generates: <nowiki>{{SUBST:TODAY}}</nowiki> instead of the date that the edit was made)
# {{tag|ref|content=<nowiki>Explanatory footnote<ref>Citation</ref></nowiki>}} (Generates: <span style="font-weight: bold; color: #CC0000;">Cite error: A &lt;ref&gt; tag is missing the closing &lt;/ref&gt; (see the [[:Help:Cite errors/Cite error included ref|help page]]).</span> &lt;/ref&gt;)

Replacing the outermost {{tag|ref}} set with {{tlp|Refn}} allows for the use of the markup elements listed above.

===Usage===
{{tld|refn|2=group=groupname|3=name=name|4=Contents of the footnote|allowlinebreak=yes}}

:* '''groupname''': Groupname per [[WP:REFGROUP]]; if not specified, then the main and nested references will be rendered into the same reference list
:* '''name''': Reference name per [[WP:REFNAME]]

{{refname rules}}

===Examples===
====Footnotes with citations====
{{markup
|<nowiki>An example.{{refn|group=note|name=first|A note.<ref>An included reference.</ref>}}
Another example.{{refn|group=note|Another note.<ref>Another included reference.</ref>}}
A third example.{{refn|group=note|The third note.<ref>The reference in the third note.</ref>}}
Repeating the first example.{{refn|group=note|name=first}}

==Notes==
{{reflist|group=note}}

==References==
{{reflist}}</nowiki>
|An example.{{refn|group=note|name=first|A note.<ref>An included reference.</ref>}}
Another example.{{refn|group=note|Another note.<ref>Another included reference.</ref>}}
A third example.{{refn|group=note|The third note.<ref>The reference in the third note.</ref>}}
Repeating the first example.{{refn|group=note|name=first}}

{{fake heading|sub=3|Notes}}
{{reflist|group=note}}

{{fake heading|sub=3|References}}
{{reflist|close=1}}
}}
====Substitution====
The first example shows that substitution does not work in a regular {{tag|ref}} tag (the accessdate does not appear correctly). The second example shows that the accessdate is substituted correctly within {{tl|refn}}.

{{markup
|<nowiki><ref>{{cite web |accessdate={{Subst:TODAY}} |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary}}</ref>
{{reflist}}</nowiki>
|<ref>{{cite web |accessdate={{Subst:TODAY}} |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary|template doc demo=true}}</ref>
{{reflist|close=1}}

|<nowiki>{{refn|{{cite web |accessdate={{Subst:TODAY}} |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary}}}}
{{reflist}}</nowiki>
|{{refn|{{cite web |accessdate=4 April 2014 |title=Languages |work=Apache HTTP Server |agency=Ohloh |publisher= Black Duck Software |url=https://www.ohloh.net/p/apache/analyses/latest/languages_summary}}}}
{{reflist|close=1}}
}}

===Errors===
If the reference or note content is missing, then "Cite error: Invalid {{tag|ref|open}} tag; refs with no name must have content." will be displayed.

===List defined references===
Currently, this template may not be used more than once within [[WP:LDR|list-defined references]]. Doing so will result in Cite errors; see {{bug|20707}}.

===See also===
{{#lst:Help:Cite errors/Cite error group refs without references|rlt}}

{{Wikipedia referencing}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Footnote templates]]

</includeonly>