Difference between revisions of "Template:Fooian fooers/doc"

From blackwiki
Jump to navigation Jump to search
imported>BrownHairedGirl
(update to include Supercategory2)
imported>Vanisaac
(missed brackets)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE---->
 
<!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE---->
Displays standardized category navigation for occupations and nationalities, required by [[Wikipedia:Naming conventions (categories)#Occupation]].
+
Displays standardized category navigation for occupations and nationalities, required by [[Wikipedia:Category names#Occupation]].
 +
 
 +
This template should be avoided on categories not diffused by nationality, e.g. ''Arab'', ''Bengali'', ''Carniolan'', ''Guadeloupean fooers''. Note that geographic categories should in general use the ''People from Foo'' format, as required by [[Wikipedia:Category names#Residence]].
  
 
==Usage==
 
==Usage==
Line 51: Line 53:
 
{{csdoc|usage vertical end}}
 
{{csdoc|usage vertical end}}
  
=== Categories ===
+
== Categories ==
 
Adds a pair of standard parent categories:
 
Adds a pair of standard parent categories:
 
*<nowiki>[[</nowiki>Category:'''Nationality''' people by occupation|'''Profession'''<nowiki>]]</nowiki>
 
*<nowiki>[[</nowiki>Category:'''Nationality''' people by occupation|'''Profession'''<nowiki>]]</nowiki>
Line 65: Line 67:
 
*<nowiki>[[</nowiki>Category:'''Supercategory2''' by nationality|'''Nationality'''<nowiki>]]</nowiki>
 
*<nowiki>[[</nowiki>Category:'''Supercategory2''' by nationality|'''Nationality'''<nowiki>]]</nowiki>
  
====Self-checking====
+
===Self-checking===
 
The template tests for the existence of <nowiki>[[</nowiki>Category:'''Profession''' by nationality<nowiki>]]</nowiki> or  <nowiki>[[</nowiki>Category:'''Supercategory''' by nationality<nowiki>]]</nowiki> or <nowiki>[[</nowiki>Category:'''Supercategory2''' by nationality<nowiki>]]</nowiki>, and alters its output as follows:
 
The template tests for the existence of <nowiki>[[</nowiki>Category:'''Profession''' by nationality<nowiki>]]</nowiki> or  <nowiki>[[</nowiki>Category:'''Supercategory''' by nationality<nowiki>]]</nowiki> or <nowiki>[[</nowiki>Category:'''Supercategory2''' by nationality<nowiki>]]</nowiki>, and alters its output as follows:
  
Line 72: Line 74:
 
#When ''neither'' the "Supercategory" or "Supercategory2" parameters supplied, the template tests for the existence of <nowiki>[[</nowiki>Category:'''Profession''' by nationality<nowiki>]]</nowiki>. If that does not exist, then <nowiki>[[</nowiki>Category:'''Profession'''<nowiki>]]</nowiki> will be used instead)
 
#When ''neither'' the "Supercategory" or "Supercategory2" parameters supplied, the template tests for the existence of <nowiki>[[</nowiki>Category:'''Profession''' by nationality<nowiki>]]</nowiki>. If that does not exist, then <nowiki>[[</nowiki>Category:'''Profession'''<nowiki>]]</nowiki> will be used instead)
  
===Examples===
+
==Examples==
 
Example from [[:Category:American writers]]:
 
Example from [[:Category:American writers]]:
 
:<code><nowiki>{{Fooian fooers |Profession=Writers |Nationality=American |Country=United States}}</nowiki></code>
 
:<code><nowiki>{{Fooian fooers |Profession=Writers |Nationality=American |Country=United States}}</nowiki></code>
  
==== Supercategory ====
+
== Supercategory ==
 
The <code>Supercategory</code> parameter allows another category to be added between the "nationality people by occupation" and this occupation category. This for occupations which are a subset of another ocupation.
 
The <code>Supercategory</code> parameter allows another category to be added between the "nationality people by occupation" and this occupation category. This for occupations which are a subset of another ocupation.
  
Line 88: Line 90:
 
:<code><nowiki>{{Fooian fooers |Profession=civil engineers |Nationality=German |Country=Germany |Supercategory=engineers}}</nowiki></code>
 
:<code><nowiki>{{Fooian fooers |Profession=civil engineers |Nationality=German |Country=Germany |Supercategory=engineers}}</nowiki></code>
  
==== Supercategory2 ====
+
== Supercategory2 ==
 
The <code>Supercategory2</code> parameter is for use when an occupation is an intersection of two other occupations.
 
The <code>Supercategory2</code> parameter is for use when an occupation is an intersection of two other occupations.
  
 
Example from [[:Category:British film score composers]]:
 
Example from [[:Category:British film score composers]]:
:<code><nowiki>{{fooian fooers| | Profession=Film score composers | Nationality=British | Supercategory=film people | Supercategory2=composers | Country = United Kingdom}}</nowiki></code>
+
:<code><nowiki>{{fooian fooers |Profession=Film score composers |Nationality=British |Supercategory=film people |Supercategory2=composers |Country=United Kingdom}}</nowiki></code>
  
 
Example from [[:Category:Irish magazine editors]]:
 
Example from [[:Category:Irish magazine editors]]:
:<code><nowiki>{{Fooian fooers | Profession=magazine editors | Nationality=Irish | Country=Ireland | Supercategory=editors | Supercategory2=magazine people}}</nowiki></code>
+
:<code><nowiki>{{Fooian fooers |Profession=magazine editors |Nationality=Irish |Country=Ireland |Supercategory=editors |Supercategory2=magazine people}}</nowiki></code>
  
=== Substitution ===
+
== Substitution ==
 
In most cases, '''should not be substituted.'''
 
In most cases, '''should not be substituted.'''
  
Line 104: Line 106:
 
In other instances, the template may be substituted and edited in place.
 
In other instances, the template may be substituted and edited in place.
  
===See also===
+
==See also==
 
*[[Template:Fooian biologist types]]
 
*[[Template:Fooian biologist types]]
 
*[[Template:Fooian scientist types]]
 
*[[Template:Fooian scientist types]]
 +
*[[Template:Fooers from Boo]]
 
*[[Template:Fooers from Northern Ireland]]
 
*[[Template:Fooers from Northern Ireland]]
 +
*[[Template:Political office-holders in Foo]]
 +
*
  
<includeonly>
+
<includeonly>{{Sandbox other||
  
 
<!----CATEGORIES BELOW THIS LINE, PLEASE:---->
 
<!----CATEGORIES BELOW THIS LINE, PLEASE:---->
{{#ifeq:{{SUBPAGENAME}}|sandbox | |
+
 
 
[[Category:Wikipedia classification templates]]
 
[[Category:Wikipedia classification templates]]
  
Line 120: Line 125:
 
[[sl:Predloga:N-jevski n-jevci]]
 
[[sl:Predloga:N-jevski n-jevci]]
 
[[sr:Шаблон:Кат занимање]]
 
[[sr:Шаблон:Кат занимање]]
}}
+
 
</includeonly>
+
}}</includeonly>

Latest revision as of 04:58, 25 April 2020

Displays standardized category navigation for occupations and nationalities, required by Wikipedia:Category names#Occupation.

This template should be avoided on categories not diffused by nationality, e.g. Arab, Bengali, Carniolan, Guadeloupean fooers. Note that geographic categories should in general use the People from Foo format, as required by Wikipedia:Category names#Residence.

Usage

Most commonly used parameters in horizontal format

Simplest case {Fooian fooers |Profession= |Nationality= |Country= }}

For a profession which is a subset of another profession {Fooian fooers |Profession= |Nationality= |Country= |Supercategory= }}

For a profession which is an intersection of two other professions {Fooian fooers |Profession= |Nationality= |Country= |Supercategory= |Supercategory2= }}

All parameters, vertical format
{{Fooian fooers
 | Profession = 
 | Nationality = 
 | Country = 
 | Supercategory = 
 | Supercategory2 = 
}}


Full parameter set in vertical format
Vertical list Prerequisites Brief instructions / notes
{Fooian fooers
 | Profession           = 
 | Nationality          = 
 | Country              = 
 | Supercategory        = 
 | Supercategory2       = 
}}
 
Required
Required
Required
Optional
Optional
 
 
The occupation, e.g. "film score composers"
The nationality, for example "Irish"
The country, for example "Ireland"
An occupation of which this is a sub-category, e.g. "film people"
Another occupation of which this is a sub-category, e.g. "composers"
 
  • If a field name is listed in the Prerequisites column, it is a prerequisite for the field to the left.

Categories

Adds a pair of standard parent categories:

  • [[Category:Nationality people by occupation|Profession]]
  • [[Category:Profession by nationality|Nationality]]

If the "Supercategory" parameter is used, the following categories will be generated instead:

  • [[Category:Nationality people by occupation|Profession]]
  • [[Category:Supercategory by nationality|Nationality]]

If the "Supercategory2" parameter is also used, the following categories will be generated instead:

  • [[Category:Nationality people by occupation|Profession]]
  • [[Category:Supercategory by nationality|Nationality]]
  • [[Category:Supercategory2 by nationality|Nationality]]

Self-checking

The template tests for the existence of [[Category:Profession by nationality]] or [[Category:Supercategory by nationality]] or [[Category:Supercategory2 by nationality]], and alters its output as follows:

  1. If the "Supercategory" parameter is supplied, but [[Category:Supercategory by nationality]] does not exist, then [[Category:Supercategory]] will be used instead)
  2. If the "Supercategory" and "Supercategory2" parameters are both supplied, but neither [[Category:Supercategory by nationality]] nor [[Category:Supercategory2 by nationality]] exists, then [[Category:Supercategory]] will be used instead)
  3. When neither the "Supercategory" or "Supercategory2" parameters supplied, the template tests for the existence of [[Category:Profession by nationality]]. If that does not exist, then [[Category:Profession]] will be used instead)

Examples

Example from Category:American writers:

{{Fooian fooers |Profession=Writers |Nationality=American |Country=United States}}

Supercategory

The Supercategory parameter allows another category to be added between the "nationality people by occupation" and this occupation category. This for occupations which are a subset of another ocupation.

Example from Category:American diarists:

{{Fooian fooers |Profession=Diarists |Supercategory=Writers |Nationality=American |Country=United States}}

Example from Category:Irish autobiographers:

{{Fooian fooers |Profession=Autobiographers |Nationality=Irish | Country=Ireland |Supercategory=Biographers}}

Example from Category:German civil engineers:

{{Fooian fooers |Profession=civil engineers |Nationality=German |Country=Germany |Supercategory=engineers}}

Supercategory2

The Supercategory2 parameter is for use when an occupation is an intersection of two other occupations.

Example from Category:British film score composers:

{{fooian fooers |Profession=Film score composers |Nationality=British |Supercategory=film people |Supercategory2=composers |Country=United Kingdom}}

Example from Category:Irish magazine editors:

{{Fooian fooers |Profession=magazine editors |Nationality=Irish |Country=Ireland |Supercategory=editors |Supercategory2=magazine people}}

Substitution

In most cases, should not be substituted.

Please note that this template may need to be modified for some categories, because some nationalities are listed as "People of Foo" instead of "Fooian". One such case is Northern Ireland: see {{Fooers from Northern Ireland}}

In other instances, the template may be substituted and edited in place.

See also