View source for Template:SfnRef inline/doc

{{Documentation subpage}}
{{Template shortcut|Sfnref inline|Harvid inline}}
{{Lua|Module:Footnotes}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

{{tlx|SfnRef inline}} is a variant of {{tlx|SfnRef}} (a.k.a. {{tlx|harvid}}) that works in manually written, non-templated citations. In most cases, this is expected to be used {{em|temporarily}}, in cases where an editor is not certain how to format the full citation data into a template, or does not have time to do it, or there is a dispute on the talk page about which citation format should be used, etc.  In a handful of cases, however, there remain some articles with local consensus to use entirely manually formatted citations, to exactly mirror some off-site citation style. This rare, but technically permitted by the [[WP:CITESTYLE]] guideline. 

This template provides a link anchor to work with the [[Wikipedia:Citing sources#Short citations|shortened-footnote]] templates {{tlx|sfnp}}, {{tlx|harvp}} (and their [[Vancouver system|Vancouver-citation-style]] equivalents {{tlx|sfn}} and {{tlx|harvnb}}). Until this template, there was no easy way to cite the same manually-cited source multiple times at different pages in such an article, using short citations that link to the full citation, and auto-combining duplicate cite to the same page into a single short cite. (It was technically possible, but required manually creating an anchor point with a complicated <code>CITEREF...</code> ID that matched the input expected by a template like {{tnull|sfnp}} or {{tnull|harvp}}.)

What the original {{tnull|SfnRef}} does is just generate a <code>CITEREF...</code> anchor string using author and year data, and pass this to the {{para|ref}} parameter of a [[Help:Citation Style 1|CS1]] ({{tlx|Cite book}}, {{tlx|Cite journal}}, etc.) or [[Help:Citation Style 2|CS2]] ({{tlx|Citation}}) template, which then generates the necessary anchor.

What {{tnull|SfnRef inline}} does is create an invisible-to-the-reader anchor using the same <code>CITEREF...</code> ID, in a span: <code><nowiki><span class="anchor" id="CITEREF..."></span></nowiki></code>  This is equivalent to manually doing {{tlx|Anchor|CITEREF...}}, except of course that you don't have to manually figure out the <code>CITEREF...</code> ID.

== Usage ==

This template is used exactly the same as {{tlx|SfnRef}} / {{tlx|harvid}}, except it is not used inside a CS1/CS2 citation template's {{para|ref}} parameter, but used at the end of a manually formatted citation, either inside {{xtag|ref|p}}, or when placed in a list of cited sources at the bottom of the page. If the manual citation is not all on one line for some reason, it would be better to use this template at the beginning of the citation.

The parameters are 1 to 4 author surnames (in the same order as found in the citation) and the year as the last parameter, each with it's own <code>{{!}}</code>.

;Examples:
:{{tnull|SfnRef inline|Smith|2022}}<br />
:{{tnull|SfnRef inline|Garcia|Chiang|1975}}<br />
:{{tnull|SfnRef inline|Banh|van Doren|Lytton-St. John|O'Brien|2009}}

Unlike with templated citations, the input is actually rather arbitrary, but {{em|it is best if the parameters actually match the citation data exactly}} (including precise author name spellings and order), since someone might template the manually formatted citation at any time, which would auto-generate citation anchor data that could then be used with the same {{tlx|sfnp}}, {{tlx|harvp}}, or other short-citation templates without them having to be updated.

== Example==

Some article text here. The footnote that follows will go to a short citation near the bottom of this page, which in turn will link to the full citation below it, which is free text using this tempate and is not itself a template-formatted citation.{{sfnp|Buchanan|2023|loc=para. 7}}

== See also ==
* {{tlx|SfnRef}} – The original template of this sort, for use inside {{para|ref}} in CS1/CS2 citation templates
* {{tlx|Sfnp}} – main shortened-footnote template to use with this
* {{tlx|Sfn}} – version of {{tnull|Sfnp}} for use in articles with Vancouver-style citations
* {{tlx|Harvp}} – secondary shortened-footnote template to use with this
* {{tlx|Harvnb}} – Vancouver version of {{tlx|Harvp}}

== References ==
{{reflist}}
{{refbegin}}

=== Cited works ===
* Buchanan, Abigail. (14 November 2023). "[https://en.wikipedia.org/wiki/Template:SfnRef_inline 'We are making bagpipes sexy again': Inside the late Queen's beloved Scottish music school]". ''[[The Daily Telegraph]]'') {{Webarchive |url= https://web.archive.org/web/20240102130411/https://www.telegraph.co.uk/christmas/2023/11/14/inside-the-late-queens-beloved-scottish-music-school/ |date=2 January 2024}}{{SfnRef inline|Buchanan|2023}}
{{refend}}

{{Wikipedia referencing}}

<includeonly>{{Sandbox other||
[[Category:Author–date citation templates]]
[[Category:Footnote templates]]
}}</includeonly>