Wikipedia:Instruments/Adding

From Wikipedia, the free encyclopedia

This instruction page needs to be updated. Parts of this page are no longer up to date. Please update it to reflect the current state of the userbox system for musical instruments, and remove this template when finished.

This page describes how to add new instruments to the User instruments hierarchy. On August 31, 2005, CyberSkull made some nice contributions to the Babel project by creating templates that make it easier to add languages. But since they (necessarily) use categories specific to languages, they are unsuitable for categorizing instrumental skill, which is what Category:User instruments is all about. For this reason, suitable templates were created for the User instruments subhierarchy.

In order to create new instrument categories, things are a little easier than they were before these templates were created, although unfortunately there is no shortcut for creating all the category and template pages; a bot is still needed to make things that easy. Anyway, examples of code follow; they are given for organ, since they demonstrate the code fairly well. Please note: To get everything that should exist for a given instrument, you must create ten (10) pages, consisting of five (5) categories and five (5) templates. If you are going to add an instrument, please finish the job.

Contents 1 The creation process 1.1 The main category 1.2 The level-specific subcategories 1.3 The nonspecific template 1.4 The level-specific templates 2 Adding instrument tags to your user page

[edit] The creation process

[edit] The main category

{{subst:user instrument category|
| instrument-code = org
| instrument-name = [[organ (music)|organ]]
}}

(There are other things in the above template and others, such as {{CategoryTOC}} not shown here for economy.)

• instrument-code is what appears on the left-hand side of the tag, as shown above.
• instrument-name is the name of the instrument, linked to the appropriate article. Don't forget to check to make sure you have the correct article. Most instrument names refer to the instrument article, but 'organ' is ambiguous enough to require ' (music)'.

[edit] The level-specific subcategories

There should be a total of four categories under the main category.

{{subst:user instrument subcategory|
| instrument-code = org
| instrument-cat-code = organ
| instrument-name = [[organ (music)|organ]]
| level = 1
}}

• instrument-cat-code is the name used in the categories; it is necessary because some categories (like this one) are named differently from the Babel code.
• level is the skill level to which this subcategory corresponds (1, 2, 3, or 4).

[edit] The nonspecific template

This one allows a user to say that s/he plays an instrument without specifying the skill level. The example below goes in {{User org}}. The part after "User " must match that given as template-code in the categories.

{{subst:user instrument-gen|
| instrument-code = org
| instrument-cat-code = organ
| instrument-name = organ
}}

Note that instrument-name is not linked here; it will automatically be made a link to the main category. (It may be different from the category name.)

[edit] The level-specific templates

There should be a total of four level-specific templates. Their names must be based on template-code as given to the categories. For instance, this example is in a template named 'User org-2'.

{{subst:user instrument|
| instrument-code = org
| instrument-cat-code = organ
| ist = organist
| level = 2
}}

ist is whatever word or phrase refers to a person who plays the instrument, e.g. pianist, trumpeter, etc.

[edit] Adding instrument tags to your user page

The instrument tags can be added to your Babel box very much like the language tags. See Wikipedia:Babel for instructions on creating the box. The code to use is based on the name of the template; while the Babel project maintains excellent consistency between the category names and template names (e.g. 'Category:en-3' and 'Template:User en-3'), the same is not true of the instruments. Look in the category corresponding to the instrument and skill level you want; you should see a similarly named template listed, such as 'Template:User piano' or 'Template:User org-2'. Just take the part after 'Template:User ': that's the code you give to the Babel template.

Example:

{{babel-3|en|piano|org-2}}

This would result in three tags: an en-N tag for English as a native speaker, a non-skill level-specific piano tag, and a org-2 tag for organ at an intermediate level.

There is also a separate box available for listing your instruments if you feel the Babel box should be reserved for languages only. Check Wikipedia:Instruments. That page tells how to use it. It also has a somewhat out-of-date listing of the instrument categories.