mNo edit summary |
(update doc) |
||
(20 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{PropertySetting}} | |||
==Description== | ==Description== | ||
{{BadgeListNavbar}} | |||
This template formats the table entries in subpages of [[YNOproject:Badges]]. Besides adding markup and tags, it creates badge subobjects with a [[Property:Badge/Location|"Badge/Location"]] property that interacts with each [[:Category:Locations|location]] the badge appears in. | |||
== | |||
On the badge page you should already have a table that begins using {{T|badge/Start}}. The template is used after the table start. At the end of the last template usage, make sure to close the table with the <code><nowiki>|}</nowiki></code> table end. | |||
< | |||
The "id" parameter is '''absolutely required''' for the template to work. However, it is hidden from the table itself, only present as a title when hovering over the badge name (or tapping on mobile). The most important parameters for the intended function of the template are the "id" and "Location" fields, so endevour to at least add those if possible. | |||
==Usage== | |||
The template creates a subobject with the id as a name. For example, using the template with {{para|id|fc_moai}} in page <code>YNOproject:Badges/Yume Nikki</code> would create the subobject <code>YNOproject:Badges/Yume Nikki#fc_moai</code>. The subobject is also given properties related to the badge. | |||
{| class="wikitable" | |||
|+Semantic properties | |||
|- | |||
!Property | |||
!Function | |||
!Datatype | |||
|- | |||
|[[Property:Badge/Author|Badge/Author]] | |||
|Each author for a badge is listed as a value of this property. | |||
|Text | |||
|- | |||
|[[Property:Badge/BP|Badge/BP]] | |||
|The number of Badge Points the badge awards. | |||
|Number | |||
|- | |||
|[[Property:Badge/Batch|Badge/Batch]] | |||
|The batch the badge was released in, taken from the [https://github.com/ynoproject/ynobadges/commits/master ''ynobadges'' commits page]. | |||
|Number | |||
|- | |||
|[[Property:Badge/Condition|Badge/Condition]] | |||
|The condition string of the badge, including any wiki markup. | |||
|Text | |||
|- | |||
|[[Property:Badge/Date|Badge/Date]] | |||
|The date on which the badge was added to ''ynobadges'': this may not be the day it was made available on the website. This is automatically filled in using {{t|Badge/Batch2Date}}. However, badges with batch 1 should specify date manually using {{para|Date}} in addition to the batch. | |||
|Date | |||
|- | |- | ||
| | |[[Property:Badge/Description|Badge/Description]] | ||
| | |The description of the badge, including any wiki markup. | ||
|Text | |||
| | |- | ||
|[[Property:Badge/Has parent|Badge/Has parent]] | |||
|Sets to ''true'' for badges with the <code>parent</code> property in YNOproject, otherwise ''false''. | |||
| | |Boolean | ||
|- | |||
The | |[[Property:Badge/Has secret condition|Badge/Has secret condition]] | ||
|Sets to ''true'' for badges with the <code>secretCondition</code> property in YNOproject, otherwise ''false''. If a badge has both <code>secretCondition</code> and <code>secret</code>, the trait should be omitted and the value would remain ''false''. | |||
| | |Boolean | ||
| | |- | ||
| | |[[Property:Badge/Has secret map|Badge/Has secret map]] | ||
| | |Sets to ''true'' for badges with the <code>secretMap</code> property in YNOproject, otherwise ''false''. | ||
| | |Boolean | ||
| | |- | ||
|[[Property:Badge/ID|Badge/ID]] | |||
|The ID of the badge, same as the subobject name. | |||
|Text | |||
|- | |||
|[[Property:Badge/Icon|Badge/Icon]] | |||
|The icon of the badge. In many cases both an animated version (.gif) and a static version (.png) as separate values. | |||
|Page ''(in file namespace)'' | |||
|- | |||
|[[Property:Badge/Is hidden|Badge/Is hidden]] | |||
|Sets to ''true'' for badges with the <code>hidden</code> property in YNOproject, otherwise ''false''. | |||
|Boolean | |||
|- | |||
|[[Property:Badge/Is secret|Badge/Is secret]] | |||
|Sets to ''true'' for badges with the <code>secret</code> property in YNOproject, otherwise ''false''. | |||
|Boolean | |||
|- | |||
|[[Property:Badge/Location|Badge/Location]] | |||
|The location of the badge. Can be multiple. This lists the badge subobject as an incoming property of that location. | |||
|Page | |||
|- | |||
|[[Property:Badge/Name|Badge/Name]] | |||
|The name of the badge as presented in YNOproject. | |||
|Text | |||
|- | |||
|[[Property:Badge/Parent|Badge/Parent]] | |||
|The badge ID of the parent badge, which is the value of the <code>parent</code> property in YNOproject. | |||
|Text | |||
|- | |||
|[[Property:Is part of game|Is part of game]] | |||
|The game the badge is from. Taken from the type/Namespace parameter, or from the subpage name by default. | |||
|Text | |||
|} | |||
==Parameters== | ==Parameters== | ||
<templatedata>{ "description": "","params": { | <templatedata>{ | ||
"description": "The badge template handles both subobject data and table row presentation.", | |||
"format": "{{_\n|_ = _\n}}", | |||
"params": { | |||
"id": { | |||
"label": "Badge ID", | |||
"type": "line", | |||
"description": "The id of the badge, taken from https://github.com/ynoproject/ynobadges/tree/master/badges.", | |||
"required": true | |||
}, | |||
"Icon": { | |||
"label": "Icon(s)", | |||
"type": "wiki-file-name", | |||
"description": "The filename(s) of the badge to present in the table, without the \"File:\" prefix. If animated, put the gif first and separate using commas. Image files on the wiki usually have different names than on the YNOproject GitHub.", | |||
"required": true | |||
}, | |||
"Icon_bg": { | |||
"label": "Icon Background Override", | |||
"type": "line", | |||
"description": "Set a hex code to use for the background of an icon cell, to potentially clear any visibility issues." | |||
}, | |||
"Name": { | |||
"label": "Badge Name", | |||
"type": "line", | |||
"description": "The name of the badge as presented in YNOproject itself, or as found in https://github.com/ynoproject/ynobadges/blob/master/lang/en.json.", | |||
"required": true | |||
}, | |||
"BP": { | |||
"label": "BP", | |||
"type": "number", | |||
"description": "The number of Badge Points the badge awards." | |||
}, | |||
"Traits": { | |||
"label": "Traits", | |||
"type": "line", | |||
"description": "Any traits the badge may have, such as hidden or secret. Separate multiple traits using commas. Possible values: Is hidden, Is Secret, Has secret condition, Has secret map, Has parent.", | |||
"example": "Has secret condition, Has secret map" | |||
}, | |||
"Parent": { | |||
"label": "Secret Badge Parent", | |||
"type": "line", | |||
"description": "The badge ID of this badge's parent, if this badge has the trait \"Has parent\"." | |||
}, | |||
"Location": { | |||
"label": "Badge Location(s)", | |||
"type": "wiki-page-name", | |||
"description": "The locations that the badge is found in, if any, without the namespace. Found on the website (the GitHub only provides Map IDs)." | |||
}, | |||
"Description": { | |||
"label": "Description", | |||
"type": "content", | |||
"description": "The description of the badge, if any.", | |||
"suggested": true | |||
}, | |||
"Condition": { | |||
"label": "Unlock Conditions", | |||
"type": "content", | |||
"description": "The condition of the badge, as found on the site or in https://github.com/ynoproject/ynobadges/blob/master/lang/en.json.", | |||
"required": true | |||
}, | |||
"Notes": { | |||
"label": "Notes", | |||
"type": "content", | |||
"description": "Any notes you wish to give regarding the badge. For example, you can point out a game reference that you spotted in the badge description." | |||
}, | |||
"Author": { | |||
"label": "Badge Author(s)", | |||
"type": "line", | |||
"description": "Badge artist names. If multiple, separate using the & symbol.", | |||
"example": "Rose", | |||
"required": true | |||
}, | |||
"Batch": { | "Batch": { | ||
"label": " | "label": "Batch Number", | ||
"type": " | "type": "number", | ||
"description": " | "description": "The batch which contained the badge. Can be found in the badge file. For batch 1 badges, you may need to specify \"Date\" as well.", | ||
"example": " | "suggested": true, | ||
" | "example": "26" | ||
}, | |||
"Date": { | |||
"label": "Release Date", | |||
"type": "date", | |||
"description": "Provide the date the badge was released if there is no batch number, or if the batch number may be inaccurate/not specific, such as for batch 1 badges.", | |||
"example": "2022-10-05" | |||
}}}</templatedata> | }}}</templatedata> | ||
==Sample== | ==Sample== | ||
{{badge/Start}} | |||
|- id="white_tulip" | |||
|style="text-align:center;background:"|[[File:White tulip(badgeyn).png]] | |||
| style="text-align: center;" | | |<span title="white_tulip" tabindex="0">Rain and Flowers</span> | ||
| | |15 | ||
| | |class="center-text"|<span tabindex="0" title="Secret condition">🤐</span><br><span tabindex="0" title="Secret map">🗺</span><br> | ||
|[[Yume Nikki:Sky Garden#Crossover Garden|Sky Garden: Crossover Garden]] | |||
|class="empty"| | |||
|Visit the white tulip passage between Sky Garden and [[Yume Nikki:Ghost World|Ghost World]] | |||
|Badge name references a [https://www.youtube.com/watch?v=8ER6sXss5EU ''Yume Nikki'' remix of the same name]. | |||
|wiki0dd | |||
| | |2023-12-01<br>Batch 86 | ||
| | |||
| | |||
|} | |} | ||
The table start and end are provided as is necessary. | |||
<noinclude> | The table start and end are provided, as is necessary. | ||
<noinclude>[[Category:Template documentation]]</noinclude> | |||
<includeonly>__NOEDITSECTION__</includeonly> | <includeonly>__NOEDITSECTION__</includeonly> |
Latest revision as of 03:12, 28 October 2024
This template automatically sets Semantic MediaWiki properties on pages. This may include creating subobjects. Please only use this template as intended. |
Description
This template formats the table entries in subpages of YNOproject:Badges. Besides adding markup and tags, it creates badge subobjects with a "Badge/Location" property that interacts with each location the badge appears in.
On the badge page you should already have a table that begins using {{badge/Start}}. The template is used after the table start. At the end of the last template usage, make sure to close the table with the |}
table end.
The "id" parameter is absolutely required for the template to work. However, it is hidden from the table itself, only present as a title when hovering over the badge name (or tapping on mobile). The most important parameters for the intended function of the template are the "id" and "Location" fields, so endevour to at least add those if possible.
Usage
The template creates a subobject with the id as a name. For example, using the template with |id = fc_moai
in page YNOproject:Badges/Yume Nikki
would create the subobject YNOproject:Badges/Yume Nikki#fc_moai
. The subobject is also given properties related to the badge.
Property | Function | Datatype |
---|---|---|
Badge/Author | Each author for a badge is listed as a value of this property. | Text |
Badge/BP | The number of Badge Points the badge awards. | Number |
Badge/Batch | The batch the badge was released in, taken from the ynobadges commits page. | Number |
Badge/Condition | The condition string of the badge, including any wiki markup. | Text |
Badge/Date | The date on which the badge was added to ynobadges: this may not be the day it was made available on the website. This is automatically filled in using {{Badge/Batch2Date}}. However, badges with batch 1 should specify date manually using |Date = in addition to the batch.
|
Date |
Badge/Description | The description of the badge, including any wiki markup. | Text |
Badge/Has parent | Sets to true for badges with the parent property in YNOproject, otherwise false.
|
Boolean |
Badge/Has secret condition | Sets to true for badges with the secretCondition property in YNOproject, otherwise false. If a badge has both secretCondition and secret , the trait should be omitted and the value would remain false.
|
Boolean |
Badge/Has secret map | Sets to true for badges with the secretMap property in YNOproject, otherwise false.
|
Boolean |
Badge/ID | The ID of the badge, same as the subobject name. | Text |
Badge/Icon | The icon of the badge. In many cases both an animated version (.gif) and a static version (.png) as separate values. | Page (in file namespace) |
Badge/Is hidden | Sets to true for badges with the hidden property in YNOproject, otherwise false.
|
Boolean |
Badge/Is secret | Sets to true for badges with the secret property in YNOproject, otherwise false.
|
Boolean |
Badge/Location | The location of the badge. Can be multiple. This lists the badge subobject as an incoming property of that location. | Page |
Badge/Name | The name of the badge as presented in YNOproject. | Text |
Badge/Parent | The badge ID of the parent badge, which is the value of the parent property in YNOproject.
|
Text |
Is part of game | The game the badge is from. Taken from the type/Namespace parameter, or from the subpage name by default. | Text |
Parameters
The badge template handles both subobject data and table row presentation.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Badge ID | id | The id of the badge, taken from https://github.com/ynoproject/ynobadges/tree/master/badges. | Line | required |
Icon(s) | Icon | The filename(s) of the badge to present in the table, without the "File:" prefix. If animated, put the gif first and separate using commas. Image files on the wiki usually have different names than on the YNOproject GitHub. | File | required |
Icon Background Override | Icon_bg | Set a hex code to use for the background of an icon cell, to potentially clear any visibility issues. | Line | optional |
Badge Name | Name | The name of the badge as presented in YNOproject itself, or as found in https://github.com/ynoproject/ynobadges/blob/master/lang/en.json. | Line | required |
BP | BP | The number of Badge Points the badge awards. | Number | optional |
Traits | Traits | Any traits the badge may have, such as hidden or secret. Separate multiple traits using commas. Possible values: Is hidden, Is Secret, Has secret condition, Has secret map, Has parent.
| Line | optional |
Secret Badge Parent | Parent | The badge ID of this badge's parent, if this badge has the trait "Has parent". | Line | optional |
Badge Location(s) | Location | The locations that the badge is found in, if any, without the namespace. Found on the website (the GitHub only provides Map IDs). | Page name | optional |
Description | Description | The description of the badge, if any. | Content | suggested |
Unlock Conditions | Condition | The condition of the badge, as found on the site or in https://github.com/ynoproject/ynobadges/blob/master/lang/en.json. | Content | required |
Notes | Notes | Any notes you wish to give regarding the badge. For example, you can point out a game reference that you spotted in the badge description. | Content | optional |
Badge Author(s) | Author | Badge artist names. If multiple, separate using the & symbol.
| Line | required |
Batch Number | Batch | The batch which contained the badge. Can be found in the badge file. For batch 1 badges, you may need to specify "Date" as well.
| Number | suggested |
Release Date | Date | Provide the date the badge was released if there is no batch number, or if the batch number may be inaccurate/not specific, such as for batch 1 badges.
| Date | optional |
Sample
Icon | Name | BP | 🌟 | Location | Description | Condition | Notes | Author | Date/Batch |
---|---|---|---|---|---|---|---|---|---|
Rain and Flowers | 15 | 🤐 🗺 |
Sky Garden: Crossover Garden | Visit the white tulip passage between Sky Garden and Ghost World | Badge name references a Yume Nikki remix of the same name. | wiki0dd | 2023-12-01 Batch 86 |
The table start and end are provided, as is necessary.