Difference between revisions of "Template:Recipe draw/doc"
From Captain of Industry Wiki
Thadius856 (talk | contribs) (update examples for code re-factor) |
(Added list of parameter and new example) |
||
(12 intermediate revisions by 3 users not shown) | |||
Line 2: | Line 2: | ||
:This template provides a method to rapidly illustrate crafting recipes without in-depth knowledge of wiki syntax or manual repetition/copy-pasting. | :This template provides a method to rapidly illustrate crafting recipes without in-depth knowledge of wiki syntax or manual repetition/copy-pasting. | ||
; | ;Basic usage | ||
:* | :The following 2 templates are provided for making a recipe. | ||
:**<code> | :*[[Template: Recipe define]]: Defines a recipe. The defined recipe can be called by [[Template: Recipe fetch]] from any page in this wiki. Usually, recipes are defined on the page of a building. This template only defines recipes but does not display anything. | ||
:* | :*[[Template: Recipe draw]]: Only displays a written recipe. The recipe written with this template cannot be called by [[Template: Recipe fetch]]. | ||
:* | :Both templates can be used with the format written in [[#Examples]] in this document. | ||
;Parameters | |||
:The template accepts the following parameters: | |||
:*<code>Building</code>: Name of buildings (example: Blast Furnace). No need to specify on pages using [[:Template:Infobox machine]] because the building is automatically detected. | |||
:*<code>Input1Name</code>, <code>Input2Name</code>, ..., <code>Input6Name</code>: Name of materials (example: Iron Ore) | |||
:**<code>Input1Name = Mining</code> (optional): Applies special format for mining. | |||
:*<code>Output1Name</code>, <code>Output2Name</code>, ... <code>Output6Name</code>: Name of products (example: Molten Iron) | |||
:**<code>Output1Name = Dumping</code> (optional): Applies special format for dumping. | |||
:*<code>Input1Qty</code>, ..., <code>Input6Qty</code>, <code>Output1Qty</code>, ..., <code>Output6Qty</code>: Amount of materials or products per 1 cycle of recipe. | |||
:*<code>Time</code>: Cycle time of recipe. | |||
:*<code>Input1Unit</code>, ..., <code>Input6Unit</code>, <code>Output1Unit</code>, ..., <code>Output6Unit</code> (optional): Adds unit (for Electricity and Mechanical Power) | |||
:*<code>HideBldg</code> (optional, rare): Hides building in recipe. No need to specify on pages using [[:Template:Infobox machine]] (the building is automatically hidden). | |||
:*<code>Unreleased = yes</code> (optional, rare): Applies special format for unreleased recipe | |||
;Limitations | ;Limitations | ||
:This template can accept up to 6 inputs, 6 outputs, and 1 time value per recipe. | :This template can accept up to 6 inputs, 6 outputs, and 1 time value per recipe. The output can include only 1 pollution. | ||
; | == Examples == | ||
;Example usage for mining: | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
| Mining | | Input1Name = Mining | ||
| Output1Name = Copper Ore | | Output1Name = Copper Ore | ||
}}</nowiki>| | }}</nowiki>| | ||
{{Recipe | {{Recipe | ||
| Mining | | Input1Name = Mining | ||
| Output1Name = Copper Ore | | Output1Name = Copper Ore | ||
}} | }} | ||
}} | }} | ||
;Example usage for dumping loose materials: | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
| Dumping | | Output1Name = Dumping | ||
| Input1Name = Rock | | Input1Name = Rock | ||
}}</nowiki>| | }}</nowiki>| | ||
{{Recipe | {{Recipe | ||
| Dumping | | Output1Name = Dumping | ||
| Input1Name = Rock | | Input1Name = Rock | ||
}} | }} | ||
}} | }} | ||
;Example usage for a machine with both inputs and outputs without pollution (most recipes): | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
Line 65: | Line 78: | ||
}} | }} | ||
;Example for buildings that "provide" materials ([[Groundwater Pump]], [[Air Separator]], etc.) | |||
{{markup|<nowiki> | |||
{{Recipe | |||
| Building = Groundwater Pump | |||
| Time = 10 | |||
| Output1Name = Water | |||
| Output1Qty = 8 | |||
}}</nowiki>| | |||
{{Recipe | |||
| Building = Groundwater Pump | |||
| Time = 10 | |||
| Output1Name = Water | |||
| Output1Qty = 8 | |||
}} | |||
}} | |||
;Example usage for dumping/flaring/venting ''non-polluting'' liquids/gasses: | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
Line 81: | Line 110: | ||
}} | }} | ||
;Example usage for recipe with pollution: | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
Line 88: | Line 117: | ||
| Input1Qty = 2 | | Input1Qty = 2 | ||
| Time = 2 | | Time = 2 | ||
| Output1Name = | | Output1Name = Water Pollution | ||
| Output1Qty = 2 | | Output1Qty = 2 | ||
}}</nowiki>| | }}</nowiki>| | ||
Line 96: | Line 125: | ||
| Input1Qty = 2 | | Input1Qty = 2 | ||
| Time = 2 | | Time = 2 | ||
| Output1Name = | | Output1Name = Water Pollution | ||
| Output1Qty = 2 | | Output1Qty = 2 | ||
}}|<nowiki> | |||
{{Recipe | |||
| Building = Exhaust Scrubber | |||
| Input1Name = Exhaust | |||
| Input1Qty = 30 | |||
| Input2Name = Water | |||
| Input2Qty = 4 | |||
| Time = 10 | |||
| Output1Name = Sulfur | |||
| Output1Qty = 1 | |||
| Output2Name = Carbon Dioxide | |||
| Output2Qty = 12 | |||
| Output3Name = Steam Lo | |||
| Output3Qty = 4 | |||
| Output4Name = Air Pollution | |||
| Output4Qty = 4 | |||
}}</nowiki>| | |||
{{Recipe | |||
| Building = Exhaust Scrubber | |||
| Input1Name = Exhaust | |||
| Input1Qty = 30 | |||
| Input2Name = Water | |||
| Input2Qty = 4 | |||
| Time = 10 | |||
| Output1Name = Sulfur | |||
| Output1Qty = 1 | |||
| Output2Name = Carbon Dioxide | |||
| Output2Qty = 12 | |||
| Output3Name = Steam Lo | |||
| Output3Qty = 4 | |||
| Output4Name = Air Pollution | |||
| Output4Qty = 4 | |||
}} | }} | ||
}} | }} | ||
;Example usage for Mechanical Power and Electricity recipes with units: | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
Line 127: | Line 188: | ||
}} | }} | ||
;Example usage for instantaneous recipes: | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
Line 134: | Line 195: | ||
| Input1Qty = 500 | | Input1Qty = 500 | ||
| Input1Unit = KW | | Input1Unit = KW | ||
| Time = | | Time = 0 | ||
| Output1Name = Electricity | | Output1Name = Electricity | ||
| Output1Qty = 250 | | Output1Qty = 250 | ||
Line 144: | Line 205: | ||
| Input1Qty = 500 | | Input1Qty = 500 | ||
| Input1Unit = KW | | Input1Unit = KW | ||
| Time = | | Time = 0 | ||
| Output1Name = Electricity | | Output1Name = Electricity | ||
| Output1Qty = 250 | | Output1Qty = 250 | ||
Line 151: | Line 212: | ||
}} | }} | ||
:Example usage for hiding the building (automatically happens on pages using [[:Template:Infobox machine]]): | ;Example usage for recipes with variable quantity: | ||
{{markup|<nowiki> | |||
{{Recipe | |||
| Building = Waste Collection | |||
| Time = 60 | |||
| Output1Name = Waste | |||
| Output1Unit = ? | |||
}}</nowiki>| | |||
{{Recipe | |||
| Building = Waste Collection | |||
| Time = 60 | |||
| Output1Name = Waste | |||
| Output1Unit = ? | |||
}} | |||
}} | |||
;Example usage for hiding the building (automatically happens on pages using [[:Template:Infobox machine]]): | |||
{{markup|<nowiki> | {{markup|<nowiki> | ||
{{Recipe | {{Recipe | ||
Line 181: | Line 258: | ||
}} | }} | ||
<includeonly>[[Category:Formatting templates]]</includeonly><!-- | ;Example usage for unreleased recipe | ||
--><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude> | {{markup|<nowiki> | ||
{{Recipe | |||
| Building = Crusher | |||
| Input1Name = Gravel | |||
| Input1Qty = 18 | |||
| Time = 20 | |||
| Output1Name = Gold | |||
| Output1Qty = 14 | |||
| Unreleased = yes | |||
}}</nowiki>| | |||
{{Recipe | |||
| Building = Crusher | |||
| Input1Name = Gravel | |||
| Input1Qty = 20 | |||
| Time = 20 | |||
| Output1Name = Gold | |||
| Output1Qty = 1 | |||
| Unreleased = yes | |||
}} | |||
}} | |||
{{Footer Cargo}} | |||
<includeonly> | |||
[[Category:Formatting templates]] | |||
[[Category:Cargo management templates]] | |||
</includeonly><!-- | |||
--><noinclude> | |||
[[Category:Template documentation|{{PAGENAME}}]] | |||
</noinclude> |
Latest revision as of 17:15, 3 October 2022
- Purpose
- This template provides a method to rapidly illustrate crafting recipes without in-depth knowledge of wiki syntax or manual repetition/copy-pasting.
- Basic usage
- The following 2 templates are provided for making a recipe.
- Template: Recipe define: Defines a recipe. The defined recipe can be called by Template: Recipe fetch from any page in this wiki. Usually, recipes are defined on the page of a building. This template only defines recipes but does not display anything.
- Template: Recipe draw: Only displays a written recipe. The recipe written with this template cannot be called by Template: Recipe fetch.
- Both templates can be used with the format written in #Examples in this document.
- Parameters
- The template accepts the following parameters:
Building
: Name of buildings (example: Blast Furnace). No need to specify on pages using Template:Infobox machine because the building is automatically detected.Input1Name
,Input2Name
, ...,Input6Name
: Name of materials (example: Iron Ore)Input1Name = Mining
(optional): Applies special format for mining.
Output1Name
,Output2Name
, ...Output6Name
: Name of products (example: Molten Iron)Output1Name = Dumping
(optional): Applies special format for dumping.
Input1Qty
, ...,Input6Qty
,Output1Qty
, ...,Output6Qty
: Amount of materials or products per 1 cycle of recipe.Time
: Cycle time of recipe.Input1Unit
, ...,Input6Unit
,Output1Unit
, ...,Output6Unit
(optional): Adds unit (for Electricity and Mechanical Power)HideBldg
(optional, rare): Hides building in recipe. No need to specify on pages using Template:Infobox machine (the building is automatically hidden).Unreleased = yes
(optional, rare): Applies special format for unreleased recipe
- Limitations
- This template can accept up to 6 inputs, 6 outputs, and 1 time value per recipe. The output can include only 1 pollution.
Examples
- Example usage for mining
Markup | Renders as |
---|---|
{{Recipe | Input1Name = Mining | Output1Name = Copper Ore }} |
|
- Example usage for dumping loose materials
Markup | Renders as |
---|---|
{{Recipe | Output1Name = Dumping | Input1Name = Rock }} |
|
- Example usage for a machine with both inputs and outputs without pollution (most recipes)
Markup | Renders as |
---|---|
{{Recipe | Building = Rotary Kiln | Input1Name = Limestone | Input1Qty = 12 | Input2Name = Coal | Input2Qty = 2 | Time = 10 | Output1Name = Cement | Output1Qty = 4 | Output2Name = Exhaust | Output2Qty = 8 }} |
|
- Example for buildings that "provide" materials (Groundwater Pump, Air Separator, etc.)
Markup | Renders as |
---|---|
{{Recipe | Building = Groundwater Pump | Time = 10 | Output1Name = Water | Output1Qty = 8 }} |
|
- Example usage for dumping/flaring/venting non-polluting liquids/gasses
Markup | Renders as |
---|---|
{{Recipe | Building = Smoke Stack | Input1Name = Oxygen | Input1Qty = 200 | Time = 20 }} |
|
- Example usage for recipe with pollution
Markup | Renders as |
---|---|
{{Recipe | Building = Liquid Dump | Input1Name = Waste Water | Input1Qty = 2 | Time = 2 | Output1Name = Water Pollution | Output1Qty = 2 }} |
|
{{Recipe | Building = Exhaust Scrubber | Input1Name = Exhaust | Input1Qty = 30 | Input2Name = Water | Input2Qty = 4 | Time = 10 | Output1Name = Sulfur | Output1Qty = 1 | Output2Name = Carbon Dioxide | Output2Qty = 12 | Output3Name = Steam Lo | Output3Qty = 4 | Output4Name = Air Pollution | Output4Qty = 4 }} |
|
- Example usage for Mechanical Power and Electricity recipes with units
Markup | Renders as |
---|---|
{{Recipe | Building = Low-pressure Turbine | Input1Name = Steam Lo | Input1Qty = 4 | Time = 5 | Output1Name = Mechanical Power | Output1Qty = 1 | Output1Unit = MW | Output2Name = Steam Depleted | Output2Qty = 4 }} |
|
- Example usage for instantaneous recipes
Markup | Renders as |
---|---|
{{Recipe | Building = Power Generator | Input1Name = Mechanical Power | Input1Qty = 500 | Input1Unit = KW | Time = 0 | Output1Name = Electricity | Output1Qty = 250 | Output1Unit = KW }} |
|
- Example usage for recipes with variable quantity
Markup | Renders as |
---|---|
{{Recipe | Building = Waste Collection | Time = 60 | Output1Name = Waste | Output1Unit = ? }} |
|
- Example usage for hiding the building (automatically happens on pages using Template:Infobox machine)
Markup | Renders as |
---|---|
{{Recipe | Building = Mixer | HideBldg = yes | Input1Name = Sand | Input1Qty = 18 | Input2Name = Limestone | Input2Qty = 4 | Input3Name = Salt | Input3Qty = 4 | Time = 20 | Output1Name = Glass Mix | Output1Qty = 14 }} |
|
- Example usage for unreleased recipe
Markup | Renders as |
---|---|
{{Recipe | Building = Crusher | Input1Name = Gravel | Input1Qty = 18 | Time = 20 | Output1Name = Gold | Output1Qty = 14 | Unreleased = yes }} |
|