Template:VersionHistory: Difference between revisions

Latest revision as of 14:15, 22 September 2024

Documentation (for the above template, sometimes hidden or invisible)

Description

This template is used to format version history and changelogs in a consistent and accessible manner.

Usage

For a version, the template is called using {{vh}} and ended with {{vhend}}. Patches are placed in between the main {{vh}} call and the {{vhend}}, but still use {{vh}}.

The template aims to format the list in a fluid and responsive manner that supports varying screen sizes. It was made in response to the old table style of changelogs causing issues on mobile devices.

Patches must include the word "patch" in order to be formatted correctly, in the format [version] patch [patch_number]. This may be unideal for games with irregular patch schemes. Changes to this system (that do not break existing uses of the template) would be welcome.

There is an unused data component in the template that would add version data to the API. It is disabled as the data is redundant except release date.

Parameters

Version History lists. Fluid structure.

Template parameters
This template has custom formatting.
Parameter		Description	Type	Status
Version/Patch	`1`	The full name of the version or patch. Patches are recognised if this parameter has "patch" in the input. This changes what the following parameters do. Example 0.120d patch 3	Line	required
Images/Author	`2`	If a version, specify images in the form "Filename.png (Page Name), File2…". If a patch, add a list of author names, or leave blank if it's a solo game.	Line	suggested
Author/Release Date	`3`	If a version, add a list of author names, or leave blank if it's a solo game. If a patch, add the release date. It's recommended to use YYYY/MM/DD.	Line	suggested
Release Date/Nothing	`4`	If a version, add the release date. It's recommended to use YYYY/MM/DD. Do not include a fourth parameter for patches.	Line	optional

Sample

This is an example on how the template can be used:

This page lists the version history of <some game>.

{{vh
|0.02
|SnowyWorld.png (Snowy World)
|PersonA, PersonB
|2020/04/19
}}
*Changed a warp
*Added Snowy World
**Accessed from another world
*etc
{{vh
|0.02 patch 1
|PersonB
|2020/04/25
}}
*Fixed an issue
{{vhend}}

{{vh
|0.01
…

Visit Template:VersionHistory/doc to edit this text! (How does this work?)

@@ Line 20: / Line 20: @@
     -->|<!-- If there are images:
        --><div id="mw-content" class="floatright" style="padding:12px;padding-bottom:1px;font-size:1px;"><!-- Open image div
-       -->{{#arraymap:{{{2}}}|,|?|[[File:{{#rmatch:?|^(.+)\(|\1}}{{!}}left{{!}}border{{!}}370px{{#rmatch:?|\(([^\(\)]+)\)$|then={{!}}link={{NAMESPACEE}}:\1}}]]|\n}}<!-- Array for images and their annotations
+       -->{{#arraymap:{{{2}}}|,|?|[[File:{{#rmatch:?|^(.+\.[A-z]+)|\1}}{{!}}left{{!}}border{{!}}370px{{#rmatch:?|\(([^\(\)]+)\)$|then={{!}}link={{NAMESPACEE}}:\1}}]]|\n}}<!-- Array for images and their annotations
     --></div><!-- Close image div
     -->}}<!-- End image check
@@ Line 26: / Line 26: @@
 |Version = {{{1|}}}
 |Version/Type = version
-|Version/Image = {{#arraymap:{{{2}}}|,|?|File:{{#rmatch:?|^(.+)\(|\1}}|?}}|+sep=?
+|Version/Image = {{#arraymap:{{{2}}}|,|?|File:{{#rmatch:?|^(.+\.[A-z]+)|\1}}|?}}|+sep=?
 |Is part of game = {{NAMESPACE}}
 |Has contributing author = {{{3|}}}|+sep=,