Difference between revisions of "Template:TrackListEntry"

From Video Game Music Preservation Foundation Wiki
Jump to: navigation, search
(Add Game - Platform")
(Use TitleLink for all wiki links, including recording filenames)
Line 23: Line 23:
 
* "''Title'' - ''Game''", if that page exists (e.g. [[Main Theme - Ski or Die]]).
 
* "''Title'' - ''Game''", if that page exists (e.g. [[Main Theme - Ski or Die]]).
 
* Otherwise the link is just ''Title'' (e.g. [[Map]]).
 
* Otherwise the link is just ''Title'' (e.g. [[Map]]).
Only use this parameter where it is not possible to rename the song page so that it fits the standard wiki naming scheme.
+
Only use this parameter where it is not possible to rename the song page so that it fits the standard wiki naming scheme. For example the [[Boppin' (DOS)]] song "Boppin Opus #43" cannot have the "#" symbol in an article name, so it needs a ''TitleLink'' of "Boppin Opus 43" without the hash symbol.
 +
 
 +
Note that if you supply this parameter, it is used in place of the song title for all wiki links, such as the autogenerated song recording filename.  (You can still override that with the ''Recording'' parameter of course.)
 
|-
 
|-
 
| '''Composer'''
 
| '''Composer'''
Line 120: Line 122:
 
     <td>{{{Extra6}}}</td>}}{{#if:{{{Extra7|}}}|
 
     <td>{{{Extra6}}}</td>}}{{#if:{{{Extra7|}}}|
 
     <td>{{{Extra7}}}</td>}}
 
     <td>{{{Extra7}}}</td>}}
     <td>{{Song-List|{{#if:{{{Recording|}}} | {{{Recording|}}} | {{ZeroPad|{{{Track|0}}}}}_-_{{{Game}}}_-_{{#if:{{{Platform|}}}|{{{Platform}}}_-_}}{{{Title}}}.ogg}} }}</td>
+
     <td>{{Song-List|{{#if:{{{Recording|}}} | {{{Recording|}}} | {{ZeroPad|{{{Track|0}}}}}_-_{{{Game}}}_-_{{#if:{{{Platform|}}}|{{{Platform}}}_-_}}{{{TitleLink|{{{Title}}}}}}.ogg}} }}</td>
 
     <td itemprop="recordedAs" itemscope itemtype="http://schema.org/MusicRecording"><meta itemprop="duration" content="PT{{{DurationMin|0}}}M{{{DurationSec|0}}}S" /><!--
 
     <td itemprop="recordedAs" itemscope itemtype="http://schema.org/MusicRecording"><meta itemprop="duration" content="PT{{{DurationMin|0}}}M{{{DurationSec|0}}}S" /><!--
  
 
Normal download link:
 
Normal download link:
  
-->[[Media:{{#if:{{{Recording|}}} | {{{Recording|}}} | {{ZeroPad|{{{Track|0}}}}}_-_{{{Game}}}_-_{{#if:{{{Platform|}}}|{{{Platform}}}_-_}}{{{Title}}}.ogg}}|Download]]<!--
+
-->[[Media:{{#if:{{{Recording|}}} | {{{Recording|}}} | {{ZeroPad|{{{Track|0}}}}}_-_{{{Game}}}_-_{{#if:{{{Platform|}}}|{{{Platform}}}_-_}}{{{TitleLink|{{{Title}}}}}}.ogg}}|Download]]<!--
  
 
Direct file link for "audio" microdata attribute:
 
Direct file link for "audio" microdata attribute:
  
--><span itemprop="audio" itemscope itemtype="http://schema.org/AudioObject"><meta itemprop="contentUrl" content="{{fullurl:Media:{{#if:{{{Recording|}}} | {{{Recording|}}} | {{ZeroPad|{{{Track|0}}}}}_-_{{{Game}}}_-_{{#if:{{{Platform|}}}|{{{Platform}}}_-_}}{{{Title}}}.ogg}}}}" /></span><!--
+
--><span itemprop="audio" itemscope itemtype="http://schema.org/AudioObject"><meta itemprop="contentUrl" content="{{fullurl:Media:{{#if:{{{Recording|}}} | {{{Recording|}}} | {{ZeroPad|{{{Track|0}}}}}_-_{{{Game}}}_-_{{#if:{{{Platform|}}}|{{{Platform}}}_-_}}{{{TitleLink|{{{Title}}}}}}.ogg}}}}" /></span><!--
  
 
Hidden content which points to the "url" microdata attribute of the song.  This picks whichever page exists first, in this order:
 
Hidden content which points to the "url" microdata attribute of the song.  This picks whichever page exists first, in this order:

Revision as of 19:26, 22 May 2015

This template is used to start a table of song recordings. It is combined with Template:TrackListBegin and Template:TrackListEnd to produce the full table of recordings.

Tables produced with this template contain structured data allowing search engines to list the recordings directly in the search results.

The following parameters are valid:

Parameter Example Purpose
Track Track = 1 Track number (do not use leading zeroes).
Title Title = A Song Song title.
TitleLink (optional) TitleLink = A Song (Example Game) Link to the song's page, if it is different to the song title. Only use this if the page for the song is actually named differently to the song title, and the page cannot be renamed. The default link is:

Only use this parameter where it is not possible to rename the song page so that it fits the standard wiki naming scheme. For example the Boppin' (DOS) song "Boppin Opus #43" cannot have the "#" symbol in an article name, so it needs a TitleLink of "Boppin Opus 43" without the hash symbol.

Note that if you supply this parameter, it is used in place of the song title for all wiki links, such as the autogenerated song recording filename. (You can still override that with the Recording parameter of course.)

Composer Composer = {{TrackListComposer|John Doe}}
Composer = {{TrackListComposer|John Doe|Johnny Doe}}, {{TrackListComposer|Robert Smith|Bob Smith}}
Name of the composer(s). Only one Composer option can be specified, so multiple composers should be comma separated. Remember to surround composer names with the Template:TrackListComposer template. Template use is {{TrackListComposer|Article name|Credited name}} where the credited name is as per the game credits, and the article name is the destination wiki page to link to. The credited name parameter can be omitted when it is the same as the article name.
DurationMin
DurationSec
DurationMin = 1
DurationSec = 23
Length of the song, split into minutes and seconds as separate parameters. The example produces a song length of 1:23.
Game Game = Example Game Name of the game this song is from. This is used to populate the 'album' fields.
Platform Platform = DOS Game platform. This is used to populate the 'album' fields.
Recording (optional) Recording = Filename.ogg Filename of the recording. Avoid using this parameter if possible. The default filename is "Track - Game - Platform - Title.ogg" with Track padded with a leading zero if needed, so it is always two digits long.

Example

This code:

{{TrackListBegin}}
{{TrackListEntry
 | Track = 1
 | Title = Example
 | Composer = {{TrackListComposer|John Doe}}
 | DurationMin = 1
 | DurationSec = 23
 | Game = Example
 | Platform = DOS
}}
{{TrackListEnd}}

Will appear as:

# Title Composer Length Listen Download
01 Example John Doe 1:23 Download

Development

This section is used to preview changes to the template code during development.

# Title Composer Length Listen Download
? [[{{{Title}}}]] Unknown 0:00 [[Media:00_-_{{{Game}}}_-_{{{Title}}}.ogg|Download]]