Template:Women fooers from Northern Ireland/doc

Displays standardized category navigation for women by occupations from Northern Ireland, required by Naming conventions (categories).

It also makes it easy to ensure that the category is properly parented.

The category must be named "Women from Northern Ireland", e.g.
 * Category:Women novelists from Northern Ireland

Usage
See Category:Women writers from Northern Ireland
 * Example 1:

See Category:Women novelists from Northern Ireland
 * Example 2:

This template should not be substituted.

Portals
By default, this template adds links to three portals: Portal:Northern Ireland, Portal:Ireland, and Portal:Biography.

More portal links may be added using any or all of these parameters: portal, portal2, and  portal3

e.g.

Non-diffusing
By default, this template tags the categories as a non-diffusing subcategory.

In some, cases this will be inappropriate, most commonly in professions which are inherently gendered, such as singers.

To suppress non-diffusing subcategory, add the parmeter no.

Technical details
This is a variant of the widely used Template:Fooian fooers. It is for use with the sub-categories of Category:Women from Northern Ireland by occupation, which use the format "Women [profession] from Northern Ireland", rather than the standard "[Nationality] women [profession]".

Adds three standard parent categories: for (This is because all sub-cats of Category:People from Northern Ireland are parented in the equivalent sub-categories Irish people and British people. This reflects the commitment by the governments of the UK, Ireland and Northern Ireland in the Good Friday Agreement to the recognition of both national identities.)
 * +Women
 * Northern Ireland
 * Northern Ireland

If the "Supercategory" parameter is used, the following parent category will be generated added: Otherwise, this parent category will be generated:
 * Profession
 * Profession

In all cases. the template adds either: or
 * Nationality (if it exists)
 * Nationality

Self-checking
The template tests for the existence of  Category:Women Profession by nationality  or  Category:Supercategory by nationality , and alters its output as follows:


 * 1) If the "Supercategory" parameter is supplied, but Category:Women Supercategory by nationality  does not exist, then  Category:Women Supercategory  will be used instead.
 * 2) When the "Supercategory" parameter is not supplied, the template tests for the existence of Category:Women Profession by nationality  . If that does not exist, then  Category:Women Profession  will be used instead.