Difference between revisions of "Template:BDMag/doc"
imported>SMcCandlish (tweak) |
imported>SMcCandlish (not really complicated) |
||
| Line 19: | Line 19: | ||
<nowiki>}}</nowiki></code> | <nowiki>}}</nowiki></code> | ||
| − | The template uses the same (relevant) parameter names as {{tl|Cite journal}}. '''The <code>title</code>, <code>month</code> and <code>year</code> parameters are ''required''.''' If <code>accessdate</code> is not specified, today's date will be used. If the cited item is a regular feature (such as a mini-column), use the feature's name as the title, e.g. <code>title=Calendar</code>. If the feature has no by-line, simply omit the <code>first</code> and <code>last</code> parameters, use the last name of the managing editor, and first name of the managing editor followed by "(ed.)". This template '''does not''' use the <code>author</code> parameter; use <code>first</code> and <code>last</code>. The volume and issue are complicated to figure | + | The template uses the same (relevant) parameter names as {{tl|Cite journal}}. '''The <code>title</code>, <code>month</code> and <code>year</code> parameters are ''required''.''' If <code>accessdate</code> is not specified, today's date will be used. If the cited item is a regular feature (such as a mini-column), use the feature's name as the title, e.g. <code>title=Calendar</code>. If the feature has no by-line, simply omit the <code>first</code> and <code>last</code> parameters, use the last name of the managing editor, and first name of the managing editor followed by "(ed.)". This template '''does not''' use the <code>author</code> parameter; use <code>first</code> and <code>last</code>. The volume and issue are slightly complicated to figure out if you don't have the issue on hand any longer. The issue number is the number of the month +1, from January to November, and is "1" for Decemeber, ever since ''BD'' went monthly, many years ago. New Volumes begin in Decemeber. (e.g. July = issue 8), and Dec. 2009 through Nov. 2010 is volume 32 (ergo most of 1999 is vol. 21, and most of 2015 will be vol. 37). |
'''This template cannot be [[Wikipedia:Template substitution|subst]]'d, unless this is done before it is put inside <code><nowiki><ref...></ref></nowiki></code>''' (due to a bug in the <nowiki><ref> and <references /></nowiki> system). There is no particular reason to subst it anyway. | '''This template cannot be [[Wikipedia:Template substitution|subst]]'d, unless this is done before it is put inside <code><nowiki><ref...></ref></nowiki></code>''' (due to a bug in the <nowiki><ref> and <references /></nowiki> system). There is no particular reason to subst it anyway. | ||
Revision as of 03:10, 23 November 2011
| This is a documentation subpage for Template:BDMag. It contains usage information, categories and other content that is not part of the original template page. |
Purpose
This template is for creating a properly-formatted reference citation to articles in Billiards Digest magazine, frequently cited in cue sports articles (see WikiProject Cue sports for more information). It is almost always used inside <ref name="BDMag YYYY-XX"></ref> (with the date). The benefit of the template is that it automatically provides the publisher, issn, location, and journal parameters of {{Cite journal}} for you.
Usage
{{BDMag
|title=
|month=
|year=
|url=
|volume=
|issue=
|pages=
|first=
|last=
|accessdate=
}}
The template uses the same (relevant) parameter names as {{Cite journal}}. The title, month and year parameters are required. If accessdate is not specified, today's date will be used. If the cited item is a regular feature (such as a mini-column), use the feature's name as the title, e.g. title=Calendar. If the feature has no by-line, simply omit the first and last parameters, use the last name of the managing editor, and first name of the managing editor followed by "(ed.)". This template does not use the author parameter; use first and last. The volume and issue are slightly complicated to figure out if you don't have the issue on hand any longer. The issue number is the number of the month +1, from January to November, and is "1" for Decemeber, ever since BD went monthly, many years ago. New Volumes begin in Decemeber. (e.g. July = issue 8), and Dec. 2009 through Nov. 2010 is volume 32 (ergo most of 1999 is vol. 21, and most of 2015 will be vol. 37).
This template cannot be subst'd, unless this is done before it is put inside <ref...></ref> (due to a bug in the <ref> and <references /> system). There is no particular reason to subst it anyway.
If you need to cite the same source in the same article more than once, use <ref name="BDMag YYYY-XX">" /> for the subsequent citations. See {{rp}} if a page number is needed in subsequent citations.
If only one page or page range needs to be cited in this source in the article, simply add the page number(s) with the pages parameter (with "p." or "pp.").
The url parameter of {{Cite journal}} is supported, and can be used to link to specific issues, but these online copies are only available by subscription, and adding the URL parameter will also automatically add a note that a subscription is required. For free BilliardsDigest.com material such as their "Headstring News" feed, use {{Cite web}} instead of this template.
Example
Article text.<ref name="BDMag 2008-02">{{BDMag|title=Fisher Shows Closing Speed|year=2008|month=February|last=Leider|first=Nicholas|volume=30|issue=3|pages=pp. 54–55}}</ref>
Produces:
Article text.[1]
...
- References