|
|
(14 intermediate revisions by 3 users not shown) |
Line 1: |
Line 1: |
− | This template displays the icon for the requested season, plus the season as a link to its associated article. One or more seasons may be specified, separated by commas. | + | ==Description== |
− | | + | This template displays the icon for the requested season, plus the season as a link to its associated article. |
− | The icon and text are enclosed in a nowrap span, so that they are always displayed on the same line.
| |
| | | |
| ==Notes== | | ==Notes== |
− | The template recognizes two special values of season, <tt>Marriage</tt> and <tt>Deviations</tt>, for the sake of NPC schedule pages (see [[Template:ScheduleHeader]]). | + | The template recognizes two special values of season, <samp>Marriage</samp> and <samp>Deviations</samp>, for the sake of NPC schedule pages (see [[Template:ScheduleHeader]]). |
− | | |
− | ==Usage==
| |
− | ===Syntax===
| |
− | Basic usage:
| |
− | <nowiki>{{</nowiki>[[Template:Season|Season]] | ''season'' <nowiki>}}</nowiki>
| |
− | | |
− | Complete argument list:
| |
− | <nowiki>{{</nowiki>[[Template:Season|Season]] | ''season'' | ''day''
| |
− | | size=''px'' | width=''widthpluspx'' | all=''text_for_all'' | sortkey=true
| |
− | | text_only=true | no_translate=true <nowiki>}}</nowiki>
| |
| | | |
− | ===Parameters=== | + | ==Use== |
− | There is one unnamed required parameter, ''season'', and one unnamed optional parameter, ''day''. All other parameters are named and optional. Default value for all arguments is empty, unless specified otherwise.
| + | <pre>{{Season|name of season|day (optional)|width (optional)}}</pre> |
− | | |
− | * '''''season'''''
| |
− | ** First unnamed parameter, required
| |
− | ** The name of the season to be displayed, recognized values: <tt>Spring, Summer, Fall, Winter, All Seasons, Marriage, Deviations</tt>. <tt>All</tt> and <tt>Any</tt> are recognized as synonyms for <tt>All Seasons</tt>.
| |
− | ** Multiple seasons can be specified, separated by commas
| |
− | ** If an unrecognized season name is provided, the template will simply print out that name (no link, no icon).
| |
− | ** The seasons should be provided as plain text (unlinked). However, to allow the template to work regardless of user input choices, links such as <tt><nowiki>[[Spring]]</nowiki></tt> will work. Also, if the <tt>''season''</tt> already contains any type of image link, the template will just return the input value unaltered (in case user input already included the season call, e.g., <tt><nowiki>{{Season|Spring}}</nowiki></tt>.
| |
− | | |
− | * '''''day'''''
| |
− | ** Second unnamed parameter, optional
| |
− | ** The day of the season, for example to generate formatted villager birthdays.
| |
− | ** Any provided value is displayed in front of the season name (but after the icon), to match the format used in-game for birthdays.
| |
− | | |
− | * '''size=''px'''''
| |
− | ** Size of icon in pixels. Default value is 24
| |
− | ** Only the number should be provided (do not append "px").
| |
− | | |
− | * '''width=''widthpluspx'''''
| |
− | ** Size of icons in pixels ''with px'' (e.g., <nowiki>width=24px</nowiki>).
| |
− | ** This is redundant with <tt>size</tt> and inconsistent (expects a different format); only one (preferably <tt>size</tt>) should be used.
| |
− | ** This parameter is included solely for backwards compatibility and is deprecated
| |
− | | |
− | * '''all=''text_for_all'''''
| |
− | ** Relevant only if <tt>''season''</tt> is <tt>All Seasons</tt> (or a synonym): when <tt>all</tt> is set, the specified text will be displayed instead of <tt>All</tt>. Default value is <tt>All</tt>.
| |
− | | |
− | * '''sortkey=true'''
| |
− | ** If set, a hidden span containing a numeric sortkey will be added to the output, to improve table sorting. (Seasons will be sorted in order Spring, Summer, Fall, Winter, instead of being sorted alphabetically).
| |
− | | |
− | * '''text_only=true'''
| |
− | ** When set, return value is just the name of the season (no icon, no link), in wiki-specific language
| |
− | ** Allows other templates to use Template:Season for processing of generic season input data (especially on non-english wikis where translation capabilities may be wanted).
| |
− | | |
− | * '''no_translate=true'''
| |
− | ** When set, any <tt>text_only</tt> return value is provided in English, instead of the wiki-specific language
| |
− | ** Only relevant if <tt>text_only</tt> is set.
| |
| | | |
| ===Examples=== | | ===Examples=== |
| <pre>{{Season|Spring}} | | <pre>{{Season|Spring}} |
− | {{Season|Summer, Fall, Winter}}
| |
| {{Season|Marriage}} | | {{Season|Marriage}} |
| {{Season|Deviations}} | | {{Season|Deviations}} |
− | {{Season|All|do_short=true}} | + | {{Season|All|width=48}} |
− | {{Season|All|size=48}}
| + | {{Season|Summer|24}} |
− | {{Season|Summer|24}}</pre> | + | </pre> |
| | | |
− | Results:<br/> | + | Results:<br /> |
− | {{Season|Spring}}<br/> | + | {{Season|Spring}}<br /> |
− | {{Season|Summer, Fall, Winter}}<br/>
| + | {{Season|Marriage}}<br /> |
− | {{Season|Marriage}}<br/> | + | {{Season|Deviations}}<br /> |
− | {{Season|Deviations}}<br/> | + | {{Season|All|width=48}}<br /> |
− | {{Season|All|do_short=true}}<br/> | + | {{Season|Summer|24}}<br /> |
− | {{Season|All|size=48}}<br/> | |
− | {{Season|Summer|24}}
| |
| | | |
− | <includeonly>[[Category:Formatting templates]]</includeonly><noinclude>[[Category:Template documentation]]</noinclude> | + | <includeonly>{{Addlanglinks}}[[Category:Templates]]</includeonly><noinclude>[[Category:Template documentation]]</noinclude> |