User:Asartea/Sandbox/Module:Storm categories/doc

This template is used to control a multitude of tropical cyclone-related templates: storm colour, storm name, storm sortkey, and storm icon. It acts as a centralized location for storm categories to avoid discrepancies between templates, allowing for the same ID to be used across all related templates.

Data is located in the following submodules:
 * Module:Storm categories/categories for fully-detailed storm categories
 * Module:Storm categories/colors for color-only IDs
 * Module:Storm categories/icons for icon-only IDs

Usage
This module exports three functions for templates:,  ,  , and. It also provides,  ,  , and   for use in other modules.

All input IDs are case-insensitive, and all non-alphanumeric characters are stripped.

Color
Provides the color of the given tropical cyclone category code. This comes in the format of their raw hexadecimal code. This function is available as a template at storm colour.

Name
Provides the name of the given tropical cyclone category code. A optional basin argument can be provided as the second argument in order to slightly tweak the name of the category, if the given category definition supports it. This function is available as a template at storm name.

Sortkey
The sortkey is a number that aids in sorting categories. Using the sortkey, it is possible to automatically sort a table of tropical cyclones given their category code. Due to the ambiguous nature of sortkeys, tables may be sorted incorrectly if values from other basins were used. For categories that span multiple basins, however, (e.g.  and  ) they are given the lowest possible sortkeys in order to achieve maximum compatibility.

The sortkey format is as follows. Note that not all values between the given ranges were used. The arrangement of these were determined by their positions in the Storm colour template.

A demonstration of a sortable table using these sortkeys can be found below. Note that it does not use categories outside of its own basin (in this case, the Atl/EPac/SAtl basin) and the global range.

Icon
Icons exist for some Storm categories for presentation purposes. This function is available as a template at storm icon. will return wikitext of an image or formatted text.

Full list of available values
The following table is generated by invoking the  function of this module. Some IDs are only available as colors or icons because they existed as parameters on old non-module template implementations and cannot be feasibly aliased to a specific tropical cyclone category.

It will show any color errors, including colors which aren't compliant with the minimal Web Content Accessibility Guidelines 2.0 AA color standards (see MOS:COLOR for more information).