View source for Template:Cite Q/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Lua|Module:Cite Q|Module:WikidataIB|Module:Wd|Module:String}}
{{Uses Wikidata}}

== Usage ==

A wrapper for {{Tl|Citation}}, which calls available values from [[Wikidata]].

An example of an article using this template for ''all'' of its references is [[South Pole Telescope]]; an example using Harvard style citations is [[Suffix automaton]].

By default, if there are more than eight author names, the template displays three, followed by "et al". This can be changed using {{para|display-authors}}; using that parameter with no value displays them all. The same applies to multiple editors - see the test-case pages.

=== Future developments ===

* Once robust the functionality should be merged into {{Tl|Citation}}
* Eventually, each signed-in reader should be able to set, under their "Preferences", the style in which they wish to see citations rendered. No more [[WP:CITEVAR|CiteVar]] wars!
* We should have a [[:mediawiki:|Global templates|lobal template repository]], so the code can be used by multiple wikis, without having to manually copy it after every update.g

===Parameters ===

* {{para|1}} = Wikidata QID for the article

Additionally, any named parameter used in {{tl|citation}} may be entered and will overwrite the value in Wikidata. Using such parameters, with a value of <code>unset</code>, will suppress display of data from Wikidata.

=== Blank ===

:<code><nowiki><ref name="">{{Cite Q| XXQIDXX }}</ref></nowiki></code>

=== Reference naming ===

For ease of use, you may wish to name your references to reflect the cited work, for example:

:<code><nowiki><ref name="Williams-2010">{{Cite Q|Q15625490}}</ref></nowiki></code>

===Parameter / entity map===
This section lists where each of the template's supported parameters gets its data.
P734}}
{{Columns-start}}
====Bibliographic parameters====
*{{para|author''n''}} = {{Wikidata entity link|P50}}; {{Wikidata entity link|P2093}}
*{{para|chapter}}     = {{Wikidata entity link|P792}}
*{{para|date}}        = {{Wikidata entity link|P577}}
*{{para|editor''n''}} = {{Wikidata entity link|P98}}
*{{para|issue}}       = {{Wikidata entity link|P433}}
*{{para|journal}}     = {{Wikidata entity link|P1433}}
*{{para|language}}    = {{Wikidata entity link|P407}}
*{{para|others}}      = {{Wikidata entity link|P86}}, {{Wikidata entity link|P110}}
*{{para|place}}       = {{Wikidata entity link|P291}}
*{{para|publisher}}   = {{Wikidata entity link|P123}}
*{{para|series}}      = {{Wikidata entity link|P179}}
*{{para|title}}       = {{Wikidata entity link|P1476}}
*{{para|title}}       = Wikidata label
*{{para|url}}         = {{Wikidata entity link|P953}}, {{Wikidata entity link|P856}}, {{Wikidata entity link|P2699}}
*{{para|volume}}      = {{Wikidata entity link|P478}}
{{Column}}

====Identifier parameters====
*{{para|arxiv}}       = {{Wikidata entity link|P818}}
*{{para|bibcode}}     = {{Wikidata entity link|P819}}
*{{para|biorxiv}}     = {{Wikidata entity link|P3951}}
*{{para|citeseerx}}   = {{Wikidata entity link|P3784}}
*{{para|doi}}         = {{Wikidata entity link|P356}}
*{{para|hdl}}         = {{Wikidata entity link|P1184}}
*{{para|isbn}}        = {{Wikidata entity link|P212}}
*{{para|isbn}}        = {{Wikidata entity link|P957}}
*{{para|ismn}}        = {{Wikidata entity link|P1208}}
*{{para|jstor}}       = {{Wikidata entity link|P888}}
*{{para|lccn}}        = {{Wikidata entity link|P1144}}
*{{para|mr}}          = {{Wikidata entity link|P889}}
*{{para|oclc}}        = {{Wikidata entity link|P243}}
*{{para|ol}}          = {{Wikidata entity link|P648}}
*{{para|osti}}        = {{Wikidata entity link|P3894}}
*{{para|pmc}}         = {{Wikidata entity link|P932}}
*{{para|pmid}}        = {{Wikidata entity link|P698}}
*{{para|ssrn}}        = {{Wikidata entity link|P893}}
{{Columns-end}}

=== Examples ===

;<code><nowiki>{{Cite Q|Q15625490}}</nowiki></code>
:{{Cite Q|Q15625490}}
;<code><nowiki>{{Cite Q|Q15625490|page=42}}</nowiki></code>
:{{Cite Q|Q15625490|page=42}}
;<code><nowiki>{{Cite Q|Q15625490|access-date=18 May 2017}}</nowiki></code>
:{{Cite Q|Q15625490|access-date=18 May 2017}}
;<code><nowiki>{{Cite Q|Q15625490|quote=lorem ipsum}}</nowiki></code>
:{{Cite Q|Q15625490|quote=lorem ipsum}}
;<code><nowiki>{{Cite Q|Q25766745}}</nowiki></code>
:{{Cite Q|Q25766745}}
;<code><nowiki>{{Cite Q|Q25766745 |chapter=The Final Cut}}</nowiki></code> (with chapter specified)
:{{Cite Q|Q25766745 |chapter=The Final Cut}}
;<code><nowiki>{{Cite Q|Q25766745 |pages=48-52}}</nowiki></code> (with pages)
:{{Cite Q|Q25766745 |pages=48-52}}
;<code><nowiki>{{Cite Q|Q15625490|access-date=18 May 2017}}</nowiki></code>
:{{Cite Q|Q15625490|access-date=18 May 2017}}
;<code><nowiki>{{Cite Q|Q25766745|mode=cs1}}</nowiki></code>
:{{Cite Q|Q25766745|mode=cs1}}
;<code><nowiki>{{Cite Q|Q25766745|mode=cs2}}</nowiki></code>
:{{Cite Q|Q25766745|mode=cs2}}
;<code><nowiki>{{Cite Q|Q25766745|author-mask=1}}</nowiki></code>
:{{Cite Q|Q25766745|author-mask=1}}

For additional examples, see [[Template:Cite Q/testcases|testcases]].

== Module:Wd ==

[[Module:Wd]] can automatically cause this template to be invoked, e.g.,
;<code><nowiki>{{Wikidata|references|raw|Q2978|P2046}}</nowiki></code>
:{{Wikidata|references|raw|Q2978|P2046}}
currently causes the following to be invoked:
;<code><nowiki>{{Cite Q|Q15707237|pages=242}}</nowiki></code>
:{{Cite Q|Q15707237|pages=242}}
because an {{wikidata entity link|P2046}} statement on {{wikidata entity link|Q2978}} is referenced to be {{wikidata entity link|P248}} {{wikidata entity link|Q15707237}} with {{wikidata entity link|P304}} = 242.
{{hatnote|See [[d:Q2978#P2046]]}}

== Issues ==

* Render {{Wikidata entity link|P1680}}, following the title with a <code>:</code>
* More properties/ parameters to add
* Parameters with no equivalent property?
* Move Wikidata link before {{para|quote}} (and after other IDs like {{Para|pmid}})
** Can be achieved by passing to {{tl|Citation}}'s {{para||id}} parameter
* Check/ resolve handling of redirected QID
* Resolve special case of newspaper articles
* Improve date formatting options
* Handle volume in a serial
* Order of precedence for rendering author names:
*# {{Wikidata entity link|P1932}} qualifier on {{Wikidata entity link|P50}}
*# {{Wikidata entity link|P2093}}
*# {{Wikidata entity link|P50}} label in English
*# {{Wikidata entity link|P50}} label in any other language
** <s>Regardless of which of the above is used, link to the author biography article if available, via {{Wikidata entity link|P50}} (matched via {{Wikidata entity link|P1545}} if applicable)</s>
* Author names (Western-style, at least) should display as "Last, First Middle" to match Wikipedia house style
** How to deal with [[Tussenvoegsel]]s
* Are there values of {{para||others}} which are not illustrators? Possibly:
**signatories
**presenter
**performer 
* Add  a tracking category for references with a {{WDP|P1366}} statement
* Add  a tracking category for references with a {{WDP|P5824}} statement
* Links to sister projects: Wikisource, if a transcription project exists; Wikibooks; Wikiversity (esp. the Wikijournals there); perhaps more
**Avoid <code><nowiki><ref name="dicc">{{Cite Q|Q100160262}} {{cite wikisource|wslanguage=pt|wslink=Diccionario Bibliographico Brazileiro/Francisco Antonio de Almeida|title=Transcription}}</ref></nowiki></code>!
* Consider case where author is given as {{Q|Q311624}}
* <s>Where there is a Wikipedia article about the work cited, link the title to that, overriding the URL if necessary (example: [[:d:Q25766745]])</s>
** Ditto for editions of works
* <s>Multiple author names treated as one blob</s>
* <s>Linking author name(s)</s>
* <s>Title for a book uses <code><nowiki>{{ #invoke:WikidataIB |getLink |{{{1}}} }}</nowiki></code> and may be expensive</s>
* <s>Fix {{para|ol}} values</s>
* <s>Need to add manual date for newspaper articles/ website articles.</s> 
* <s>Make publisher a link, where appropriate</s>
* <s>Improve handing of unexpected multiple values</s>
** <s>e.g. Handle multiple DOIs</s>
* <s>Handle author name string ({{Wikidata entity link|P2093}}) values (e.g. on [[d:Q38000000|Q38000000]])</s>
* <s>Handle pseudonymous author personas such as [[P. D. Q. Bach]] or [[Mark Twain]]</s>
* <s>What to do if title not in English</s>
* <s>Need to handle volume, issue and page(s) as qualifiers of {{Wikidata entity link|P1433}}</s>
* <s>Need wider variety of examples/ test cases</s>
* <s>If language of work or name is set (and not the local language); pass that; if not but language of title is set (and not the local language), use that</s>
* <s>The <code>url</code> parameter should also pick up data from the properties {{Wikidata property link|953}} and {{Wikidata property link|2699}}</s>
* <s>Linking title to Wikipedia article, if any</s>
* <s>Need to fetch ISSN etc. from item about journal</s>

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Templates that wrap Citation]]
[[Category:Templates using data from Wikidata]]
}}</includeonly>