Template:Software/doc

This is a documentation subpage for Template:Software.
Don't forget to purge the contents of the base page upon creating or editing this subpage.

Purge base's cache

Todo: See Template:Software/doc/draft

{{Software}} is the template that underlies the icon templates. It has 8 main parameters:

• {{{1}}} – the way the icon will be displayed.
  • Do not enter this value if you need a regular icon.
  • Enter 1 to get the name of the game with a link to an article about the game.
  • Enter 2 to get the icon and the name of the game after it.
  • Enter 3 to get the same as in the case of the number 1, but with an additional design with colored text.
  • Enter 4 to get the same as in the case of the number 2, but with an additional design with colored text.
  • Enter 3.1 or 4.1 will get the same effect as above, but without the shadow behind the text and icon.
  • Enter 3.2 or 4.2 will get the same effect as above, but with different drop shadow effect.
  • Enter "col" (without quotes) to get the color of the game. This is mainly needed for other templates.
  • Enter "in", "also", "only", "since", "removed" or "not" (without quotes) to get the icon displayed along with additional text, like "(also in <game icon>)".

Note:however, the {{{1}}} parameter cannot be touched, it should always be "{{{1}}}" in the icon templates!

• {{{ico}}} – the name of the icon is written here, but only the name itself, without "File:" and square brackets. Recommended name (example): Icon-hl2.png, Icon-Half-Life_2.png, etc...
• {{{ico size}}} - width of the icon. Should be 16px for most icons, unless it's double, like , in which case it should be 32px, or more. Experimentation may be necessary for non-square icons.

Tip:The software icon should be scaled to be in-line with the text size (using {{{ico size}}}). While this is nominally "16 pixels tall", high-DPI displays (such as Apple Retina display) will benefit from the file being higher resolutions; 32 pixels tall is generally sufficient, although any resolution can be used (MediaWiki will downscale the image automatically and only deliver the necessary resolution).

• {{{link}}} – link to the article, external links do not work. If not used, the link will use the {{{name}}} parameter.
  Write without the brackets. Underscores and spaces are interchangeable.

Tip:For Wikipedia links, prepend "Wikipedia:" to the page name (ex: Wikipedia:Gabe Newell)

• {{{name}}} – display name.
• {{{name}}} – this parameter displays an alternate name based on the {{{nt}}} parameter.

Note:it is strongly recommended to write the abbreviation of the game in the parameter {{{name0}}}, {{{name1}}}, etc... or {{{nameiPadOS}}} (if supported, in templates such as {{iOS}}.

• {{{col}}} – the color of the game. If it is not specified, just do not enter this parameter, the standard color will be used: #ADD8E6.
  It's highly recommended that you use brighter color for better readability with dark/black pages.
• {{{addtext}}} – additional text that will be written immediately after the icon. It is mainly needed to add other icons.

Note:Make sure to include "addtext={{{addtext|}}}" in the icon templates!

• {{{nt}}} – this parameter will be used in the {{{name<number>}}} parameter, some may also have {{{name<text>}}}, such as {{iOS}} and {{Mac}}.

Result

In the end, you should get something like this:

Template:Portal2

1.  
2.  
3.  
4.  
5.  
6.  
7.  
8.  
9.  
10.  
11.  
12.  

{{doc|docpage=Template:Hl2/doc}} <includeonly><onlyinclude>{{Software | {{{1}}} | ico = Icon-Portal2.png | ico size = 16px | link = Portal 2 | name = {{Autolang|Portal 2|ko=포탈 2|zh=传送门 2|zh-tw=傳送門 2}} | name0 = portal2 | namemoddir = portal2 | col = #23B1E5 | addtext = {{{addtext|}}} | nt = {{{nt|}}} }}</onlyinclude></includeonly>

Translations

Translations are handled by the {{In text}} Template.

How To Use

This is how the use of the template in articles will look like:

Code	Result
{{portal2}}
{{portal2|1}}	Portal 2
{{portal2|2}}	Portal 2
{{portal2|3}}	Portal 2
{{portal2|3.1}}	Portal 2
{{portal2|3.2}}	Portal 2
{{portal2|4}}	Portal 2
{{portal2|4.1}}	Portal 2
{{portal2|4.2}}	Portal 2
{{portal2|ico}}	Icon-Portal2.png
{{portal2|col}}	#23B1E5
{{portal2|name}}	Portal 2
{{portal2|in}}	(in )
{{portal2|only}}	(only in )
{{portal2|since}}	(in all games since )
{{portal2|not}}	(not in )
{{portal2|also|addtext= {{csgo}} {{l4d2}}}}	(also in   )

Template:Software

Summary

Aids in the creation of icon templates

Type

Metatemplate

Contributors

N/A

Creation date

04/04/2022
(04 April 2022)

Notes

N/A

Subpages

Documentation

/doc

Preload

N/A

Sandbox

/sandbox

Strings

/strings

Testcases

N/A

Other

N/A

Revision information

Latest editor

Kr0tchet

Last edited

21/08/2023
20230821050017

Revision size

5572 bytes
5.572 kilobytes
0.005572 megabytes

Technical information

Page identifier

46333

Contains translations

Yes

Uses parser functions?

Yes

Uses variables?

Yes