User:Kotniski/Catdesc/doc

This template serves as a universal descriptor for categories. It is currently under construction, and its behaviour is not guaranteed to remain unchanged.

Purpose
The template is designed to be used on category pages. The output it produces consists of two parts. The first part has information addressed to readers (what the category contains, links to related categories, other customized text or links, link to the categories FAQ). The second part contains more technical information addressed chiefly to editors, placed in a collapsible box.

The template also places the current page in the specified parent categories, so there is no need for separate parent category declarations outside the template.

Parameters with information for readers
This parameter defines the type of category (see WP:Categorization). It can take the values list, topic, list-and-topic, intermediate, project, universal. Defaults to list if omitted. (Required parameter, but "content=" may be omitted.) This defines the category's subject. The output depends on the value of type:
 * type
 * content
 *   (or   ) produces:
 * This list category contains Wikipedia articles about species of owl.


 *   produces:
 * This topic category contains Wikipedia articles on subjects related to owls.


 *   produces:
 * This list-and-topic category contains Wikipedia articles about owls, including articles related to that general subject.


 *   produces:
 * This intermediate category contains categories of owls, organized by country.


 *   produces:
 * This project category contains templates] for [[owls.


 *   produces
 * This universal category contains Wikipedia articles about owls. To see these pages organized into subcategories, see Category:Owls.

(Required if type=universal; otherwise not used.) The corresponding main (structured) category (see example above). May take the value here (if eponymous categories corresponding to the members of the present category appear there as well), or other text indicating where such categories can be found (this will be linked automatically if it's a category name). Defines where a corresponding list can be found (will be linked automatically if an article name). Related categories. Descriptions of the respective related categories (not required, but if any omitted, then omit all). Any additional text for readers.
 * maincat
 * epon
 * list
 * rel1, ..., rel5
 * reluse1, ..., reluse5
 * more

Example
Note that this example is intended only to illlustrate the template's functionality, not recommended use.


 *  {  produces:

Subcategorization
Can take the values no (has no subcategories), full (is fully diffused into subcategories), partial (is partially diffused into subcategories), dist (has subcategories but is generally not diffused). If subc=partial, describes subcategories which are not diffusing ones. If subc=dist, describes subcategories which are diffusing ones. Text describing how subcategories are organized. Any additional text about subcategories.
 * subc
 * distsubc
 * notdistsubc
 * subby
 * submore

Parent categories
Ordinary parent categories (if defined here, then the category does not need to be placed in them separately). Sort keys for par1 etc. As above, but for parent categories of which this is a distinguished (non-diffusing) subcategory. As above, but for parent categories of which this is a subcategory only by virtue of its status as an eponymous category. Any additional text about parent categories.
 * par1, par2, ..., par6
 * key1, key2, ...
 * dpar1, ...; dkey1, ...
 * epar1, ...; ekey1, ...
 * parmore

Other information
May take the value here (if the present category has one or more stub categories as subcategories) or other text describing where relevant stubs can be found (will be linked automatically if a category name). Text about how to assign sort keys (set to standard to use standard text; you may then add extra text using sort2=). Any additional text for editors.
 * stub
 * sort
 * edmore

Category:Category namespace templates