View source for Template:Sfnm/doc

{{Documentation subpage}}
{{High-use}}
{{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|Sfnm}} supports the inclusion of multiple sources in a single footnote.

==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>{{Sfnm|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: {{Sfnm|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
*{{para|group}} – [[Help:Footnotes#Footnotes: groups|reference group]] for the footnote

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>{{Sfnm|Smith|2005|1p=15|Jones|2004|2p=2}}</nowiki></code>
which will produce the following footnote: {{Sfnm|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}}

==Template data==

<templatedata>
{
	"params": {
		"1a1": {
			"aliases": [
				"1"
			],
			"label": "First author of the first source",
			"type": "string",
			"required": true
		},
		"1a2": {
			"label": "Second author of the first source",
			"type": "string"
		},
		"1a3": {
			"label": "Third author of the first source",
			"type": "string"
		},
		"1a4": {
			"label": "Fourth author of the first source",
			"type": "string"
		},
		"1y": {
			"aliases": [
				"2"
			],
			"label": "Year of the first source",
			"type": "number",
			"required": true
		},
		"1p": {
			"label": "Page cited of the first source",
			"type": "number"
		},
		"1pp": {
			"label": "Pages cited of the first source",
			"example": "2-9",
			"type": "string"
		},
		"2a1": {
			"aliases": [
				"3"
			],
			"label": "First author of the second source",
			"type": "string",
			"required": true
		},
		"2a2": {
			"label": "Second author of the second source",
			"type": "string"
		},
		"2a3": {
			"label": "Third author of the second source",
			"type": "string"
		},
		"2a4": {
			"label": "Fourth author of the second source",
			"type": "string"
		},
		"2y": {
			"aliases": [
				"4"
			],
			"label": "Year of the second source",
			"type": "number",
			"required": true
		},
		"2p": {
			"label": "Page cited of the second source",
			"type": "number"
		},
		"2pp": {
			"label": "Pages cited of the second source",
			"example": "2-9",
			"type": "string"
		}
	},
	"description": "Creates multiple short author–date citation.",
	"format": "inline"
}
</templatedata>

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