View source for Wikipedia:Userboxes/Music/Proficiency/Adding

This page describes how to add a new instrument to [[:Category:Wikipedians by musical instrument]]. To complete the task with zero red links, you must create 5 categories and 5 templates. The following example deals with the organ.

==The main category==

Create <code>Category:Wikipedian ''ist''</code>, replacing ''ist'' with the name that is used to refer to people who play the specific instrument. See [[:Category:Wikipedians by musical instrument]] for previous naming conventions. Insert code in the following format, changing the two parameter values:

<pre>{{user instrument category
| instrument-code = org
| instrument-name = [[organ (music)|organ]]
}}</pre>

* <code>instrument-code</code> is the abbreviation that appears on the left side of the userbox. Please try to avoid using instrument codes which should be used for a language under the [[ISO 639]] designation system. The language system should take precedence over spin-off systems where code clashes are likely to occur.
* <code>instrument-name</code> is the name of the instrument, linked to the article about the instrument.

The following will appear at the top of the category: a box and an alphabetical [[Template:CategoryTOC|table of contents]]:

{{user blank|org|These users play the '''[[organ (music)|organ]]'''.}}
{{-}}
{{CategoryTOC}}

==4 level-specific subcategories==

In the previous step, you created <code>Category:Wikipedian ''ist''</code>. Now, create the following 4 subcategories:

* <code>Category:Wikipedian ''ist''-1</code>
* <code>Category:Wikipedian ''ist''-2</code>
* <code>Category:Wikipedian ''ist''-3</code>
* <code>Category:Wikipedian ''ist''-4</code>

For the first subcategory, insert the following code, replacing the parameter values as in the first step:

<pre>{{user instrument subcategory
| instrument-code = org
| instrument-name = [[organ (music)|organ]]
| ist = organist
| level = 1
}}</pre>

* <code>ist</code> is in singular form here.
* <code>level</code> is the skill level, one of 1, 2, 3, or 4. All 4 subcategories have the exact same code except for their <code>level</code>.

After creation, this box will appear in the subcategory:

{{user blank-1|org|These users play the '''[[organ (music)|organ]]''' at a '''[[:Category:Wikipedian organists-1|novice]]''' level.}}
{{-}}

==4 level-specific templates==

For each of the subcategories that you've just made, create the corresponding templates at the following locations:

* <code>Template:User ''<code>ist</code>''-1</code>
* <code>Template:User ''<code>ist</code>''-2</code>
* <code>Template:User ''<code>ist</code>''-3</code>
* <code>Template:User ''<code>ist</code>''-4</code>

The code is the almost same as above:

<pre>{{user instrument
| instrument-code = [[organ (music)|org]]
| ist = organist
| level = 1
}}</pre>

This is what the userbox will look like when people put them on their user pages.

{{user blank-1|[[organ (music)|org]]|This user is a '''[[:Category:Wikipedian organists-1|novice]] [[:Category:Wikipedian organists|organist]]'''.}}
{{-}}

==The general template==

This final template allows a user to say that he or she plays an instrument without specifying the skill level. Create it at Template:User ''ist''.

<pre>{{user instrument-gen
| instrument-code = organ
| instrument-name = organ
| instrument-link = organ (instrument)
| ist = organist
}}</pre>

{{user instrument-gen
| instrument-code = organ
| instrument-name = organ
| instrument-link = organ (instrument)
| ist = organist
| category =
}}
{{-}}

==Spread the word==

People can now use these templates. To make them known, list them at [[Wikipedia:Instruments]] using {{tl|Instrument}}.

==See also==
{{Wikipedia:Userboxes/footer}}

[[Category:Userbox galleries|Music/Instruments/Adding]]