Reba inkomoko ya Inyandikorugero:Sfnmp/doc

{{Documentation subpage}}
{{lua |Module:Footnotes}}
<!-- PLEASE ADD TEMPLATE CATEGORIES AT THE BOTTOM OF THIS PAGE. -->


This is a companion template to {{tlx|Sfn}}; see there for a more general introduction. Unlike {{tld|Sfn}}, however, {{tlx|Sfnmp}} supports the inclusion of multiple sources in a single footnote and renders the year in parentheses.

==Usage==
Each of the several sources listed in the template is identified using a set of numbered ({{var|n}}) parameters where the first source is numbered <code>1</code>, the second <code>2</code>, etc.  There is no set limit to the number of sources that may be listed in a single template though editors should be aware that readability suffers with an increase of the number of sources.

The following markup:
<code><nowiki>{{Sfnmp|1a1=Smith|1a2=Jones|1a3=Johnson|1y=2005|1p=15|2a1=Jones|2a2=Johnson|2a3=Smith|2y=2004|2p=50}}</nowiki></code>
will produce the following footnote: {{Sfnmp|1a1=Smith|1a2=Jones|1a3=Johnson|1y=2005|1p=15|1ignore-err=yes|2a1=Jones|2a2=Johnson|2a3=Smith|2y=2004|2p=50|2ignore-err=yes}} <!-- |#ignore-err=yes here because template can't see into transcluded doc page -->
:{| style="border: 1px solid black"
|{{reflist}}
|}

===Parameters===
The following parameters are used where {{var|n}} always begins at 1, increases by one for each successive source; {{var|n}} has no set limit.
*{{para|{{var|n}}a{{var|m}}}} – source {{var|n}} author (required) – has the form: <code>{{var|n}}a{{var|m}}</code> where <code>{{var|n}}</code> is the source number, <code>a</code> indicates that this is an author parameter, and <code>{{var|m}}</code> identifies the {{var|m}}th author of source {{var|n}} → {{para|1a1}} is first source author one, {{para|5a4}} is fifth source author four; author numbers (<code>{{var|m}}</code>) greater than <code>4</code> are ignored; 
*{{para|{{var|n}}y}} – year – accepted formats are: <code>YYYY</code>, <code>n.d.</code> or <code>nd</code> (no date), <code>c. YYYY</code>, <code>YYYY–YYYY</code> (endash separator); all dates may have a single lowercase letter disambiguator suffix; see [[Template:Sfn#More than one work in a year|sfn §More than one work in a year]]
*{{para|{{var|n}}p}} – in-source page cited
*{{para|{{var|n}}pp}} – in-source pages cited
*{{para|{{var|n}}loc}} – in-source location when not pagination – appended to {{para|{{var|n}}p}} or {{para|{{var|n}}pp}} if present
*{{para|{{var|n}}ref}} – alternate reference identifier used to link source to its full citation; the special keyword <code>none</code> inhibits creation of a link from source to its long form reference
*{{para|{{var|n}}ps}} – source postscript – terminal character or text; defaults to none; the special keyword <code>none</code> (used by {{tld|sfn}}) is silently ignored
*{{para|ps}} – postscript – template's final terminal character or text; defaults to period (<code>.</code>);  the special keyword <code>none</code> inhibits the postscript character; yields to {{para|{{var|n}}ps}} where {{var|n}} is the last source

When a source has a single author, use of positional parameters for author and year is supported; both <code>|{{var|author}}</code> and <code>{{var|year}}</code> are required when there is more than one of these single-author sources listed in the template:
<code><nowiki>{{Sfnmp|Smith|2005|1p=15|Jones|2004|2p=2}}</nowiki></code>
which will produce the following footnote: {{Sfnmp|Smith|2005|1p=15|1ignore-err=yes|Jones|2004|2p=2|2ignore-err=yes}} <!-- |#ignore-err=yes here because template can't see into transcluded doc page -->
:{| style="border: 1px solid black"
|{{reflist}}
|}

==Literature cited==
*{{cite journal|last1=Jones|first1=John|year=2004|title=My Journal Article|journal=Journal of Important Studies|volume=509|issue=13 |pages=10–23}}
*{{cite book|last1=Jones|first1=John|last2=Johnson|first2=John|last3=Smith|first3=John|year=2004|title=Our First Book}}
*{{cite journal|last1=Smith|first1=John|year=2005|title=Another Journal Article|journal=Journal of Important Studies|volume=510|issue=14 |pages=100–134}}
*{{cite book|last1=Smith|first1=John|last2=Jones|first2=John|last3=Johnson|first3=John|year=2005|title=Our Second Book}}

==See also==
*{{tlx|sfnm}} – a similar template that does not render source year in parentheses

<includeonly>{{sandbox other||
<!-- ADD TEMPLATE CATEGORIES BELOW THIS LINE -->
[[Category:Footnote templates]]
[[Category:Author–date citation templates]]
}}</includeonly>