Oh0kaYthen86 (talk | contribs) (added syntax + example output) |
(speed now uses the Number type) |
||
(12 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
{{CategorySetting|On [[Collective Unconscious:Collective Unconscious Wiki|''Collective Unconscious'']] pages, it adds [[:Category:Missing BGM author]] if no author is specified.}} | |||
{{PropertySetting}} | |||
==Description== | |||
<templatedata> | <templatedata> | ||
{ | { | ||
"description": "Renders a link (if provided) to an area's BGM, and sets a record that can be queried.", | |||
"format": "inline", | |||
"params": { | "params": { | ||
"title": { | "title": { | ||
"label": "Title", | "label": "Title", | ||
"description": "The BGM's title | "description": "The BGM's title to be displayed. This could either be an official title, or the original filename exclusive of extension.", | ||
"example": "いかる ひのやま", | "example": "いかる ひのやま", | ||
"type": "string", | "type": "string", | ||
Line 14: | Line 17: | ||
"label": "Filename", | "label": "Filename", | ||
"description": "The audio's filename, pointing to the file as uploaded. If left blank, no link will be displayed.", | "description": "The audio's filename, pointing to the file as uploaded. If left blank, no link will be displayed.", | ||
"example": " | "example": "CU maple-clicking 60.ogg", | ||
"type": "string", | "type": "string", | ||
"suggested": true | "suggested": true | ||
Line 20: | Line 23: | ||
"label": { | "label": { | ||
"label": "Label", | "label": "Label", | ||
"description": "A label describing where or when the | "description": "A label describing where or when the BGM would play. This could be a sub-area, an event, or the area under different conditions.", | ||
"example": "FC Overworld", | "example": "FC Overworld", | ||
"type": "string" | |||
}, | |||
"soundroom": { | |||
"label": "Sound Room ID", | |||
"description": "If the BGM is featured in a Sound Room like in Yume 2kki, provide the ID as seen in the Sound Room.", | |||
"example": "307C", | |||
"type": "string" | |||
}, | |||
"speed": { | |||
"label": "Speed", | |||
"description": "The speed at which the track is set to play in-game.", | |||
"example": "60", | |||
"type": "number", | |||
"required": true | |||
}, | |||
"author": { | |||
"label": "Author", | |||
"description": "Credit the track's composer/author. Usually only applicable to collaborative games.", | |||
"example": "MadameMimic", | |||
"type": "string" | "type": "string" | ||
} | } | ||
} | } | ||
} | } | ||
</templatedata> | </templatedata> | ||
== Syntax == | ==Semantic properties== | ||
This template exposes the following semantic properties. | |||
{| class="wikitable" style="width:100%;" | |||
!Property name | |||
!Description | |||
!Data type | |||
!Cardinality | |||
|- | |||
|[[Property:Has BGM|Has BGM]] | |||
|The main record that holds all the other properties. | |||
|[[Special:Types/Record|Record]] | |||
|Single | |||
|- | |||
|[[Property:BGM/Title|BGM/Title]] | |||
|The title of the BGM, either official or from the game files. | |||
|[[Special:Types/Text|Text]] | |||
|Single | |||
|- | |||
|[[Property:Has media path|Has media path]] | |||
|The path leading to the audio file on the wiki. | |||
|[[Special:Types/URL|URL]] | |||
|Single | |||
|- | |||
|[[Property:BGM/Audio|BGM/Audio]] | |||
|The wiki page of the audio file. | |||
|[[Special:Types/Page|Page]] | |||
|Single | |||
|- | |||
|[[Property:BGM/Label|BGM/Label]] | |||
|A label describing the BGM, usually where it plays in the location. | |||
|[[Special:Types/Text|Text]] | |||
|Single | |||
|- | |||
|[[Property:BGM/Soundroom|BGM/Soundroom]] | |||
|The ID of the track in the game's Sound Room or equivalent feature, if one is present in the game. | |||
|[[Special:Types/Text|Text]] | |||
|Multiple | |||
|- | |||
|[[Property:BGM/Speed|BGM/Speed]] | |||
|The speed at which the BGM is set to play in the location. This should correspond to the audio file on the wiki. | |||
|[[Special:Types/Number|Number]] | |||
|Single | |||
|- | |||
|[[Property:BGM/Author|BGM/Author]] | |||
|The author(s) who created the BGM. Usually only applicable to collaborative games. | |||
|[[Special:Types/Text|Text]] | |||
|Multiple | |||
|} | |||
==Syntax== | |||
<pre> | <pre> | ||
{{BGM | {{BGM|title= |filename= |label= |speed= |soundroom= |author= }} | ||
| title = | |||
| filename = | |||
| label = | |||
}} | |||
</pre> | </pre> | ||
== Sample | ==Sample== | ||
The following input: | |||
<pre> | <pre> | ||
{{ | {{BGM|title = tonny31.6|filename = Tonny31.6 (284D).ogg|label = Budding Life World|soundroom = 248D}} | ||
| title = tonny31.6 | |||
| filename = Tonny31.6 (284D).ogg | |||
| label = Budding Life World | |||
}} | |||
</pre> | </pre> | ||
{{ | |||
| title = tonny31.6 | Produces: | ||
| filename = Tonny31.6 (284D).ogg | |||
| label = Budding Life World | {{BGMDisplay|title = tonny31.6|filename = Tonny31.6 (284D).ogg|label = Budding Life World|soundroom = 248D}} | ||
}} | |||
''Note: This sample uses {{t|BGMDisplay}} to avoid creating a record property.'' | |||
<noinclude>[[Category:Template documentation]]</noinclude> | |||
<includeonly>__NOEDITSECTION__ | |||
[[Category:Location templates]] | |||
</includeonly> |
Latest revision as of 16:34, 9 August 2024
This template conditionally sets categories on pages. Please only use this template as intended. Conditions: On Collective Unconscious pages, it adds Category:Missing BGM author if no author is specified. |
This template automatically sets Semantic MediaWiki properties on pages. This may include creating subobjects. Please only use this template as intended. |
Description
Renders a link (if provided) to an area's BGM, and sets a record that can be queried.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Title | title | The BGM's title to be displayed. This could either be an official title, or the original filename exclusive of extension.
| String | required |
Filename | filename | The audio's filename, pointing to the file as uploaded. If left blank, no link will be displayed.
| String | suggested |
Label | label | A label describing where or when the BGM would play. This could be a sub-area, an event, or the area under different conditions.
| String | optional |
Sound Room ID | soundroom | If the BGM is featured in a Sound Room like in Yume 2kki, provide the ID as seen in the Sound Room.
| String | optional |
Speed | speed | The speed at which the track is set to play in-game.
| Number | required |
Author | author | Credit the track's composer/author. Usually only applicable to collaborative games.
| String | optional |
Semantic properties
This template exposes the following semantic properties.
Property name | Description | Data type | Cardinality |
---|---|---|---|
Has BGM | The main record that holds all the other properties. | Record | Single |
BGM/Title | The title of the BGM, either official or from the game files. | Text | Single |
Has media path | The path leading to the audio file on the wiki. | URL | Single |
BGM/Audio | The wiki page of the audio file. | Page | Single |
BGM/Label | A label describing the BGM, usually where it plays in the location. | Text | Single |
BGM/Soundroom | The ID of the track in the game's Sound Room or equivalent feature, if one is present in the game. | Text | Multiple |
BGM/Speed | The speed at which the BGM is set to play in the location. This should correspond to the audio file on the wiki. | Number | Single |
BGM/Author | The author(s) who created the BGM. Usually only applicable to collaborative games. | Text | Multiple |
Syntax
{{BGM|title= |filename= |label= |speed= |soundroom= |author= }}
Sample
The following input:
{{BGM|title = tonny31.6|filename = Tonny31.6 (284D).ogg|label = Budding Life World|soundroom = 248D}}
Produces:
tonny31.6 (??%) (No. 248D): Budding Life World
Note: This sample uses {{BGMDisplay}} to avoid creating a record property.