×
Create a new article
Write your page title here:
We currently have 3,024 articles on YumeWiki. Type your article name above or click on one of the titles below and start writing!



YumeWiki
3,024Articles

Template:Badge/doc: Difference between revisions

mNo edit summary
(update)
Line 1: Line 1:
==Description==
==Description==
{{BadgeListNavbar}}
{{BadgeListNavbar}}
Formats the table entries in subpages of [[YNOproject:Badges]], useful as it creates badge subobjects that point a "Badge/Location" property to any locations the badge appears in. Also creates other properties that may be useful.<br>Technically there is no use for the template for YNOproject badges since they never have a location attached to them. You can still use it to auto-format the table row if you wish, but it's best to substitute the template then remove the subobject code, as that way you avoid lag.
Formats the table entries in subpages of [[YNOproject:Badges]]. It may be useful as it creates badge subobjects that point a "Badge/Location" property to any locations the badge appears in.
 
Technically there is no use for the template for YNOproject badges since they never have a location attached to them. You can still use it to auto-format the table row if you wish, but it's best to add normal table entries instead, to avoid lag.
 
==Syntax==
==Syntax==
On the badge page you should already have a table that begins like this:
On the badge page you should already have a table that begins using {{T|badge/Start}}.
<pre><nowiki>{| style="width: 100%;" cellspacing="0" cellpadding="4" border="1"
 
|-
The template is used after the table beginning. Here is an example input for a table with 1 entry:
| style="text-align: center;" |<u>'''Icon(s)'''</u>
<pre><nowiki>{{badge/Start}}
| style="text-align: center;" |<u>'''Name'''</u>
{{badge|type=Yume Nikki|
| style="text-align: center;" |<u>'''Location'''</u>
| style="text-align: center;" |<u>'''Description'''</u>
| style="text-align: center;" |<u>'''Condition(s)'''</u>
| style="text-align: center;" |<u>'''Note(s)'''</u>
| style="text-align: center;" |<u>'''Author(s)'''</u>
| style="text-align: center;" |<u>'''Release batch/Date'''</u></nowiki></pre>
The template is used after the table beginning. Here is an example input:
<pre><nowiki>{{badge|type=Yume Nikki|
|id = fc_moai
|id = fc_moai
|Icon = MoaiStatue(badgeYN).png
|Icon = MoaiStatue(badgeYN).png
Line 23: Line 18:
|Condition = Enter the moai head room in the FC Dungeon
|Condition = Enter the moai head room in the FC Dungeon
|Author = WikiOdd
|Author = WikiOdd
}}</nowiki></pre>
}}
Each badge entry should be written in that format. Note there are more parameters that were absent in the example as they were not needed (not every field is required).<br> The "id" parameter is '''absolutely required''' for the template to work, however, it is hidden from the table itself.<br>The most important parameters for the actual function of the template are the "id" and "Location" fields, so endevour to at least add those (if available). Normal wikitext for formatting a table should still work even if it is surrounded by the badge template calls. If a badge has no "Location" field then it would be OK to use this normal wikitext as the subobject the template creates would be useless anyways if no location is specified.<br><br>
|}</nowiki></pre>
Each badge entry should be written in that format. Note there are more parameters that were absent in the example as they were not needed (not every field is required).
 
The "id" parameter is '''absolutely required''' for the template to work. However, it is hidden from the table itself.
 
The most important parameters for the actual function of the template are the "id" and "Location" fields, so endevour to at least add those (if available). Normal wikitext for formatting a table should still work even if it is surrounded by the badge template calls. If a badge has no "Location" field then it would be OK to use this normal wikitext as the subobject the template creates would be useless anyways if no location is specified.
 
 
After adding all badges, make sure to end the table with:
After adding all badges, make sure to end the table with:
<pre><nowiki>|}</nowiki></pre>
<pre><nowiki>|}</nowiki></pre>
==Usage==
==Usage==
The template creates a subobject with the id as a name. For example, using the template with <code>id=fc_moai</code> 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.
The template creates a subobject with the id as a name. For example, using the template with <code>id=fc_moai</code> 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.
{| style="width: 100%;" cellspacing="0" cellpadding="4" border="1"
{| class="wikitable"
|-
|-
| style="text-align: center;" |<u>'''Property'''</u>
! style="text-align: center;" |<u>'''Property'''</u>
| style="text-align: center;" |<u>'''Function'''</u>
! style="text-align: center;" |<u>'''Function'''</u>
| style="text-align: center;" |<u>'''Datatype'''</u>
! style="text-align: center;" |<u>'''Datatype'''</u>
|-
|-
|[[Property:Badge/Author|Badge/Author]]
|[[Property:Badge/Author|Badge/Author]]
Line 42: Line 45:
|The icon of the badge. In many cases both an animated version (.gif) and a static version (.png) as separate values.
|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)''
|Page ''(in file namespace)''
|-
|[[Property:Badge/Game|Badge/Game]]
|The game the badge is from. Taken from the type/Namespace parameter, or from the subpage name by default.
|''TBA''
|-
|[[Property:Badge/ID|Badge/ID]]
|The ID of the badge, same as the subobject name.
|Text
|-
|-
|[[Property:Badge/Location|Badge/Location]]
|[[Property:Badge/Location|Badge/Location]]
Line 68: Line 79:
"aliases": ["Namespace"],
"aliases": ["Namespace"],
"type": "line",
"type": "line",
"description": "The wiki namespace the badge belongs to, which is used to format the wikilinks for the ''Location'' field. The location column is also removed if the namespace is set to YNOproject.",
"description": "The wiki namespace the badge belongs to, which is used to format the wikilinks for the ''Location'' field.",
"example": "Yume 2kki",
"example": "Yume 2kki",
"autovalue": "{{SUBPAGENAME}}",
"autovalue": "{{SUBPAGENAME}}",
Line 152: Line 163:
==Sample==
==Sample==
The example given in "Syntax" above would produce the following output:
The example given in "Syntax" above would produce the following output:
{| style="width: 100%;" cellspacing="0" cellpadding="4" border="1"
{{badge/Start}}
|-
{{badge|type=Yume Nikki|
| style="text-align: center;" |<u>'''Icon(s)'''</u>
|id = fc_moai
| style="text-align: center;" |<u>'''Name'''</u>
|Icon = MoaiStatue(badgeYN).png
| style="text-align: center;" |<u>'''Location'''</u>
|Name = Tomb of the Moai
| style="text-align: center;" |<u>'''Description'''</u>
|Location = FC Dungeon
| style="text-align: center;" |<u>'''Condition(s)'''</u>
|Description = What a nice statue!
| style="text-align: center;" |<u>'''Note(s)'''</u>
|Condition = Enter the moai head room in the FC Dungeon
| style="text-align: center;" |<u>'''Author(s)'''</u>
|Author = WikiOdd
| style="text-align: center;" |<u>'''Release batch/Date'''</u>
}}
|-
|-
|[[File:MoaiStatue(badgeYN).png|center|frameless]]
|Tomb of the Moai
|[[Yume Nikki:FC Dungeon|FC Dungeon]]
|What a nice statue!
|Enter the moai head room in the FC Dungeon
|style="background:#CDCDCD" ; |
|WikiOdd
|''TBA''
|}
|}
The table start and end are provided, as is necessary.
The table start and end are provided, as is necessary.
<noinclude>__NOTOC__ [[Category:Template Documentation]]</noinclude>
<noinclude>__NOTOC__ [[Category:Template Documentation]]</noinclude>
<includeonly>__NOEDITSECTION__</includeonly>
<includeonly>__NOEDITSECTION__</includeonly>

Revision as of 16:06, 8 August 2023

Description

Formats the table entries in subpages of YNOproject:Badges. It may be useful as it creates badge subobjects that point a "Badge/Location" property to any locations the badge appears in.

Technically there is no use for the template for YNOproject badges since they never have a location attached to them. You can still use it to auto-format the table row if you wish, but it's best to add normal table entries instead, to avoid lag.

Syntax

On the badge page you should already have a table that begins using {{badge/Start}}.

The template is used after the table beginning. Here is an example input for a table with 1 entry:

{{badge/Start}}
{{badge|type=Yume Nikki|
|id = fc_moai
|Icon = MoaiStatue(badgeYN).png
|Name = Tomb of the Moai
|Location = FC Dungeon
|Description = What a nice statue!
|Condition = Enter the moai head room in the FC Dungeon
|Author = WikiOdd
}}
|}

Each badge entry should be written in that format. Note there are more parameters that were absent in the example as they were not needed (not every field is required).

The "id" parameter is absolutely required for the template to work. However, it is hidden from the table itself.

The most important parameters for the actual function of the template are the "id" and "Location" fields, so endevour to at least add those (if available). Normal wikitext for formatting a table should still work even if it is surrounded by the badge template calls. If a badge has no "Location" field then it would be OK to use this normal wikitext as the subobject the template creates would be useless anyways if no location is specified.


After adding all badges, make sure to end the table with:

|}

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 for this property. 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/Game The game the badge is from. Taken from the type/Namespace parameter, or from the subpage name by default. TBA
Badge/ID The ID of the badge, same as the subobject name. Text
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/Is hidden Sets to true for badges with the hidden property in YNOproject. Boolean

Parameters

Template parameters

ParameterDescriptionTypeStatus
Badge IDid

The id of the badge, taken from https://github.com/ynoproject/ynobadges/tree/master/badges. Do not include the filename.

Example
akako
Linerequired
Badge Namespacetype Namespace

The wiki namespace the badge belongs to, which is used to format the wikilinks for the ''Location'' field.

Example
Yume 2kki
Auto value
{{SUBPAGENAME}}
Linesuggested
Badge Icon(s)Icon

The filename(s) of the badge to present in the table, without the ''File:'' prefix. If multiple, separate using commas. Note: image files on the wiki likely have different names than the files in the YNOproject github.

Default
TBA
Example
Akako Gif Bdg.gif, AkakoStill Bdg.png
Filesuggested
Badge NameName

The name of the badge as presented in YNOproject itself, or as found in https://github.com/ynoproject/ynobadges/blob/master/lang/en.json.

Default
Missing
Example
White Scarlet Akako
Linesuggested
Badge Location(s)Location

The locations that the badge is found in, if any, without the namespace. Found on the badge (the github only provides Map IDs).

Example
White Scarlet Exhibition
Page nameoptional
Badge DescriptionDescription

The description of the badge, if any.

Contentoptional
Badge ConditionsCondition

The condition of the badge, as found on the site or in https://github.com/ynoproject/ynobadges/blob/master/lang/en.json.

Default
Please add the condition of this badge!
Example
Show Akako in the White Scarlet Exhibition all of the effects she likes
Contentsuggested
NotesNotes

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.

Contentoptional
Badge Author(s)Author

Badge artist names. If multiple, separate using commas.

Default
Please add author credits!
Example
Rose
Stringsuggested
Release DateDate

The date the badge was released, preferably in the ISO YYYY-MM-DD format. Can be found by checking the commit history on github.

Default
value for Batch
Example
2023-07-08
Datesuggested
Batch NumberBatch

If there is no input for ''Date'', you can specify the batch number instead.

Default
TBA
Example
32
Numberoptional
Hidden Badge PropertyHidden

Set to ''true'' to signify the badge is hidden. Hidden badges have unique backgrounds, give no BP, and are not counted for certain milestones.

Default
false
Example
true
Booleanoptional
Icon Background OverrideIcon_bg

Set a hex code to use for the background of an ''Icon'' cell, to potentially clear any visibility issues.

Example
14c932
Lineoptional

Sample

The example given in "Syntax" above would produce the following output:

Icon Name BP 🌟 Location Description Condition Notes Author Date/Batch
MoaiStatue(badgeYN).png Tomb of the Moai FC Dungeon What a nice statue! Enter the moai head room in the FC Dungeon WikiOdd Unknown
Batch 

The table start and end are provided, as is necessary.