Jump to content

Template:Quality/doc: Difference between revisions

From Stardew Valley Wiki
← Older edit
imported>Margotbean
m Text replacement - "tt>" to "samp>"
imported>Margotbean
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
This template displays an image with a superimposed quality star, i.e., a star colored to match the item's quality (Silver, Gold, Iridium).
==Description==
This template overlays a quality star icon (silver, gold, or iridium) over an image.  


==Usage==
==Parameters==
===Syntax===
{|class="wikitable"
Basic usage:
|-
<nowiki>{{</nowiki>'''Quality'''|''item_name''|''quality''<nowiki>}}</nowiki>
!Parameter
 
!Notes
Complete argument list:
|-
<nowiki>{{</nowiki>'''Quality'''|''item_name''|''quality''| size=''px''<nowiki>}}</nowiki>
|First (unnamed) parameter
 
|Name of background image (without extension such as .png)
===Parameters===
|-
There are two unnamed, required parameters, ''item_name'' and ''quality''.  All other parameters are named and optional.  Default value for all arguments is empty, unless specified otherwise.
|Second (unnamed) parameter
 
|Quality star to display<br />Valid values: normal, 0, silver, 1, gold, 2, iridium, 4
* '''''item_name'''''
|-
** First unnamed parameter, required
|Third (unnamed) parameter
** The name of an item, or more specifically the name of the image (without .png)
|Desired display width of background image (do not include "px")<br />Valid values: 48, 36, 32, 24 (other values will be accepted, but may produce undesired results)<br />Default value: 24
** Note that there must be no spaces following the item_name -- the "|" symbol must come immediately afterwards, or the template will fail (due to quirks of how mediawiki templates process arguments)
|-
** There is technically a default value, <samp>Blank_Icon</samp>, solely to make the template not generate errors in the default display on other languages.
|Fourth (unnamed) parameter
** The template will automatically handle certain language-specific images.  Namely in French, Japanese, Spanish, and Portuguese, all 4 Milk icons will be replaced with language-appropriate ones (where the "M" for cow milk or "G" for goat milk are replaced with more appropriate letters). The coding intentionally avoids using the expensive ifexist parser function because this template is frequently used dozens of times on a page. As a result, only specific known cases are recognized.
|<samp>center</samp>, if the image is to be displayed in a table cell. Adding this parameter will center the image in the cell.
 
|-
* '''''quality'''''
|}
** Second unnamed parameter, required
** Possible values are <samp>Silver</samp>, <samp>Gold</samp>, <samp>Iridium</samp>. Not case-sensitive.  All other values are ignored (i.e., no star is displayed). If missing, no star is displayed.
** On other languages, the translated terms are also recognized.
 
* '''size=''px'''''
** Size of icons in pixels.  Default value is 24.
** Standard values are <samp>24</samp>, <samp>32</samp>, and <samp>48</samp>.  Other values will work, but the size of the overlay region is always one of the standard values (e.g., there may be extra white space around the image).
** Only the number should be provided (do not append "px").<ref name="px">Technically, the template will strip any extra "px" from a provided size, but this usage is not recommended.</ref>
** For backwards compatibility, the size can also be provided as a third unnamed argument (e.g., <samp><nowiki>{{Quality|Parsnip|Silver|24}}</nowiki></samp>).


==Examples==
==Examples==
<pre>{{Quality|Parsnip|silver}}</pre>
{|class="wikitable"
Result: {{Quality|Parsnip|silver}}
|-
<pre>{{Quality|Kale|Gold|32}}</pre>
!Template Call
Result: {{Quality|Kale|Gold|32}}
!Result
<pre>{{Quality|Potato|size=32}}</pre>
|-
Result: {{Quality|Potato|size=32}}
|<code><nowiki>{{Quality|Parsnip|iridium}}</nowiki></code>
<pre>{{Quality|Milk|iridium|size=24}}</pre>
|{{Quality|Parsnip|iridium}}
Result: {{Quality|Milk|iridium|size=24}}
|-
 
|<code><nowiki>{{Quality|Parsnip|silver|24|center}}</nowiki></code>
==Technical Details==
|{{Quality|Parsnip|silver|24|center}}
<references />
|-
<includeonly>[[Category:Formatting templates]]{{Addlanglinks}}</includeonly><noinclude>[[Category:Template documentation]]</noinclude>
|<code><nowiki>{{Quality|Sunfish|normal|36}}</nowiki></code>
|{{Quality|Sunfish|normal|36}}
|-
|<code><nowiki>{{Quality|Red Plate|gold|36|center}}</nowiki></code>
|{{Quality|Red Plate|gold|36|center}}
|-
|<code><nowiki>{{Quality|Beer|gold|48}}</nowiki></code>
|{{Quality|Beer|gold|48}}
|-
|<code><nowiki>{{Quality|Large Goat Milk ES|gold|32|center}}</nowiki></code>
|{{Quality|Large Goat Milk ES|gold|32|center}}
|-
|}<includeonly>{{Addlanglinks}}[[Category:Templates]]</includeonly><noinclude>[[Category:Template documentation]]</noinclude>

Latest revision as of 04:05, 14 February 2023

Description

This template overlays a quality star icon (silver, gold, or iridium) over an image.

Parameters

Parameter Notes
First (unnamed) parameter Name of background image (without extension such as .png)
Second (unnamed) parameter Quality star to display
Valid values: normal, 0, silver, 1, gold, 2, iridium, 4
Third (unnamed) parameter Desired display width of background image (do not include "px")
Valid values: 48, 36, 32, 24 (other values will be accepted, but may produce undesired results)
Default value: 24
Fourth (unnamed) parameter center, if the image is to be displayed in a table cell. Adding this parameter will center the image in the cell.

Examples

Template Call Result
{{Quality|Parsnip|iridium}}
{{Quality|Parsnip|silver|24|center}}
{{Quality|Sunfish|normal|36}}
{{Quality|Red Plate|gold|36|center}}
{{Quality|Beer|gold|48}}
{{Quality|Large Goat Milk ES|gold|32|center}}
Retrieved from "https://stardew.fastobject.net/index.php?title=Template:Quality/doc&oldid=127426"