Editing Template:R/doc (section)

===Inline invocation===
{| class="wikitable"
|-
! Usage
! Display
! Notes
|-
| <code><nowiki>{{r|RefName}}</nowiki></code> 
| Text.{{r|RefName}}
| Equivalent to <code><nowiki><ref name="RefName" /></nowiki></code>.
|-
| <code><nowiki>{{r|RefName|p=100}}</nowiki></code>

<code><nowiki>{{r|RefName|page=100}}</nowiki></code>

<code><nowiki>{{r|RefName|page=[[Hundred|100]]}}</nowiki></code>

<code><nowiki>{{r|RefName|page=[https://books.google.com/books?id=S3JHAAAAYAAJ&pg=PA15 15]}}</nowiki></code>

<code><nowiki>{{r|RefName|pp=100, 102}}</nowiki></code>

<code><nowiki>{{r|RefName|pages=100, 102}}</nowiki></code>
| Text.{{r|RefName|p=100}} 

Text.{{r|RefName|page=100}}

Text.{{r|RefName|page=[[Hundred|100]]}}

Text.{{r|RefName|page=[https://books.google.com/books?id=S3JHAAAAYAAJ&pg=PA15 15]}}

Text.{{r|RefName|pp=100, 102}}

Text.{{r|RefName|pages=100, 102}} 

| rowspan="2"| Adds a page number (or other location identifier) within the source.

Use {{para|p}} or {{para|page}} for singular pages, {{para|pp}} or {{para|pages}} for plural pages, and {{para|at}} or {{para|loc}} for other in-source-locations.

If the article cites only one location in a given source, reduce clutter by coding simply <code><nowiki>{{r|RefName}}</nowiki></code> and integrating the location into the main ''RefName'' citation.
|-
| <code><nowiki>{{r|RefName|pages=10&ndash;14}}</nowiki></code> (endash)

<code><nowiki>{{r|RefName|pages=10-14}}</nowiki></code> (hyphen)

<code><nowiki>{{r|RefName|pages=2-14&ndash;2-16}}</nowiki></code> (hyphens and endash)

<code><nowiki>{{r|RefName|pages=2-14-2-16}}</nowiki></code> (hyphens)

<code><nowiki>{{r|RefName|pages=((2-14)), ((2-16))}}</nowiki></code> (hyphens)

<code><nowiki>{{r|RefName|pp=3, 6}}</nowiki></code>

<code><nowiki>{{r|RefName|at=&sect;C}}</nowiki></code>

<code><nowiki>{{r|RefName|at=Dust jacket}}</nowiki></code>

<code><nowiki>{{r|RefName|at=para. 7}}</nowiki></code>
| Text.{{r|RefName|pages=10&ndash;14}}

Text.{{r|RefName|pages=10-14}}<!-- hyphen here! -->

Text.{{r|RefName|pages=2-14&ndash;2-16}}<!-- hyphens here! -->

Text.{{r|RefName|pages=2-14-2-16}}<!-- hyphens here! -->

Text.{{r|RefName|pages=((2-14)), ((2-16))}}

Text.{{r|RefName|pp=3, 6}}

Text.{{r|RefName|at=&sect;C}}

Text.{{r|RefName|at=Dust jacket}}

Text.{{r|RefName|at=para. 7}}
|- 
| <code><nowiki>{{r|RefName|Bam|Bar}}</nowiki></code>
| Text.{{r|RefName|Bam|Bar}}
| Equivalent to <code><nowiki>{{r|RefName}}{{r|Bam}}{{r|Bar}}</nowiki></code> or {{nobr|<code><nowiki><ref name=RefName/><ref name=Bam/><ref name=Bar/></nowiki></code>.}}

Up to nine references may be "bundled" this way. <!--NOBREAK ON WIDEST EXAMPLES ESTABLISHES COLUMN WIDTHS-->
|-
| {{nobr| <code><nowiki>{{r|1=RefName|2=Bam|3=Bar</nowiki><nowiki>|4=Bas|p1=100|pp2=10&ndash;14|at4=&sect;C}}</nowiki></code>}}

<code><nowiki>{{r|1=RefName|p1=100|2=Bam</nowiki><nowiki>|pp2=10&ndash;14|3=Bar|4=Bas|at4=&sect;C}}</nowiki></code>

<code><nowiki>{{r|n1=RefName|p1=100|n2=Bam</nowiki><nowiki>|pp2=10&ndash;14|n3=Bar|n4=Bas|at4=&sect;C}}</nowiki></code>

<code><nowiki>{{r |name1=RefName |page1=100 |name2=Bam |pages2=10&ndash;14 |name3=Bar |name4=Bas |at4=&sect;C}}</nowiki></code>

| {{nobr| Text.{{r|RefName|Bam|Bar|Bas|p1=100|pp2=10&ndash;14|at4=&sect;C}}}}         
| Equivalent to <code><nowiki>{{r|RefName|p=100}}{{r|Bam|pp=10&ndash;14}}{{r|Bar}}{{r|Bas|at=&sect;C}}</nowiki></code>.

In the example, not all references have pages; make sure that e.g. {{para|1}} matches {{para|p1}}
|-
| <code><nowiki>{{r|group=Notes|NtName}}</nowiki></code>

<code><nowiki>{{r|grp=Notes|NtName|NtCam}}</nowiki></code>

<code><nowiki>{{r|g=Notes|NtName|p=13}}</nowiki></code>
| Text.{{r|group=Notes|NtName}}

Text.{{r|grp=Notes|NtName|NtCam}}

Text.{{r|g=Notes|NtName|p=13}}
| The {{para|group}}, {{para|grp}}, and {{para|g}} parameters are equivalent and echo {{nobr|<code><nowiki><ref group=Notes name=NtName/></nowiki></code>.}}

If present, the parameter applies to all references in the template.

|-
| <code><nowiki>{{r|RefName|p=100|q=quote from the text}}</nowiki></code>

<code><nowiki>{{r|RefName|p=100|quote=quote from the text}}</nowiki></code>

<code><nowiki>{{r|RefName|p=100|quote-page=100|quote=quote from the text}}</nowiki></code>

<code><nowiki>{{r|RefName|p=100|quote-page=p|quote=quote from the text}}</nowiki></code>

|Text.{{r|RefName|p=100|q=quote from the text}}
|Makes sense only if {{para|p}} (or one of its synonyms) is present. {{para|quote}} (or {{para|q}}) underlines the superscript page number/{{wbr}}location identifier, signaling availability of a quote from the source, which pops up when the mouse is hovered over the ''dashed underlined'' bit. {{para|quote-page}} or {{para|quote-pages}} can be used to optionally specify a specific page or number of pages for the quote only. If this number is the same as what's defined through {{para|p}} or {{para|pp}}, the special symbolic tokens "p" and "pp" can be used instead of an actual page number. Curved quotes are disfavored by [[MOS:STRAIGHT]].
|-
|<code><nowiki>{{r|1=RefName|2=Bam|3=Bar|4=Bas|p1=100|pp2=10&ndash;14|at4=&sect;C|q1=Quote from 100|q4=Quote from &sect;C}}</nowiki></code>
<code><nowiki>{{r|n1=RefName|n2=Bam|n3=Bar|n4=Bas|p1=100|pp2=10&ndash;14|at4=&sect;C|q1=Quote from 100|q4=Quote from &sect;C}}</nowiki></code>
||Text.{{r|1=RefName|2=Bam|3=Bar|4=Bas|p1=100|pp2=10&ndash;14|at4=&sect;C|q1=Quote from 100|q4=Quote from &sect;C}}
|In the example, not all references have quotes; make sure that e.g. {{para|1}} and {{para|p1}} and {{para|q1}} all match.
|-
|<code><nowiki>{{r |n=RefName2 |p=201 |r=Harold Smith (1989). ''Proper Referencing''. Atlanta Press. p. 105, 201.}}</nowiki></code>
<code><nowiki>{{r |n=RefName3 |r={{cite book |author-first=Harold |author-last=Smith |date=2020 |edition=2nd |title=Proper Referencing |publisher=Atlanta Press |pages=321, 356}} }}</nowiki></code>
||More{{r |n=RefName2 |p=201 |r=Harold Smith (1989). ''Proper Referencing''. Atlanta Press. pp. 105, 201.}}{{r |n=RefName3 |p=321}} good{{r |n=RefName3 |p=356 |r={{cite book |author-first=Harold |author-last=Smith |date=2020 |edition=2nd |title=Proper Referencing |publisher=Atlanta Press |pages=321, 356}}}} prose.{{r |g=Notes |n=NestedNote |r=This example shows how to nest footnotes.{{r |n=RefName2 |p=105}}}}
|Examples of inline definitions and nested footnotes.
|-
|<code><nowiki>{{r |n=RefName4 |r=Citation A.}}</nowiki></code>

<code><nowiki>{{r |n=RefName4 |a=Citation B.}}</nowiki></code>

<code><nowiki>{{r |n=RefName5 |r=Citation C.}}</nowiki></code>

<code><nowiki>{{r |n=RefName5 |p=102 |a=Note for page 102.}}</nowiki></code>

<code><nowiki>{{r |n=RefName5 |p=342 |a=Note for page 342.}}</nowiki></code>

<code><nowiki>{{r |n=RefName5 |p=346 |qp=p |q=Quote from page 346 |a=q}}</nowiki></code>

||Two{{r |n=RefName4 |r=Citation A.}} citations{{r |n=RefName4 |a=Citation B.}} bundled into one entry, or one citation{{r |n=RefName5 |r=Citation C.}} with accumulated{{r |n=RefName5 |p=102 |a=Note for page 102.}} commentary{{r |n=RefName5 |p=342 |a=Note for page 342.}}{{r |n=RefName5 |p=346 |qp=p |q=Quote from page 346 |a=q}} from shortened references.
|Examples of annotation. If the annotation should be the page number defined through {{para|p}} or what would be shown as quote in the tooltip, the special symbolic tokens "p" and "q" can be used with {{para|annotation}} in order to avoid having to repeat this contents.

|-{{anchor|EXAMPLE_SECTION}}
|<code><nowiki>{{r |n=RefName6 |r=Citation D. |s=Context6}}</nowiki></code>
<code><nowiki>{{r |n=RefName6 |p=10 |q=Quote D |a=q |s=Context6}}</nowiki></code>

||<u><section begin="Context6"/>Context sections of the article<section end="Context6"/></u> supported by the reference <u><section begin="Context6"/>&#32;can be defined through<section end="Context6"/></u> {{tl|section}} (or <u><section begin="Context6"/>&#32;other means<section end="Context6"/></u>, see: [[Help:Labeled section transclusion|LST]]). The three parts of section "Context6" in this example{{r |n=RefName6 |r=Citation D. |s=Context6}} are shown underlined for illustration purposes.{{r |n=RefName6 |p=10 |q=Quote D |a=q |s=Context6}}
|<!-- 
--><includeonly>'''Note:''' For this example to work, you will have to view it on the non-transcluded page: '''[[Template:R/doc#EXAMPLE_SECTION|Click here!]]'''<br/></includeonly>{{tl|R}} will display its "context" as "dotted underline" tooltip (to be distinguished from the "dashed underline" tooltip further up) when hovering the mouse over the reference link<!-- possibly in the future: The section(s) will highlight on mouse-over -->. Multiple sections of the same name will be shown merged (without separator, hence include some delimiter like space into the sections). Note the special syntax used to define sections (with empty {{para|begin}} and {{para|end}} attributes). Keep the size of the selected sections reasonably short and do not forget to define the end of a section. When no name was specified, names are build following this scheme for context sections: "<code>cite_sect-''group''-''name''-''page''<!-- no hyphen here --><nowiki/>''location''</code>" (where ''group'', ''name'', ''page'' (either page or pages<!-- in this order -->) and ''location'' refer to the corresponding template parameters and can be empty if omitted).
|}