Difference between revisions of "Template:Citation/quick/doc"

From blackwiki
Jump to navigation Jump to search
(Undid revision 513458712 by Wikid77 (talk) and you don't misrepresent a discussion or alter template messages. if you don't like that, we can take it to the appropriate forum.)
imported>Wikid77
(noted parameter "pages=n" will auto-adjust to show "p." for a singular lone page number.)
Line 1: Line 1:
{{mbox|image={{stop}}|text=There is currently no [[wp:consensus|consensus]] for use of this template in articles. <br /> See also: [[Wikipedia:Templates for discussion/Log/2012 July 15#Template:Fcite]]}}
+
{{mbox|image={{stop}}|text=There is currently no [[wp:consensus|consensus]] to ban use of this template in articles. <br /> See also: [[Wikipedia:Templates for discussion/Log/2012 July 15#Template:Fcite]]}}
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- Categories and interwikis go at the bottom of this page. -->
 
<!-- Categories and interwikis go at the bottom of this page. -->
Line 11: Line 11:
 
:::* author&nbsp;=&nbsp;<nowiki>[[Arthur&nbsp;C.&nbsp;Clarke|A.&nbsp;Clarke]]</nowiki>
 
:::* author&nbsp;=&nbsp;<nowiki>[[Arthur&nbsp;C.&nbsp;Clarke|A.&nbsp;Clarke]]</nowiki>
 
To use rare parameters, then the original full templates should be used, instead, such as using the full {&#123;[[Template:Cite book|cite book]]}} to list editor names or show an authormask.
 
To use rare parameters, then the original full templates should be used, instead, such as using the full {&#123;[[Template:Cite book|cite book]]}} to list editor names or show an authormask.
 +
 +
The parameter "pages=n" will auto-adjust to show "p." for a singular lone page number, or "pp." for a plural page-range. Parameter "page=" always shows the "p." prefix.
  
 
In articles which contain more than 300 formatted references, the speed of formatting a large article, during 2009, reached 30–60 seconds for logged-in users, so the {cite quick} template can be used to run 10x faster (3–6 seconds) when reformatting an article. Many large articles experienced similar long delays during 2009–2012, due to using numerous large templates. Also, there have been some cases where other large templates, in the same articles, have exceeded template resources, and so {cite_quick} could be used in those articles to allow hundreds more citations without exceeding the template limits.
 
In articles which contain more than 300 formatted references, the speed of formatting a large article, during 2009, reached 30–60 seconds for logged-in users, so the {cite quick} template can be used to run 10x faster (3–6 seconds) when reformatting an article. Many large articles experienced similar long delays during 2009–2012, due to using numerous large templates. Also, there have been some cases where other large templates, in the same articles, have exceeded template resources, and so {cite_quick} could be used in those articles to allow hundreds more citations without exceeding the template limits.

Revision as of 21:27, 5 October 2012

The Template:Cite quick is a fast-cite alternative to {{cite web}} or {{cite news}} or {{cite book}}, for use in large articles using Citation style 1. To allow extreme speed, only the basic parameter names are supported, such as "last3=" or "first3=" rather than "surname3=" or "given3=" (etc.), and "author=" but not "author1=". For rare parameters, the original cite templates can still be used, and mixed within an article. To view all parameter names, see: Template:Cite_web/doc.

Usage: {{cite quick |web |title=Xxx | url=http://url.com | date=1 May 2009 |accessdate=1 June 2012}}
  {{cite quick |book |title=Xxx | chapter=Chapter 3: Issues |url=http://url.com | date=March 1998}}

Parameter 1 can be: web, news, book, or journal. Because the author-link parameters are not supported, wikilinks must be hand-coded, such as

  • author = [[Arthur C. Clarke|A. Clarke]]

To use rare parameters, then the original full templates should be used, instead, such as using the full {{cite book}} to list editor names or show an authormask.

The parameter "pages=n" will auto-adjust to show "p." for a singular lone page number, or "pp." for a plural page-range. Parameter "page=" always shows the "p." prefix.

In articles which contain more than 300 formatted references, the speed of formatting a large article, during 2009, reached 30–60 seconds for logged-in users, so the {cite quick} template can be used to run 10x faster (3–6 seconds) when reformatting an article. Many large articles experienced similar long delays during 2009–2012, due to using numerous large templates. Also, there have been some cases where other large templates, in the same articles, have exceeded template resources, and so {cite_quick} could be used in those articles to allow hundreds more citations without exceeding the template limits.

Limited parameters supported

To allow extreme speed, only the major parameters are supported:

  • title, work, journal (or: newspaper)
  • author, author2, author3, author4
  • last, first, last1, first1, last2, first2, last3, first3, last4, first4
  • publisher, agency, location (or place), volume, issue, chapter
  • page, pages
  • url, archiveurl, archivedate, doi, isbn, issn
  • date, day, month, year, accessdate/acc, quote, notes

The following sets of parameters are not supported:

  • Not supported: ref=harv, ref=x
  • Not supported: magazine, periodical, encyclopedia, contribution
  • Not supported: authors, coauthors, author5, last5, first5 (or higher)
  • Not supported: authormask, authorlink, author-link, author1-link (or higher)
  • Not supported: editor, editor-last, editor-link, editor1, editor1-last (or higher)
  • Not supported: surname, given, surname1, given1 (or higher)
  • Not supported: series, number, version, volumename, publication-place
  • Not supported: article, edition, publication-date
  • Not supported: at, arxiv, asin, bibcode, jfm, jstor, lccn, mr
  • Not supported: oclc, ol, osti, pmc, pmid, rfc, ssrn, zbl, id, etc.
  • Not supported: postscript, laysummary, laysource, laydate
  • Not supported: episode, transcript, transcripturl

For a full description of all parameter names, see: Template:Cite_web/doc.

Examples

The operation is very similar to {{cite web}} and related templates.

For using {{Cite_quick}}:

  • Markup: {{cite quick |web |title=Study 17 of life |work=Studies Online
|volume=9 |issue=4 |p=345 |publisher=Acme |location=London |date=May 1999
| year=1999 | url=http://www.google.com | accessdate=1 June 2009}}
  Result: Template:Cite quick

Example with 3 authors, compared to {{cite journal}}:

  • Markup: {{cite quick |journal |last1=Smith |first1=Joe |last2=Doe |first2=John H.
|last3=Jones |first3=Mary |title=Growth of dawn creatures |journal=Life Journal
|publisher=Acme |year=1980 |date=June 1980 |location=London |volume=6 |issue=235
|page=2345-47 | url=http://www.science.com |accessdate=2012-07-10}}
  Result: Template:Cite quick
  • Compare: {{cite journal |last1=Smith |first1=Joe |last2=Doe |first2=John H.
|last3=Jones |first3=Mary |title=Growth of dawn creatures |journal=Life Journal
|publisher=Acme |year=1980 |date=June 1980 |location=London |volume=6 |issue=235
|page=2345-47 | url=http://www.science.com |accessdate=2012-07-10}}
  Result: Smith, Joe; Doe, John H.; Jones, Mary (June 1980). "Growth of dawn creatures". Life Journal. London: Acme. 6 (235): 2345-47. Retrieved 2012-07-10.CS1 maint: date and year (link)

See also