Lihimi Tɛmplet:Fooian fooers/doc ni yi shɛli na

{{Documentation subpage}}
<!----PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE---->
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==
=== Sovereign nationalities ===

{{csdoc|usage common}}
'''Simplest case'''
<code><nowiki>{{Fooian fooers |Profession= |Nationality= |Country= }}</nowiki></code>

'''For a profession which is a subset of another profession'''
<code><nowiki>{{Fooian fooers |Profession= |Nationality= |Country= |Supercategory= }}</nowiki></code>

'''For a profession which is an intersection of two other professions'''
<code><nowiki>{{Fooian fooers |Profession= |Nationality= |Country= |Supercategory= |Supercategory2= }}</nowiki></code>
{{end}}

=== Non-sovereign nationalities ===
For colonies, protectorates, constituent countries, overseas territories etc:
<code><nowiki>{{Fooian fooers |Profession= |Nationality= |Country= |ParentCountry= | ParentNationality= }}</nowiki></code>

;All parameters, vertical format:
{{Fooian fooers/doc/parameterlist}}

{{csdoc|usage vertical}}
<pre style="margin:0px;">
{{Fooian fooers
 | Profession     = 
 | Nationality    = 
 | Country        = 
 | Supercategory  = 
 | Supercategory2 = 
 | ParentCountry  =
 | ParentNationality =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
Required
Required
Required
Optional
Optional
Optional
Optional
&nbsp;
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
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"
The parent country of which this is a territory, e.g. "France" 
The parent nationality, e.g. "French"
&nbsp;
</pre>
{{csdoc|usage vertical end}}

== Categories ==
Adds a pair of standard parent categories:
*<nowiki>[[</nowiki>Category:'''Nationality''' people by occupation|'''Profession'''<nowiki>]]</nowiki>
*<nowiki>[[</nowiki>Category:'''Profession''' by nationality|'''Nationality'''<nowiki>]]</nowiki>

If the "Supercategory" parameter is used, the following categories will be generated instead:
*<nowiki>[[</nowiki>Category:'''Nationality''' people by occupation|'''Profession'''<nowiki>]]</nowiki>
*<nowiki>[[</nowiki>Category:'''Supercategory''' by nationality|'''Nationality'''<nowiki>]]</nowiki>

If the "Supercategory2" parameter is also used, the following categories will be generated instead:
*<nowiki>[[</nowiki>Category:'''Nationality''' people by occupation|'''Profession'''<nowiki>]]</nowiki>
*<nowiki>[[</nowiki>Category:'''Supercategory''' by nationality|'''Nationality'''<nowiki>]]</nowiki>
*<nowiki>[[</nowiki>Category:'''Supercategory2''' by nationality|'''Nationality'''<nowiki>]]</nowiki>

===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:

#If the "Supercategory" parameter is supplied, but <nowiki>[[</nowiki>Category:'''Supercategory''' by nationality<nowiki>]]</nowiki> does not exist, then <nowiki>[[</nowiki>Category:'''Supercategory'''<nowiki>]]</nowiki> will be used instead)
#If the "Supercategory"  and "Supercategory2" parameters are ''both'' supplied, but ''neither'' <nowiki>[[</nowiki>Category:'''Supercategory''' by nationality<nowiki>]]</nowiki> nor <nowiki>[[</nowiki>Category:'''Supercategory2''' by nationality<nowiki>]]</nowiki> exists, then <nowiki>[[</nowiki>Category:'''Supercategory'''<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==
Example from [[:Category:American writers]]:
:<code><nowiki>{{Fooian fooers |Profession=Writers |Nationality=American |Country=United States}}</nowiki></code>

== 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.

Example from [[:Category:American diarists]]:
:<code><nowiki>{{Fooian fooers |Profession=Diarists  |Supercategory=Writers |Nationality=American |Country=United States}}</nowiki></code>

Example from [[:Category:Irish autobiographers]]:
:<code><nowiki>{{Fooian fooers |Profession=Autobiographers |Nationality=Irish | Country=Ireland |Supercategory=Biographers}}</nowiki></code>

Example from [[:Category:German civil engineers]]:
:<code><nowiki>{{Fooian fooers |Profession=civil engineers |Nationality=German |Country=Germany |Supercategory=engineers}}</nowiki></code>

== Supercategory2 ==
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]]:
:<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]]:
:<code><nowiki>{{Fooian fooers |Profession=magazine editors |Nationality=Irish |Country=Ireland |Supercategory=editors |Supercategory2=magazine people}}</nowiki></code>

== Modifications ==
In most cases, '''should not be substituted.'''

Please note that this template needs to be modified for some categories. Some nationalities are listed as "People from Foo" instead of "Fooian". One such case is Northern Ireland, for which there is a specialised template {{tl|Fooers from Northern Ireland}}. Other cases such as {{c|People from Georgia (country)}} should use {{tl|Fooers from Boo}}.

The template is also able to resolve redirects where required. The profession usually has to be converted to lowercase when used after a nationality, but this generates an incorrect parent for cases that require a capital letter; e.g. the template on [[:Category:Scottish Shakespearean actors]] generates lowercase [[:Category:British shakespearean actors]] for the parent nationality. The easiest workaround is to place a category redirect page at [[:Category:British shakespearean actors]], and then the template resolves this to the correct target [[:Category:British Shakespearean actors]]. 

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

==See also==
*[[Template:Fooian biologist types]]
*[[Template:Fooian scientist types]]
*[[Template:Fooers from Boo]]
*[[Template:Fooers from Northern Ireland]]
*[[Template:Political office-holders in Foo]]
*

<includeonly>{{Sandbox other||

<!----CATEGORIES BELOW THIS LINE, PLEASE:---->

[[Category:Wikipedia classification templates]]

[[bn:টেমপ্লেট:Fooian fooers]] 
[[gv:Clowan:Foodeyryn Fooagh]]
[[mk:Шаблон:Кат занимање]]
[[sl:Predloga:N-jevski n-jevci]]
[[sr:Шаблон:Кат занимање]]

}}</includeonly>