The first video in the TASBot Re: (TASBot Revisited) series is out! TASBot Re: Gradius covers our first run from AGDQ 2014.

Historians wanted: Inquire here.

Template:Format run data: Difference between revisions

Template page
(Make it an error to use this template directly)
(Rewrite most of the documentation to reflect the new structure)
Line 1: Line 1:
<onlyinclude><includeonly>{{fail|{{PAGENAME}}|transclude one of the subpages instead of this}}</includeonly></onlyinclude>
<onlyinclude><includeonly>{{fail|{{PAGENAME}}|transclude one of the subpages instead of this}}</includeonly></onlyinclude>


Calls another template of your choosing with the data about the specified run as template arguments.
This is not a template; rather, it serves as documentation and a common parent for a set of related templates, which are listed below.
The first parameter to this template is the name of the template to call, and the second is the ID of the run to look up.
These templates hold [[metawikimedia:Help:Array|data]] about the various runs showcased by TASBot and friends.
For example, <code><nowiki>{{format run data/SML2 Memory Tour}}</nowiki></code> produces:
They need to be paired with a "callback" template for formatting. See any child page for usage docs.
{{format run data/SML2 Memory Tour}}
...equivalent to this call:
<pre><nowiki>
{{showcase
|anchor=SML2 Memory Tour
|author={{TASVideosU|link_7777}}
|game-name=Super Mario Land 2
|lead=[[dwangoAC]]
|platform=GB
|presenter=dwangoAC, link_7777
|recording={{YouTube video|1GF_LFPz34U|TASVideos (YouTube)}}, {{YouTube video|1=EHfw-BEuRO8?time_continue=429|2=GDQ (YouTube)}}
|run-branch=Memory Tour Showcase
|tasvideos-game=452
|tasvideos-movie-template=TASVideosUF
|tasvideos-movie-value=31714711949576163
}}
</nowiki></pre>
 
This page holds only the [[metawikimedia:Help:Array|data]]; the specified template (can be in any namespace) must provide the "implementation".
Passing e.g. <code>:Page/subpage</code> as the first argument will transclude a main namespace article, as per usual.
You can also omit it e.g. <code><nowiki>{{format run data|2=SML2 Memory Tour}}</nowiki></code> and it will default to calling {{t|showcase}}.


Known runs:
Known runs:
Line 30: Line 9:
<!-- we may want [[mw:Extension:SubPageList]] to customise how the list is formatted -->
<!-- we may want [[mw:Extension:SubPageList]] to customise how the list is formatted -->


The "callback" template can make use of the following parameters:
Besides the default {{t|showcase}}, there are a couple of other formatter templates for niche use cases:
* <code>anchor</code>: (always present) The same ID passed to this template for the lookup. The intention is to use the same ID as a section anchor, as {{t|showcase}} does.
* [[Runs/row]]
* {{t|format run data meta/run name}}
 
A formatter template can make use of the following parameters:
<!-- TODO double-check data, then rewrite this to match -->
* <code>anchor</code>: (always present) The same as the page name (spaces, not underscores). The intention is to also use this as a section <code>id</code>/anchor, as {{t|showcase}} does.
* <code>appearance</code>: (always present) The name of the relevant event appearance page, or the name of a redirect to it.
* <code>appearance</code>: (always present) The name of the relevant event appearance page, or the name of a redirect to it.
* <code>author</code>: (always present) A rich text list of the run/playaround's authors.
* <code>author</code>: (always present) A rich text list of the run/playaround's authors.
Line 48: Line 32:
** in any case it should be passed on to the template specified by <code>tasvideos-movie-template</code> without processing.
** in any case it should be passed on to the template specified by <code>tasvideos-movie-template</code> without processing.


{{TemplateData preamble}}<templatedata>
The child templates all call {{t|format run data meta/base template}} as a single-source-of-truth, should we want to change something later.
{
Their documentation is generated with {{t|format run data meta/template docs page}}.
"params": {
"1": {
"label": "Callback Template Name",
"description": "name of template or article to be transcluded with data as arguments",
"type": "wiki-page-name",
"default": "showcase",
"suggested": true
},
"2": {
"label": "Run 'Lookup' ID",
"description": "the string that uniquely identifies a particular presentation of a run/playaround",
"type": "string",
"required": true
}
},
"description": "Calls another template of your choosing with the data about the specified run as template arguments.",
"paramOrder": [
"1",
"2"
],
"format": "{{_|_=_}}\n"
}
</templatedata>


[[Category:General-use_block_templates]]
[[Category:General-use_block_templates]] <!-- intentionally leaving this here for discoverability -->

Revision as of 09:47, 3 August 2024


This is not a template; rather, it serves as documentation and a common parent for a set of related templates, which are listed below. These templates hold data about the various runs showcased by TASBot and friends. They need to be paired with a "callback" template for formatting. See any child page for usage docs.

Known runs:

Besides the default {{showcase}}, there are a couple of other formatter templates for niche use cases:

A formatter template can make use of the following parameters:

  • anchor: (always present) The same as the page name (spaces, not underscores). The intention is to also use this as a section id/anchor, as {{showcase}} does.
  • appearance: (always present) The name of the relevant event appearance page, or the name of a redirect to it.
  • author: (always present) A rich text list of the run/playaround's authors.
  • game-name: (always present) The full name of the game, as plain text.
  • game-pub-year: (always present) The year the game was published, as plain text.
  • lead: (always present) A rich text list of the people who oversaw the presentation at the event.
  • platform: (always present) The mnemonic of the system/platform the game is for (follows BizHawk; see {{TASVideosPF}} for details).
  • presenter: (always present) A rich text list of the people who presented at the event.
  • recording: (always present) A rich text list of links to videos.
  • run-branch: (always present) The 'branch' or 'goal' of the run, e.g. 100%, credits warp, playaround.
  • tasvideos-game: (always present) The game's ID on TASVideos (without the 'G' suffix).
  • tasvideos-movie-template: (always present) The name of one of the {{TASVideos}} family of templates, e.g. TASVideosM.
  • tasvideos-movie-value: (always present) Depending on the value of tasvideos-movie-template:
    • when it's {{TASVideosM}}, this is the run's publication ID on TASVideos (without the 'M' suffix);
    • when it's {{TASVideos}}, this is the relative URI of some page on TASVideos that pertains to this run (i.e. without the https://tasvideos.org prefix);
    • in any case it should be passed on to the template specified by tasvideos-movie-template without processing.

The child templates all call {{format run data meta/base template}} as a single-source-of-truth, should we want to change something later. Their documentation is generated with {{format run data meta/template docs page}}.

Retrieved from "https://tas.bot/index.php?title=Template:Format_run_data&oldid=1552"