Template:MapLeagueInclusionTable/Header/doc

From comp.tf
< Template:MapLeagueInclusionTable/Header
Revision as of 02:35, 26 September 2015 by Garlic (talk | contribs) (Finished documentation)
Jump to navigation Jump to search

This table was made to show a map's inclusions in the map pool of various leagues and in various seasons. The first two sections of this documentation are best for providing a basic overview for how to make a template; the rest goes more in depth of the specifics of each template.

Associated templates

The current templates associated with creating a Map League Inclusion Table are:

These templates can also be found in Category:MapLeagueInclusionTable Base Templates.

General information

  • All parameters are in lowercase characters
  • The generic makeup of a table consists of 1 Header, at least 1 Row, 1 Footer, 1 Note (optional) and 1 Key (optional)
  • The current leagues available to include are UGC (4v4), UGC (6v6), ETF2L (6v6), ESEA (6v6), Ozfortress Winter League (6v6), UGC (HL) and ETF2L (HL)
  • Any parameter with "ozf6s" denotes the Ozfortress Winter League (OWL)

Full table example

{{MapLeagueInclusionTable/Header
 | ugc4s = 1
 | esea6s = 1
 | ozf6s = 1
 | etf2lhl = 1
}}
{{MapLeagueInclusionTable/Row
 | maptype = pro
 | mapdownload = comp.tf
 | mapdownloadnote = 1
 | mapname = cp_cheeseburger_pro_v42
 | maprowspan = 1
 | ugc4s = 5
 | esea6s = 0
 | ozf6s = 14
 | etf2lhl = 7
}}
{{MapLeagueInclusionTable/Row
 | maptype = valve
 | mapname = cp_cheeseburger
 | maplink = Main Page
 | maprowspan = 1
 | ugc4s = 4
 | esea6s = 17
 | ozf6s = 0
 | etf2lhl = 0
}}
{{MapLeagueInclusionTable/Footer
 | ugc4s = 2
 | esea6s = 1
 | ozf6s = 1
 | etf2lhl = 1
}}{{MapLeagueInclusionTable/Key
 | caption = 1
 | valve = 1
 | pro = 1
}}{{MapLeagueInclusionTable/Note
 | number = 1
 | content = Map download is in .bz2 format
}}

Will yield:

Template:MapLeagueInclusionTable/RowTemplate:MapLeagueInclusionTable/Row
Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Total inclusions 2 out of 28 out of 41 out of 46 1 out of 30 1 out of 38 out of 21 out of 13 out of 10 out of 39 1 out of 30 out of 16

Template:MapLeagueInclusionTable/KeyTemplate:MapLeagueInclusionTable/Note

"Note" parameters

The term "note" can be added onto the end of any parameter followed by a number which will then display said number in superscript, then referenced below the table with the Template:MapLeagueInclusionTable/Note template. Potential note parameters are referenced in their individual sections.
Note: numbers should be consecutively ordered from top left of the table to bottom right.

Example

{{MapLeagueInclusionTable/Header
 | etf2l6s = 1
 | etf2l6snote = 1
}}
{{MapLeagueInclusionTable/Row
 | maptype = normal
 | mapdownload = http://fastdl.colonslash.eu/maps/cp_freight_b3.bsp.bz2
 | mapdownloadnote = 2
 | mapname = cp_freight_b3
 | etf2l6s = 4
 | etf2l6snote = 3
}}
{{MapLeagueInclusionTable/Footer
 | etf2l6s = 1
}}{{MapLeagueInclusionTable/Note
 | number = 1
 | content = ETF2L is a big league
}}{{MapLeagueInclusionTable/Note
 | number = 2
 | content =  Map download is in .bz2 format
}}{{MapLeagueInclusionTable/Note
 | number = 3
 | content = Wowie this is the 4th season of ETF2L
}}

Will yield:

Template:MapLeagueInclusionTable/Row
Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Total inclusions out of 28 out of 41 1 out of 46 out of 30 out of 38 out of 21 out of 13 out of 10 out of 39 out of 30 out of 16

Template:MapLeagueInclusionTable/NoteTemplate:MapLeagueInclusionTable/NoteTemplate:MapLeagueInclusionTable/Note

Header

The header defines what leagues will be included, displayed as columns in the table.

Parameters

The following are all potential parameters, and therefore leagues, that can be used:
|ugc4s, |ugc6s, |etf2l6s, |esea6s, |ozf6s, |ugchl, and |etf2lhl
Setting a "1" value to these parameters will display a league as a column.

Note parameters

Excluding the above parameters, the other note parameters are: |mapnamenote, |4v4note, |6v6note, and |highlandernote

Example

{{MapLeagueInclusionTable/Header
 | ugc6s = 1
 | etf2l6s = 1
 | esea6s = 1
 | ozf6s = 1
 | ugchl = 1
}}
|}

Will yield:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL

Row

Note: The row template cannot be used for multiple rows, only one horizontal row.

Header cell

The header cell of the row contains any information not involving each seasonal inclusion; namely the map's type, name, download link, wiki page link and rowspan.

Parameters

|maptype - The coloured ribbon which indicates the map's type. The map type parameter must be set to a value, it can be set to:

  • normal - Sets the ribbon colour to the background colour of the table, making the ribbon invisible
  • valve - Sets the ribbon colour to grey (#4F4F4F)
  • pro - Sets the ribbon colour to green (#F2F2F2)

|mapname - The file name for the map version. Any set value will appear as bold.
|mapdownload - The download link for the map version.
|maplink - The wiki page the map name will link to. Should only be used for similar maps that are used in the same Inclusion Table (e.g. cp_granary and cp_granary_pro)
|maprowspan - The rowspan for the entire row, should be set to the maximum amount of inclusions in a single league for the row's map version. Must be set to a value (can be set to 1), and if set to more that one the respective following rows will not need a header cell (e.g. if set to 3, the next 2 row will not need header cells).

Note parameters

The only two note parameters for the header cell of a row are:
|mapnamenote and |mapdownloadnote

Information cells

The information cells of the row contains each seasonal inclusion for a map.

Parameters

|ugc4s, |ugc6s, |etf2l6s, |esea6s, |ozf6s, |ugchl, and |etf2hl These parameters should be set to the season numbers the map version of the row is included in. They will automatically link to any associated season page on the wiki.
There are no additional note parameters.

Important notes

  • These parameters cannot be left without a value. If there is not seasonal inclusion, setting the parameter to 0 will leave it blank.
  • If adding a row to an existing table, information from the following row may have to be transferred to the added row in order to keep the table correct.
  • Seasonal inclusions for a map version with multiple rows should always be pushed to the top. For example:
Template:MapLeagueInclusionTable/RowTemplate:MapLeagueInclusionTable/Row|} Is incorrect, as the ESEA6s column has an inclusion at the bottom of the row. The following is a correct version:
Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Template:MapLeagueInclusionTable/RowTemplate:MapLeagueInclusionTable/Row|}

Example

{{MapLeagueInclusionTable/Header
 | ugc4s = 1
 | esea6s = 1
 | ozf6s = 1
 | etf2lhl = 1
}}
{{MapLeagueInclusionTable/Row
 | maptype = pro
 | mapdownload = comp.tf
 | mapdownloadnote = 1
 | mapname = cp_cheeseburger_pro_v42
 | maprowspan = 2
 | ugc4s = 5
 | esea6s = 0
 | ozf6s = 14
 | etf2lhl = 7
}}
{{MapLeagueInclusionTable/Row
 | ugc4s = 4
 | esea6s = 0
 | ozf6s = 13
 | etf2lhl = 0
}}
{{MapLeagueInclusionTable/Row
 | maptype = valve
 | mapname = cp_cheeseburger
 | mapnamenote = 2
 | maplink = Main Page
 | maprowspan = 1
 | ugc4s = 3
 | ugc4snote = 3
 | esea6s = 17
 | ozf6s = 0
 | etf2lhl = 0
}}
|}
Will yield:
Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Template:MapLeagueInclusionTable/RowTemplate:MapLeagueInclusionTable/RowTemplate:MapLeagueInclusionTable/Row
Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL

Footer

The footer shows the total inclusions of a map in each individual league. The total overall seasons (second value shown) is calculated automatically.

Parameters

The following are all potential parameters, and therefore leagues, that can be used:
|ugc4s, |ugc6s, |etf2l6s, |esea6s, |ozf6s, |ugchl, and |etf2lhl
Setting any value to these parameters will display that value as the total number of seasonal inclusions for a league.

Note parameters

Excluding the above parameters, the other note parameters are: |totalinclusionsnote, |ugc4stotalseasonsnote, |ugc6stotalseasonsnote, |etf2l6stotalseasonsnote, |esea6stotalseasonsnote, |ozf6stotalseasonsnote, |ugchltotalseasonsnote, and |etf2lhltotalseasonsnote

Example

{{MapLeagueInclusionTable/Header
 | ugc6s = 1
 | etf2l6s = 1
 | esea6s = 1
 | ozf6s = 1
 | ugchl = 1
}}
{{MapLeagueInclusionTable/Footer
 | ugc6s = 9
 | etf2l6s = 7
 | esea6s = 4
 | ozf6s = 4
 | ugchl = 3
}}

Will yield:

Seasonal Inclusions by League
[view] Map version 4v4 6v6 Prolander Highlander
UGC-Icon2.png UGC UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L EseaLogo.png ESEA Ozfortress Icon.png ozfortress RGL Icon.png RGL AsiaFortress-Icon.png AsiaFortress RGL Icon.png RGL UGC-Icon2.png UGC ETF2L-Icon2.png ETF2L RGL Icon.png RGL
Total inclusions out of 28 9 out of 41 7 out of 46 4 out of 30 4 out of 38 out of 21 out of 13 out of 10 3 out of 39 out of 30 out of 16

Key

The key section is a legend to explain colours/text formatting used in the table.

Parameters

|caption
Setting a "1" value to this parameter will display explaining italic bold text (indicating a current or latest season).
|valve
Setting a "1" value to this parameter will display a table with the official map colour code partnered with text (explaining colour coding for official maps).
|pro
Setting a "1" value to this parameter will display a table with the adapted colour code partnered with text (explaining colour coding for adapted or "pro" maps).

There are no additional note parameters.

Example

{{MapLeagueInclusionTable/Key
 | caption = 1
 | valve = 1
 | pro = 1
}}

Will yield:

Template:MapLeagueInclusionTable/Key

Notes

The notes section contains points of clarification that are previously referenced in the table.

A common note is: Map download is in .bz2 format, cited in the table with the |mapdownloadnote parameter.

Parameters

|number
Setting any value to this parameter will display the value in superscript.
|content
Setting text to this parameter will display the content of the note (what is being referenced/clarified) in small text.

There are no note parameters for this template.

Example

{{MapLeagueInclusionTable/Note
 | number = 1
 | content = ETF2L is a big league
}}{{MapLeagueInclusionTable/Note
 | number = 2
 | content =  Map download is in .bz2 format
}}{{MapLeagueInclusionTable/Note
 | number = 3
 | content = Wowie this is the 4th season of ETF2L
}}

Will yield:

Template:MapLeagueInclusionTable/NoteTemplate:MapLeagueInclusionTable/NoteTemplate:MapLeagueInclusionTable/Note