View source for Template:BDMag/doc

{{Documentation subpage}}
{{cs1 wrapper |type=source |base=cite news}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS 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 [[Wikipedia:WikiProject Cue sports|WikiProject Cue sports]] for more information). It is almost always used inside <code><nowiki><ref name="BDMag </nowiki>{{var|YYYY-XX}}<nowiki>"></ref></nowiki></code> (with the date). The benefit of the template is that it automatically provides the <code>publisher</code>, <code>issn</code>, <code>location</code>, and <code>journal</code> parameters of {{tl|Cite journal}} for you.

==Usage==
<code><nowiki>{{</nowiki>BDMag<br />
'''|title='''<br />
|date=<br />
|url=<br />
|volume=<br />
|issue=<br />
|pages=<br />
|first=<br />
|last=<br />
|access-date=<br />
<nowiki>}}</nowiki></code>

The template uses the same (relevant) parameter names as {{tl|Cite journal}}. {{strong|The {{para|title}} parameter is {{em|required}}.}} If the cited item is a regular feature (such as a mini-column), use the feature's name as the title, e.g. {{para|title|Calendar}}. If the feature has no by-line, simply omit the {{para|first}} and {{para|last}} parameters, use the last name of the managing editor, and first name of the managing editor followed by "(ed.)". 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 December, ever since ''BD'' went monthly, many years ago. New Volumes begin in December. (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).

The <code>url</code> parameter of {{tl|Cite journal}} is supported, and can be used to link to specific issues, but these online copies are often available by subscription. If the article requires paid subscription, add the {{para|pay|y}} parameter to add a note that a subscription is required. (Do not use "{{para|pay|n}}" to indicate free content; that won't work). and adding the URL parameter will also automatically. For free ''BilliardsDigest.com'' material such as their "Headstring News" feed, use {{tl|Cite web}} instead of this template, which is for the magazine (and online copies thereof).

If you need to cite the same source in the same article more than once, use <code><nowiki><ref name="BDMag </nowiki>{{var|YYYY-XX}}<nowiki>" /></nowiki></code> for the subsequent citations. See {{tl|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 <code>page</code> or <code>pages</code> parameter, as appropriate ({{em|without}} "p." or "pp.").

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 {{xtag|ref}} and {{xtag|references|s}} system). There is no particular reason to subst it anyway.


===Example===
<code>Article text.<nowiki><ref name="BDMag 2008-02">{{BDMag|title=Fisher Shows Closing Speed|date=February 2008|last=Leider|first=Nicholas|volume=30|issue=3|pages=54&amp;ndash;55}}</ref></nowiki></code>

Produces:

Article text.<ref name="BDMag 2008-02">{{BDMag|title=Fisher Shows Closing Speed|date=February 2008|last=Leider|first=Nicholas|volume=30|issue=2|pages=54&ndash;55}}</ref>

;References:
{{Reflist}}

<includeonly>{{Sandbox other||
<!-- CATEGORIES AND INTERWIKIS BELOW THIS LINE PLEASE -->
[[Category:Cue sports source templates]]
[[Category:Citation Style 1 specific-source templates]]
}}</includeonly>