Redigerer Mal:Drinkboy recipe/dok

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
<big style="font-size:140%">''Drinkboy recipe:'' '''[[WP:MIX|Mixed Drinks WikiProject]] link to DrinkBoy.com Recipes'''</big>

<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{tl|Drinkboy recipe}} is used to generate a standardized link to [[mixed drink]] recipes at [http://www.DrinkBoy.com/Cocktails/ 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 [[WP:RS|reliable]] mixed drink resource, with minimal commercial advertising.

<small>For template or usage questions, contact [[User talk:Willscrlt|Willscrlt]] (recent esoteric enhancements) or [[User talk:GeoffCapp|GeoffCapp]] (original template developer).</small>

==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 [[Template talk:Drinkboy recipe|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 [[Wikipedia:Transclusion|transcluded]] into the article, rather than '''[[WP:SUBST|subst]]'''ed in. Substituting breaks the dynamic connection to the template, and such pages will no longer dynamically update.

==Usage==
* Go to [http://www.drinkboy.com/Cocktails 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 <code><nowiki>http://www.drinkboy.com/Cocktails/Recipe.aspx?itemid=###</nowiki></code>, where "###" indicates the id number of the drink.
* Copy ONLY the id portion of the URL indicated by ### above.
* 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:
 <code><nowiki>==External links==</nowiki></code>
 <code><nowiki>* {{Drinkboy recipe|link=###|name=PRETTY NAME}}</nowiki></code>
** The asterisk (*) is to make the link be part of a bulleted list (since it's part of the list of external links).
** "###" is the number 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).

<!-- THIS PART IS NOT WORKING, IT'S CATEGORIZING ARTICLE PGS, NOT TALK PGS.
==Optional attributes==
===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 {{cl|WikiProject Mixed Drinks articles}}, 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.

 <code><nowiki>{{</nowiki>Drinkboy recipe|link=DRINKNAME|name=PRETTY NAME'''|categories=no'''<nowiki>}}</nowiki></code>

===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 {{tl|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.

 <code><nowiki>{{</nowiki>Drinkboy recipe|link=DRINKNAME|name=PRETTY NAME'''|info=yes'''<nowiki>}}</nowiki></code>
-->
==Examples==
Searching for "''Singapore Sling''", you'll reach the page: http://www.drinkboy.com/Cocktails/Recipe.aspx?itemid=151

Copy "151" from the URL and then add the following to External links in the [[Singapore Sling]] article:
 <code><nowiki>* {{</nowiki>Drinkboy recipe|link='''151'''|name='''Singapore Sling'''<nowiki>}}</nowiki></code>
: The result is:
:* {{Drinkboy recipe|link=151|name=Singapore Sling}}

Searching for "''Daiquiri''", you'll reach the page: http://www.drinkboy.com/Cocktails/Recipe.aspx?itemid=53

Copy "53" from the URL and then add the following to External links in the [[Daiquiri]] article:
 <code><nowiki>* {{</nowiki>Drinkboy recipe|link='''53'''|name='''Daiquiri'''<nowiki>}}</nowiki></code>
: The result is:
:* {{Drinkboy recipe|link=53|name=Daiquiri}}

<!-- 
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:
 <code><nowiki>* {{</nowiki>Drinkboy recipe<nowiki>}}</nowiki></code>
: The result is:
:* {{Drinkboy recipe|categories=no}}
: 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.
 -->
==Notes==
:* Missing ''link'' parameters will result in the article being categorized under {{cl|WikiProject Mixed Drinks broken template implementations}}.

<includeonly>{{Sandbox other||
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Drink external link templates|{{PAGENAME}}]]
[[Category:Drink templates|{{PAGENAME}}]]
[[Category:Beverages Task Force templates|{{PAGENAME}}]]

<!-- ADD INTERWIKIS BELOW THIS LINE -->
}}</includeonly>