Template:Drinkboy recipe/doc

Drinkboy recipe: Mixed Drinks WikiProject link to DrinkBoy.com Recipes

Drinkboy recipe is used to generate a standardized link to mixed drink recipes at DrinkBoy.com. DrinkBoy has been reviewed by participants of the Mixed Drinks WikiProject and several other editors at Wikipedia, and has been found to be a reliable mixed drink resource, with minimal commercial advertising.

For template or usage questions, contact Willscrlt (recent esoteric enhancements) or GeoffCapp (original template developer).

Purpose
This template should be used exclusively for mixed drink articles (i.e., cocktails), since it only links to the cocktails portion of the site. If other WikiProjects would find it useful to extend this template to include links to the Liquor, Tools, or Bars section of the site, please discuss it on this template's talk page.

By using this template instead of manually coding a link to DrinkBoy's site, it will be easy to update all pages linking to DrinkBoy if the DrinkBoy.com site ever changes its site in a way that would normally break such links. If that happens, one change to this template should update all the links throughout Wikipedia at once.

It is important that the template is transcluded into the article, rather than substed in. Substituting breaks the dynamic connection to the template, and such pages will no longer dynamically update.

Usage

 * Go to DrinkBoy and locate the cocktail to which you wish to link.
 * Click on the link to go to the cocktail's page.
 * The page URL should look like, where "DRINKNAME" indicates the name of the drink.
 * Copy ONLY the name portion of the URL indicated by DRINKNAME above (be sure to leave out the trailing ".html").
 * If one does not already exist, add a section named "External links" near the bottom of the wiki article.
 * Add the following text to the external links section as shown:
 * The asterisk (*) is to make the link be part of a bulleted list (since it's part of the list of external links).
 * "DRINKNAME" is the name you've copied from the DrinkBoy URL. The link attribute is required.
 * "PRETTY NAME" is the cocktail's name for display in the external link.
 * If both the link and name attributes are the identical, the name parameter may be omitted and will default to the link attribute's value if omitted (or the name of the article if both are omitted).

categories
By default, any article that uses this template is presumed to be a mixed-drink related article (otherwise use of this template in the article should be avoided). So, the article is automagically categorized under, which helps to alert Project Participants to the existence of the article.

This attribute is a somewhat "hidden" feature that allows demonstrating this template in places where the automagical categorization is undesirable. Any value other than no is ignored and the category will be generated. If set to no the template will display as normal, but the category will be suppressed.

info
Another somewhat "hidden" feature of this template is the automatic inclusion of the words "Information from the " prefixed to the output of this template. This is primarily for use within the WPMIXInfobox when the standardized recipe information used comes from DrinkBoy. In the External links section and most other places, this would be undesirable.

The categories are automatically suppressed with this option, since the infobox adds the category, and it is silly to do so twice.

Examples
Searching for "Singapore Sling", you'll reach the page: http://www.drinkboy.com/cocktails/recipes/SingaporeSling.html

Copy "SingaporeSling" from the URL and then add the following to External links in the Singapore Sling article:
 * The result is:
 * Note that in this example, the URL link at DrinkBoy does not contain a space, and in the pretty name we include one.
 * Note that in this example, the URL link at DrinkBoy does not contain a space, and in the pretty name we include one.

Searching for "Daiquiri", you'll reach the page: http://www.drinkboy.com/cocktails/recipes/Daiquiri.html

Copy "Daiquiri" from the URL and then add the following to External links in the Daiquiri article:
 * The result is:
 * Since Daiquiri is the same in the URL link and the pretty name, the pretty name may be omitted.
 * Since Daiquiri is the same in the URL link and the pretty name, the pretty name may be omitted.

If the template is used without the required link attribute, the template will do it's best to generate a usable link by filling in the article's title:
 * The result is:
 * Obviously on this page, this is not the desirable output. Similar results can occur if the article is moved or renamed, and usage in such cases will likely result in invalid links.
 * The template defaults to this behavior only because that is how the template was originally designed, and many articles rely upon that funcationality.
 * Missing links will result in the article being categorized under unless categories are suppressed.
 * Missing links will result in the article being categorized under unless categories are suppressed.

Template

 * The generic template is displayed below.