Kate at 08:02, 4 January 2025

2025-01-04T08:02:31Z

Kate: Created page with "{{doc|0}}
{{todo|See Template:Software/doc/draft}} {{todo|Replace the {{code|{{=}}suf}} method translations with /strings and {{code|#switch: {{language}}}} instead.}} {{tl|Software}} is the template that underlies the icon templates. It has 8 main parameters: {| width="100%" class="unsortable" style="overflow: hidden; border-radius:.4em; border:2px solid #adadad" |- bgcolor..."

2025-01-04T07:57:17Z

Created page with "<noinclude>{{doc|0}}</noinclude> <div style="display:flex;"><div style="flex:1;"> {{todo|See Template:Software/doc/draft}} {{todo|Replace the {{code|{{=}}suf}} method translations with /strings and {{code|<nowiki>#switch: {{language}}</nowiki>}} instead.}} {{tl|Software}} is the template that underlies the icon templates. It has 8 main parameters: {| width="100%" class="unsortable" style="overflow: hidden; border-radius:.4em; border:2px solid #adadad" |- bgcolor..."

New page

<noinclude>{{doc|0}}</noinclude>
<div style="display:flex;"><div style="flex:1;">
{{todo|See [[Template:Software/doc/draft]]}}
{{todo|Replace the {{code|{{=}}suf}} method translations with [[/strings]] and {{code|<nowiki>#switch: {{language}}</nowiki>}} instead.}}

{{tl|Software}} is the template that underlies the icon templates. It has 8 main parameters:
{| width="100%" class="unsortable" style="overflow: hidden; border-radius:.4em; border:2px solid #adadad"
|- bgcolor="#e6e6e6" style="white-space:nowrap"
! style="background-color:#b0aaa6; color:#000; width:2%" | {{Dictionary/common|Param}}
! style="background-color:#b0aaa6; color:#000; width:16%" | {{Dictionary/common|Desc}}
! style="text-align:center" style="background-color:#b0aaa6; color:#000; width:12%" | Value & {{Dictionary/common|Previews}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|1}}}}
| bgcolor="#e6e6e6" | The way the icon will be displayed. Displays the icon only when not specified.
| bgcolor="#e6e6e6" |
{{param|1}} ► {{hl2}} (without specifying numbers)<br>
{{param|1|1}} ► {{hl2|1}}<br>
{{param|1|1.bold}} ► {{hl2|1.bold}}<br>
{{param|1|2}} ► {{hl2|2}}<br>
{{param|1|2.bold}} ► {{hl2|2.bold}}<br>
{{param|1|3}} ► {{hl2|3}}<br>
{{param|1|4}} ► {{hl2|4}}<br>
{{ExpandBox|title=Click "Expand" to see more|
{{param|1|3-darker}} ► {{hl2|3-darker}}<br>
{{param|1|3.1}} ► {{hl2|3.1}}<br>
{{param|1|3.2}} ► {{hl2|3.2}}<br>
{{param|1|4-darker}} ► {{hl2|4-darker}}<br>
{{param|1|4.1}} ► {{hl2|4.1}}<br>
{{param|1|4.2}} ► {{hl2|4.2}}<br>
}}
Enter "col" (without quotes) to get the text color of the game/software.
Enter "in", "also", "only", "since", "removed" or "not" (without quotes) to get the icon displayed along with additional text, like "{{also|{{hl2}}}}".
{{Note|<nowiki>However, the {{{1}}} parameter cannot be touched, it should always be "{{{1}}}" in the icon templates!</nowiki>}}
{{Note|Colored text should be used when appropriate, otherwise it would clutter the page.}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|name}}}}
| bgcolor="#e6e6e6" | Simply display the name. However this param is also used to add the abbreviation of the game for example (when you create/edit this template).<br>{{Note|it is strongly recommended to write the abbreviation of the game in the parameter {{Param|name0}}, {{Param|name1}}, etc... or {{Param|nameiPadOS}} (if supported, in templates such as {{t|iOS}}.}}
| bgcolor="#e6e6e6" | {{hl2|name}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|bold}}}}
| bgcolor="#e6e6e6" | Same as above, with bold text.
| bgcolor="#e6e6e6" | {{hl2|bold}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|ico}}}}
| bgcolor="#e6e6e6" | The name of the icon is written here, but only the name itself, without "File:" and square brackets.<br>This same param is also used to display the icon you have specified when you create a new {{T|Software}} template. If the icon doesn't exist, it simply shows red link.
| bgcolor="#e6e6e6" | {{hl2|ico}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|ico size}}}}
| bgcolor="#e6e6e6" | Width of the icon. Should be {{mono|16px}} for most icons, unless it's double, like {{hls}}, in which case it should be {{mono|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 {{mono|{{param|ico size}}}}). While this is nominally "16 pixels tall", high-DPI displays (particulary such as Apple Retina display, or 4K+ displays) will benefit from the file being higher resolutions; 32 or 64 pixels tall is generally sufficient, although any resolution can be used (MediaWiki will downscale the image automatically and only deliver the necessary resolution).}}
| bgcolor="#e6e6e6" | N/A
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|col}}}}
| bgcolor="#e6e6e6" | The color of the game. If it is not specified, just do not enter this parameter, the standard color will be used: <span style="color:#ADD8E6;font-weight:bold">#ADD8E6</span>.<br> It's highly recommended that you use brighter color for better readability with dark/black pages, but not too bright or over-saturated.
| bgcolor="#e6e6e6" | {{hl2|col}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|link}}}}
| bgcolor="#e6e6e6" | Link to the article, if not specified, the link will use the {{Param|name}} parameter.<br>Write without the brackets. Underscores and spaces are interchangeable.
{{tip|For Wikipedia links, prepend "WP:" (short for Wikipedia) to the page name (ex: [[WP:Gabe Newell]], or [[Wikipedia:Gabe Newell]]) For external links, use {{t|software external}} and add {{param|is outlink}}.}}
| bgcolor="#e6e6e6" | N/A
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|addtext}}}}
| bgcolor="#e6e6e6" | Additional text that will be written immediately after the icon. It is mainly needed to add other icons.<br>{{Note|Make sure to include {{Code|<nowiki>| addtext = {{{addtext|}}}</nowiki> }} in the icon templates!}}
| bgcolor="#e6e6e6" | {{code|<nowiki>{{hl2|4|addtext=®}}</nowiki>}} ► {{hl2|4|addtext=®}}
|-
| bgcolor="#e6e6e6" align="center" | {{Code|style=2|{{Param|nt}}}}
| bgcolor="#e6e6e6" | This parameter will be used in the {{Param|name<number>}} parameter, some software templates may also have {{Param|name<text>}}, such as {{t|iOS}} and {{t|Mac}}.
{{Note|Make sure that the {{Code|<nowiki> | nt = {{{nt|}}}</nowiki>}} part must be included on the icon templates for it to work! This parameters requires text to be displayed using {{Param|1}} to use.}}
| bgcolor="#e6e6e6" | {{hl2|4|nt=0}}
|-
|}

=== Result & Copy and Paste ===
In the end, you should get something like this:

{{CodeBlock|src=[[Template:Portal2]]|lines=12|<nowiki>{{doc|docpage=Template:Hl2/doc}}
<includeonly><onlyinclude>{{Software
| {{{1}}}
| ico = portal2 icon.png 
| ico size = 16px 
| link = Portal 2
| name = {{#switch: {{language}}
| #default = Portal 2
| ko = 포탈 2
| zh = 传送门 2
| zh-tw = 傳送門 2
}}

| name0 = portal2
| namePortal 2 = {{#switch: {{language}}
| #default = Portal 2
| ko = 포탈 2
| zh = 传送门 2
| zh-tw = 傳送門 2
}}
| namemoddir = portal2
| col = #23B1E5
| addtext = {{{addtext|}}}
| nt = {{{nt|}}}
}}</onlyinclude></includeonly></nowiki>}}

You can also copy and paste the code above to create a new icon template, or to convert old template ({{T|New icon}}) to {{T|Software}} and update {{T|Software}} templates.

=== Translations ===
Translations are handled by the {{tl|link=In text}} Template.

===How To Use===
This is how the use of the template in articles will look like:
{| class="sortable" style="overflow: hidden; border-radius:.4em; border:2px solid #adadad"
|- bgcolor="#e6e6e6" style="white-space:nowrap"
! style="background-color:#b1c1da" | Code
! style="background-color:#b1c1da" | Result
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}}}
| {{ portal2 }}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|1}}
| {{portal2|1}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|2}}
| {{portal2|2}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|3}}
| {{portal2|3}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|3-darker}}
| {{portal2|3-darker}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|3.1}}
| {{portal2|3.1}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|3.2}}
| {{portal2|3.2}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|4}}
| {{portal2|4}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|4-darker}}
| {{portal2|4-darker}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|4.1}}
| {{portal2|4.1}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|4.2}}
| {{portal2|4.2}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|ico}}
| {{portal2|ico}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|col}}
| {{portal2|col}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|name}}
| {{portal2|name}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|bold}}
| {{portal2|bold}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|in}}
| {{portal2|in}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|only}}
| {{portal2|only}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|since}}
| {{portal2|since}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|not}}
| {{portal2|not}}
|- bgcolor="#e6e6e6"
| {{tlc|{{lcfirst:portal2}}|also|addtext{{=}}&nbsp;{{tlf|csgo}} {{tlf|l4d2}}}}
| {{portal2|also|addtext= {{csgo}} {{l4d2}}}}
|}</div>

<div>{{infobox template
| summary = Aids in the creation of icon templates
| type = Metatemplate
| creationdate = 04/04/2022<br><small>(04 April 2022)</small>
| translation = Yes
| parser = Yes
| var = Yes
}}</div></div>

Template:Software/Doc - Revision history

Kate at 08:02, 4 January 2025