View source for Template:Cite doi/doc

{{Documentation subpage}}
==Usage==
<ref name=Example2006a>{{Cite doi|10.1146/annurev.earth.33.092203.122621}} "A sample quote"</ref>
<ref name=Example2006b>{{Cite doi|10.1146/annurev.earth.33.092203.122621}} "Another sample quote"</ref>

Saves you filling out a citation template every time you want to cite a source. If your source has a [[Digital Object Identifier|DOI]], just enter <code><nowiki>{{Cite doi|doi of your source}}</nowiki></code>.  There's no need to [[WP:subst|subst]] this template (so long as it matches the format of citations already in the article).

If another LIMSwiki article already uses that reference (via the Cite doi template), it will automatically use the existing information to present the full citation details of the reference in the article. If not, a bot will complete it for you if you click the "jump the queue" link (the bot does not currently autofill the template). 

Use like this:

:<code><nowiki><ref name=Example2006>{{Cite doi|10.1146/annurev.earth.33.092203.122621}}</ref></nowiki></code>

To refer to the same reference elsewhere in the same article, use:

:<code><nowiki><ref name=Example2006/></nowiki></code>

===Quotes===

To include a quote from the reference, just place it inside the '''ref''' tags. To include more than one quote, the '''name''' parameter must be unique for each '''ref''' tag.

:<code><nowiki><ref name=Example2006a>{{Cite doi|10.1146/annurev.earth.33.092203.122621}} "A sample quote"</ref></nowiki></code><ref name=Example2006a>{{Cite doi|10.1146/annurev.earth.33.092203.122621}} "A sample quote"</ref>

:<code><nowiki><ref name=Example2006b>{{Cite doi|10.1146/annurev.earth.33.092203.122621}} "Another sample quote"</ref></nowiki></code><ref name=Example2006b>{{Cite doi|10.1146/annurev.earth.33.092203.122621}} "Another sample quote"</ref>

Second references for each 
:<code><nowiki><ref name=Example2006a /><ref name=Example2006b /></nowiki></code><ref name=Example2006a /><ref name=Example2006b />

If the quote should appear every time a reference is used, then add a '''quote''' parameter to the cite doi template.

===Removing the "edit" link===
If you want to remove the "edit" link that this template places, add a second parameter with the text "noedit":
:<code><nowiki><ref name=Example2006c>{{Cite doi|10.1146/annurev.earth.33.092203.122621|noedit}}</ref></nowiki></code><ref name=Example2006c>{{Cite doi|10.1146/annurev.earth.33.092203.122621|noedit}}</ref>

===Example references===

{{reflist}}

==Formatting==

Templates produced via this template need to be formatted consistently so they match the reference formatting of all the articles they are used in.  Therefore, they are formatted under the following guidelines.  Please '''do not use''' the cite doi template in articles whose references are formatted differently.  (You could subst: the template and change its formatting in the article, or modify the article to use this mode of formatting ''if appropriate'').

;Citation template:
:[[Template:Cite journal]] (or cite book if appropriate)
;Author formatting:
:Smith, A.B.
:If possible, use {{para|last1|Smith}} and {{para|first1|A.B.}} (not Albert B., Albert Bernard, etc.)
:The usual guidelines for wikilinking apply: only use {{para|author1-link}} if the link adds value to the citation.
;Page number formatting:
:first and last page numbers written in full; for instance, R100&ndash;R101
;Dates:
:If a month or season may help locate a journal article, specify it with the date parameter (e.g. Sept 2009, Winter 1988).  Do not specify a day.
;Links:
:The URL should point to (in descending order of preference):
:*Free access to the full text of the article on the publisher's website
:*Free full text on an author's website (if no copyright issues)
:*Free full text on an advert-supported website
:*Free proofs/drafts on an author's personal website (if no copyright issues)
:*Full text available to subscribers (if abstract available to unsubscribers)

==Technical overview==

The template works by transcluding a template, which is stored as Template:cite doi/anchor_encoded_version_of_DOI.  This subpage is filled out by [[User:Citation bot|a bot]] using the {{tl|cite journal}} syntax.

== See also ==
{{cite doi family}}
=== Others ===
*{{tl|cite arXiv}} – uses a different bot
*{{tl|cite journal}}
<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Science citation templates|{{PAGENAME}}]]
</includeonly>