Template:File category/doc

This template inserts a descriptive notice at the top of the categories whose population demands insertion of certain template instead of using the ordinary category syntax.

This template is created to replace {{File template notice}} and {{category game screenshot header}}.

Usage

This category has only one mandatory parameter: the first unnamed parameter. For example:

{{File category|Non-free web screenshot}}

It alerts the reader that the category on which the example line is inserted, is to be populated by inserting {{non-free web screenshot}} in the licensing section of a file. This example is suitable for Category:Screenshots of web pages. It renders as follows:

File:Gnome-insert-image.svg

This category contains files

To place a file in this category, add the tag {{Non-free web screenshot}} to the Licensing section of the file's description page. If you are not sure which category a file belongs to, consult "OODA WIKI:File copyright tags". If this category is very large, please consider placing your file in a new or existing subcategory.

Sometimes, however, a template alone does not populate the category. For example, populating Category:Screenshots of Atari games is populated by passing a specific parameter ("Atari" in this case) to the {{Non-free video game screenshot}} template. This line changes the notification using the second unnamed parameter:

{{File category|Non-free video game screenshot|Atari}}

It generates:

File:Gnome-insert-image.svg

This category contains files

To place a file in this category, add the tag {{Non-free video game screenshot|Atari}} to the Licensing section of the file's description page. If you are not sure which category a file belongs to, consult "OODA WIKI:File copyright tags". If this category is very large, please consider placing your file in a new or existing subcategory.

This template has two additional parameters: |insert in= and |unsure action=. The first is to tell the reader to insert the code somewhere other than the Licensing section of the file description page. The second is to tell the reader what to do in case uncertainty. For example:

{{File category|Non-free software screenshot|Screenshots of Nokia mobile devices}}

...generates:

File:Gnome-insert-image.svg

This category contains files

To place a file in this category, add the tag {{Non-free software screenshot|Screenshots of Nokia mobile devices}} to the file infobox of the file's description page. If you are not sure which category a file belongs to, request assistance in OODA WIKI talk:WikiProject Software. If this category is very large, please consider placing your file in a new or existing subcategory.