Difference between revisions of "Template:Block/doc"

From Industrial-Craft-Wiki
Jump to navigation Jump to search
m (Added word "minimum")
m (→‎Transcluding block pages: Fixed examples, although the actual point of doing it is beyond me)
 
(2 intermediate revisions by one other user not shown)
Line 23: Line 23:
|maxeu=
|maxeu=
|storage=
|storage=
|eu_use=
|eu_use2=
|tool=
|tool=
|stackable=
|stackable=
Line 32: Line 34:
Please note the unusual markup at the beginning and end; copy it verbatim if you are creating a new block page. Also note that if the item has multiple data values, use <code><nowiki>|multipledata=</nowiki></code> instead of <code><nowiki>|data=</nowiki></code>. See below:
Please note the unusual markup at the beginning and end; copy it verbatim if you are creating a new block page. Also note that if the item has multiple data values, use <code><nowiki>|multipledata=</nowiki></code> instead of <code><nowiki>|data=</nowiki></code>. See below:


'''New parameters are marked in bold.'''
{| class=grid style="background-color: transparent;"
{| class=grid style="background-color: transparent;"
! Parameter
! Parameter
Line 39: Line 42:
| <code>title</code> || Only needed to change the title from the page name || <code><nowiki>{{BASEPAGENAME}}</nowiki></code>
| <code>title</code> || Only needed to change the title from the page name || <code><nowiki>{{BASEPAGENAME}}</nowiki></code>
|-
|-
| <code>image</code> || Image of the block (should be approx. 150x150px) || <code><nowiki>{{BASEPAGENAME}}.png</nowiki></code> if it exists, otherwise [[:File:No block image.png|No block image.png]] (linking to the page where to opload the missing image)
| <code>image</code> || Image of the block (should be approx. 150x150px) || <code><nowiki>{{BASEPAGENAME}}_ig.png</nowiki></code> if it exists, otherwise [[:File:No block image.png|No block image.png]] (linking to the page where to opload the missing image)
|-
|-
| <code>image2</code> || Second image for two-state blocks (also approx. 150x150px) || ''None''
| <code>image2</code> || Second image for two-state blocks (also approx. 150x150px) || ''None''
Line 55: Line 58:
| <code>type</code> || Type (solid block, solid, block, or fluid) || ?
| <code>type</code> || Type (solid block, solid, block, or fluid) || ?
|-
|-
| <code>gravity</code> || Affected by gravity? || ?
| <code>dirt</code> || Requires sunlight/dirt? || ''None''
|-
| <code>maxeu</code> || '''Maximum operating EU before this block explodes.''' || ''None''
|-
| <code>storage</code> || '''How much EU this block can store.''' || ''None''
|-
|-
| <code>dirt</code> || Requires sunlight/dirt? || ''None''
| <code>eu_use</code> || '''EU use per tick.''' || ''None''
|-
|-
| <code>maxeu</code> || Maximum operating EU before this block explodes. ||
| <code>eu_use2</code> || Additional detail line || ''None''
|-
|-
| <code>tool</code> || Minimum tool to use || ?
| <code>tool</code> || Minimum tool to use || ?
Line 82: Line 89:
! Result
! Result
|-
|-
| <code><nowiki>{{Safe get|Cobblestone|tntres}}</nowiki></code>
| <code><nowiki>{{Safe get|Macerator|tntres}}</nowiki></code>
| {{Safe get|Cobblestone|tntres}}
| {{Safe get|Macerator|tntres}}
|-
|-
| <code><nowiki>{{Safe get|Cobblestone|tool}}</nowiki></code>
| <code><nowiki>{{Safe get|Macerator|tool}}</nowiki></code>
| {{Safe get|Cobblestone|tool}}
| {{Safe get|Macerator|tool}}
|-
|-
| <code><nowiki>[[File:{{Safe get|Cobblestone|image}}]]</nowiki></code>
| <code><nowiki>[[File:{{Safe get|Macerator|image}}]]</nowiki></code>
| [[File:{{Safe get|Cobblestone|image}}]]
| [[File:{{Safe get|Macerator|image}}]]
|-
|-
| <code><nowiki>{{Safe get|Cobblestone|non-existing field}}</nowiki></code>
| <code><nowiki>{{Safe get|Macerator|non-existing field}}</nowiki></code>
| {{Safe get|Cobblestone|non-existing field}}
| {{Safe get|Macerator|non-existing field}}
|-
|-
| <code><nowiki>{{Safe get|Main Page|tntres}}</nowiki></code>
| <code><nowiki>{{Safe get|Main Page|tntres}}</nowiki></code>

Latest revision as of 12:41, 21 February 2015

Template-info.png Documentation
Block
Picture na.png
Properties
Type ?




Stackable Yes (64)






Technical Details
UU Cost {{{uu_cost}}}
First appearance ?
ID IC2:{{{id}}}


This template provides a uniform design for block pages.

<onlyinclude>{{ {{{1|Block}}}
|title=
|image=
|image2=
|image3=
|invimage=
|invimage2=
|invimage3=
|invimage4=
|type=
|dirt=
|maxeu=
|storage=
|eu_use=
|eu_use2=
|tool=
|stackable=
|data=
|fluidspeed=
|movespeed=
}}</onlyinclude>

Please note the unusual markup at the beginning and end; copy it verbatim if you are creating a new block page. Also note that if the item has multiple data values, use |multipledata= instead of |data=. See below:

New parameters are marked in bold.

Parameter Function Default value
title Only needed to change the title from the page name {{BASEPAGENAME}}
image Image of the block (should be approx. 150x150px) {{BASEPAGENAME}}_ig.png if it exists, otherwise No block image.png (linking to the page where to opload the missing image)
image2 Second image for two-state blocks (also approx. 150x150px) None
image3 Third image for three-state blocks (also approx. 150x150px) None
invimage Image for object in inventory. Can use None to force no invimage. Uses styling and images from Template:Grid/Available images Grid {{BASEPAGENAME}}.png if it exists, otherwise None
invimage2 Second image for two-state objects in inventory. Uses styling and images from Template:Grid/Available images None
invimage3 Third image for three-state objects in inventory. Uses styling and images from Template:Grid/Available images None
invimage4 Fourth image for four-state objects in inventory. Uses styling and images from Template:Grid/Available images None
type Type (solid block, solid, block, or fluid) ?
dirt Requires sunlight/dirt? None
maxeu Maximum operating EU before this block explodes. None
storage How much EU this block can store. None
eu_use EU use per tick. None
eu_use2 Additional detail line None
tool Minimum tool to use ?
stackable Stackable N/A
data Single decimal data value None
multipledata Multiple decimal data values, use {{dv}} None
fluidspeed Speed of fluid movement None
movespeed Speed of walking through None

Transcluding block pages[edit]

The unusual header <onlyinclude>{{ {{{1|Block}}} and footer are there so that block pages can be transcluded (used like templates) into other pages. Specifically, this allows the use of {{Safe get}} to get specific data fields out of the infobox header in the block page. Here's some examples:

Code Result
{{Safe get|Macerator|tntres}} ERROR: Macerator does not properly transclude Template:Block
{{Safe get|Macerator|tool}} ERROR: Macerator does not properly transclude Template:Block
[[File:{{Safe get|Macerator|image}}]] [[File:ERROR: Macerator does not properly transclude Template:Block]]
{{Safe get|Macerator|non-existing field}} ERROR: Macerator does not properly transclude Template:Block
{{Safe get|Main Page|tntres}} ERROR: Main Page does not properly transclude Template:Block

Although transcluding non-template pages is somewhat unusual, doing it this way allows all the data properties for a block to be defined in the infobox header, next to each other, and right where most people will think to look for them. At the same time, it allows us to make tables of values for things like Blast Resistance and Hardness that auto-update whenever the main values are changed.

See {{Blast Resistance Table}} for a simple example of how to use this functionality to automatically build tables.

See also[edit]

This is the documentation page, it should be transcluded into the main template page. See Template:Doc for more information.