Difference between revisions of "Template:CommoditiesRatioTable/row/doc"

From Stoneshard wiki
Jump to navigation Jump to search
m
m (Add Tabber implementation example.)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{doc/start}}
{{doc/start}}{{stub}}
 
'''{{c|+|THIS TEMPLATE HAS BEEN UPDATED TO WORK WITH [[Friendly data|FRIENDLY DATA]].}}'''<br>
'''{{c|+|ALONG WITH THE [[CommoditiesRatio data|COMMODITIESRATIO DATA]], UPDATED TO THE [[Friendly data|FRIENDLY DATA]] PAGE!}}'''
 
This is the template for the Commodities Ratio Table. It is used to generate the table on the [[Commodities]] page.
 
==Updates==
 
Firstly, the data found in the old temporary [[CommoditiesRatio data]] page, was added to the [[Friendly data]] page.<br>
'''Therefore, NPCs that had the "Trade=1" parameter, and trade [[Commodities|commodities]] received a new parameter: "Ratios"'''.<br>
They were also adjusted from the older order to the new one.<br>
 
===Data Format===
The new datastring order has 7 data columns separated by semicolons. Each column represents the Ratio of said commodity for a specific NPC.<br>
 
'''Sacks of Grain;Barrel of Beer;Crates of Wine;Pails of Cider;Shipment of Timber;Crates of Charcoal;Sacks of Salt'''
 
The columns are in the following order:
 
    OLD ORDER: Grain;Charcoal;Salt;Timber;Beer;Wine;Cider
    OLD Base : 280  ;300    ;400 ;240  ;240 ;360 ;300
 
    NEW ORDER: Grain;Beer;Wine;Cider;Timber;Charcoal;Salt
    NEW Base : 280  ;240 ;360 ;300  ;240  ;300    ;400


==Usage==
==Usage==
Before, there was the possibility to have different "head|{x}" usages. But, after the "Tabber" implementation, there was really no need for multiple parameters.<br>
The idea was to simplify the template to simply {{tl|CommoditiesRatioTable}}, and "control" it with "Tabber", to show specific towns NPCs. But tabber would end up requiring repeated code blocks, therefore killing the purpouse of it.<br>So the {{tl|CommoditiesRatioTable/head}} & {{tl|CommoditiesRatioTable/row}} templates, where kept.


{{tl|CommoditiesRatioTable/head|town=Osbrook}}*<br>
{{tl|CommoditiesRatioTable/row|Osbrook|Brukk}}
*head can use -> |town=Osbrook


==Examples==
==Examples==
=== Previous usage ===
===Header & row===
{{CommoditiesRatioTable/head|town=Osbrook}}
{{CommoditiesRatioTable/head}}
{{CommoditiesRatioTable/row|Osbrook|Brukk}}
{{CommoditiesRatioTable/row|Bert}}
{{CommoditiesRatioTable/row|Osbrook|Bert}}
{{CommoditiesRatioTable/row|Osbrook|Jurg}}
{{CommoditiesRatioTable/row|Osbrook|Jebar}}
|}
|}


=== New implementation ===
=== New implementation ===
The new implementation used in [[Commodities]], do not define 'town' and uses the <tabber> parser tag, in the page itself, instead of the template.<br>
The new implementation used in [[Commodities]], do not define 'town' and uses the "tabber" parser tag, in the page itself, instead of the template.<br>
More information on the <tabber> parser tag, can be found in the [[Stoneshard_wiki:Community_portal|Community Portal]], under "Tabs".
More information on the "tabber" parser tag, can be found in the [[Stoneshard_wiki:Community_portal|Community Portal]], under "Tabs".
{{CommoditiesRatioTable/head}}
{{CommoditiesRatioTable/head}}
{{CommoditiesRatioTable/row|Osbrook|Brukk}}
{{CommoditiesRatioTable/row|Bert}}
{{CommoditiesRatioTable/row|Osbrook|Bert}}
|}
|}


=== Updated usage ===
=== With Tabber implementation ===
<tabber>
|-| Commodities Ratios =
{{#tag:tabber
| All =
{{CommoditiesRatioTable/head}}
{{CommoditiesRatioTable/head}}
{{CommoditiesRatioTable/row|Brukk}}
{{CommoditiesRatioTable/row|Bert}}
{{CommoditiesRatioTable/row|Bert}}
{{CommoditiesRatioTable/row|Jurg}}
{{CommoditiesRatioTable/row|Arenn}}
{{CommoditiesRatioTable/row|Jebar}}
{{!}}-{{!}} Osbrook =
|}
{{CommoditiesRatioTable/head}}
 
{{CommoditiesRatioTable/row|Bert}}
{{!}}-{{!}} Mannshire =
{{CommoditiesRatioTable/head}}
{{CommoditiesRatioTable/row|Arenn}}
}}
</tabber>
{{doc/end}}
{{doc/end}}

Latest revision as of 23:01, 26 April 2025

Template-info.png Documentation

This article is a stub. You can help Stoneshard wiki by expanding it.

THIS TEMPLATE HAS BEEN UPDATED TO WORK WITH FRIENDLY DATA.
ALONG WITH THE COMMODITIESRATIO DATA, UPDATED TO THE FRIENDLY DATA PAGE!

This is the template for the Commodities Ratio Table. It is used to generate the table on the Commodities page.

Updates

Firstly, the data found in the old temporary CommoditiesRatio data page, was added to the Friendly data page.
Therefore, NPCs that had the "Trade=1" parameter, and trade commodities received a new parameter: "Ratios".
They were also adjusted from the older order to the new one.

Data Format

The new datastring order has 7 data columns separated by semicolons. Each column represents the Ratio of said commodity for a specific NPC.

Sacks of Grain;Barrel of Beer;Crates of Wine;Pails of Cider;Shipment of Timber;Crates of Charcoal;Sacks of Salt

The columns are in the following order:

   OLD ORDER: Grain;Charcoal;Salt;Timber;Beer;Wine;Cider
   OLD Base : 280  ;300     ;400 ;240   ;240 ;360 ;300
   NEW ORDER: Grain;Beer;Wine;Cider;Timber;Charcoal;Salt
   NEW Base : 280  ;240 ;360 ;300  ;240   ;300     ;400

Usage

Before, there was the possibility to have different "head|{x}" usages. But, after the "Tabber" implementation, there was really no need for multiple parameters.
The idea was to simplify the template to simply {{CommoditiesRatioTable}}, and "control" it with "Tabber", to show specific towns NPCs. But tabber would end up requiring repeated code blocks, therefore killing the purpouse of it.
So the {{CommoditiesRatioTable/head}} & {{CommoditiesRatioTable/row}} templates, where kept.


Examples

Header & row

NPCs Sacks of Grain Barrel of Beer Crates of Wine Pails of Cider Shipment of Timber Crates of Charcoal Sacks of Salt
Bert.png
Bert
- 1.21 1.21 1.21 1.16 1.16 1.32

New implementation

The new implementation used in Commodities, do not define 'town' and uses the "tabber" parser tag, in the page itself, instead of the template.
More information on the "tabber" parser tag, can be found in the Community Portal, under "Tabs".

NPCs Sacks of Grain Barrel of Beer Crates of Wine Pails of Cider Shipment of Timber Crates of Charcoal Sacks of Salt
Bert.png
Bert
- 1.21 1.21 1.21 1.16 1.16 1.32

With Tabber implementation

NPCs Sacks of Grain Barrel of Beer Crates of Wine Pails of Cider Shipment of Timber Crates of Charcoal Sacks of Salt
Bert.png
Bert
- 1.21 1.21 1.21 1.16 1.16 1.32
Arenn.png
Arenn
1.1 1.26 - - - - 1.21
NPCs Sacks of Grain Barrel of Beer Crates of Wine Pails of Cider Shipment of Timber Crates of Charcoal Sacks of Salt
Bert.png
Bert
- 1.21 1.21 1.21 1.16 1.16 1.32
NPCs Sacks of Grain Barrel of Beer Crates of Wine Pails of Cider Shipment of Timber Crates of Charcoal Sacks of Salt
Arenn.png
Arenn
1.1 1.26 - - - - 1.21