Edytujesz Szablon:Schematic/opis

{{doc/start}}
{{Schematic
|caption='''Schematic of 3-clock'''<br />{{Schematic help}}
|input|+|le-e!|SB|rd-ew!|rd-ew!|-
|output|+|rr-w1|rt-n|rr-e2|SB
}}
This template displays a grid of block sprites to symbolically represent a ''Minecraft'' structure (primarily redstone circuits and mechanisms).

== Usage ==

Schematic uses unnamed parameters to define the sprites used in the schematic, and named parameters to modify the schematic's default appearance:

 <nowiki>{{Schematic
|caption=<caption>
|captionstyle=<captionstyle>
|clear=<clear>
|float=<float>
|size=<size>
|style=<style>
|tablestyle=<tablestyle>
|<param1>|<param2>|…
}}</nowiki>

;caption
:The optional ''caption'' parameter may be added to create a caption under the schematic. Adding a caption automatically also creates a box surrounding the schematic and caption, and floats the box to page right. The [[Minecraft Wiki:redstone style guide|redstone style guide]] recommends adding <code><nowiki>{{Schematic help}}</nowiki></code> at the end of the caption of the first schematic in an article (and to others if helpful), which adds a standardized link to the [[Help:Schematic|schematic help page]].

;captionstyle
:The optional ''captionstyle'' parameter may be added to change the appearance of the caption area and contents. Its value should be a [[wikipedia:css|css]] declaration or declaration group with no surrounding braces or quotes (e.g., <code>captionstyle=color: red; text-align: center;</code>). This parameter has no effect if ''caption'' and ''float'' are not specified.

;clear
:The optional ''clear'' parameter may be added to force the schematic to drop below other floated elements. Its value may be <code>left</code> (to drop below only left-floated elements), <code>right</code> (to drop below only right-floated elements), <code>both</code> (to drop below  all floated elements), or <code>none</code> (the default).

;float
:The optional ''float'' parameter may be added to change the side to which the schematic floats if a caption is added. The only value recognized is <code>left</code> -- anything else defaults back to floating to the right.

::A schematic with no ''caption'' or ''float'' parameters acts like any other wiki table, ending the previous line and pushing subsequent text to a new line.

;size
:The optional ''size'' parameter may be added to specify the width and height of the sprite cells in pixels. Its value should be a simple number with no units added (e.g., <code>size=16</code>). If omitted, size defaults to 32.

;style
:The optional ''style'' parameter may be added to change the appearance of the schematic's surrounding box. Its value should be a [[wikipedia:css|css]] declaration or declaration group with no surrounding braces or quotes (e.g., <code>style=background-color: yellow;</code>). This parameter has no effect if ''caption'' and ''float'' are not specified.

;tablestyle
:The optional ''tablestyle'' parameter may be added to change the appearance of the schematic table. Its value should be a [[wikipedia:css|css]] declaration or declaration group with no surrounding braces or quotes (e.g., <code>tablestyle=background-color: green;</code>).

;param
:The ''param'' parameters specify the content of the schematic. When multiple ''param''s are defined, the resulting sprites or text are displayed in individual table cells, one after the other, unless a plus sign is used to stack them in the same cell.

[[File:SchematicSprite.png|thumb|Sprite sheet for Schematic]]
:* A ''sprite identifier'' (see [[#List of identifiers|list below]]) displays a sprite from the image on the right.
:* A ''plus sign'' (<code>+</code>) indicates that the next parameter should be stacked on top of the previous parameter, rather than starting a new cell.
:* A ''dash'' (<code>-</code>) starts a new row.
:* Anything else is simply displayed as center-aligned text within the cell's bounding box (empty parameters or whitespace parameters are displayed as empty cells).
:** Overflow text is not displayed, so this is primarily intended to be used to display one or two characters in a schematic (such as input and output locations, feature markers to be referenced in text, numbers representing light levels or distance, etc.).
:** [[wikipedia:List_of_XML_and_HTML_character_entity_references|HTML character entity references]] may be needed for some characters, such as <code>&amp;#124;</code> for the pipe character: <code>|</code>, <code>&amp;#61;</code> for an equals sign, <code>&amp;#43;</code> for a plus sign (to be displayed as text rather than stacking the next param), or <code>&amp;#45;</code> for a dash (to be displayed as text rather than starting a new row).  <code>&amp;#x305;</code> after a letter will provide a "combining overline" over the letter (used to indicate an inverse signal such as Q&#x305;).

=== Considerations ===

Overuse of the schematic template can create a high server load, resulting in long page generation times or even a time-out failure. This server load is proportional to the number of schematic cells on a page (for example, one 100-cell schematic and ten 10-cell schematics produce roughly the same server load). When the number of schematic cells on a page start to exceed a few hundred (or fewer, with other high-load templates), consider using {{tl|LoadBox}} or {{tl|LoadPage}} to offload some or all schematics into user-requested subpages.

{| class="wikitable"
! Code
! Produces:
|-
|
 <nowiki>{{Schematic
|input|+|A|rd-sw|air|air|-
|rd-nse|rs-e|rd-ew|output|+|O|-
|rd-nse|rs-e|SB||-
|input|+|B|rd-nw|air|air
}}</nowiki>
 
 <nowiki>'''XOR Gate'''</nowiki>
|
{{Schematic
|input|+|A|rd-sw|air|air|-
|rd-nse|rs-e|rd-ew|output|+|O|-
|rd-nse|rs-e|SB||-
|input|+|B|rd-nw|air|air
}}

'''XOR Gate'''
|-
|
 <nowiki>{{Schematic
|caption='''Falling-Edge Detector'''
|input|+|A|SB|+|rt-!|pi-e!|pe-e|BR|-
||||output|+|O|
}}</nowiki>
 Place the captioned schematic right before the paragraph of text that will flow around it.
|
{{Schematic
|caption='''Falling-Edge Detector'''
|input|+|A|SB|+|rt-!|pi-e!|pe-e|BR|-
||||output|+|O|
}}
Place the captioned schematic right before the paragraph of text that will flow around it.
|-
|
 <nowiki>{{Schematic
|float=left|caption='''1-Wide RS NOR Latch'''<br />(support layer not shown)
|input|+|S|rd-$|rd-$|||-
||SB|SB|rt-$w!|output|+|Q&amp;#x305;|-
|output|+|Q|rt-$e|SB|rd-$!|input|+|R
}}</nowiki>
|
{{Schematic
|float=left|caption='''1-Wide RS NOR Latch'''<br />(support layer not shown)
|input|+|S|rd-$|rd-$|||-
||SB|SB|rt-$w!|output|+|Q&#x305;|-
|output|+|Q|rt-$e|SB|rd-$!|input|+|R
}}
|-
|
 <nowiki>{{Schematic|size=16|caption='''Hopper Clock'''

Long captions will not increase the width of the surrounding box
unless the schematic is fewer than 182px wide
(the same width as the standard image thumb).

size=16 is really too small. Only use it for ''huge'' schematics!
|rd-!|pi-e|BR|pe-w|pi-w!|rd-!|||-
|SB|rc-w!|ho-e|ho-w|rc-e!|SB|rt-w|output|+|C
}}</nowiki>
|
{{Schematic
|size=16|caption='''Hopper Clock'''

Long captions will not increase the width of the surrounding box
unless the schematic is fewer than 182px wide
(the same width as the standard image thumb).

size=16 is really too small. Only use it for ''huge'' schematics!
|rd-!|pi-e|BR|pe-w|pi-w!|rd-!|||-
|SB|rc-w!|ho-e|ho-w|rc-e!|SB|rt-w|output|+|C}}
|}

== List of identifiers ==

A '''sprite identifier''' is a string of characters that specify which sprite to display.

Some conventions to remember:
* Directions are indicated by <code>n</code> (north), <code>s</code> (south), <code>e</code> (east), <code>w</code> (west), <code>u</code> (up), and <code>d</code> (down). Directions are relative to the schematic, not the ''Minecraft'' world.
* <code>$</code> indicates a side view sprite.
* <code>!</code> indicates a powered/activated component.

{{LoadPage|Template:SchematicSprite/ids-basic|Basic identifiers|h3}}
{{LoadPage|Template:SchematicSprite/ids-redstone|Redstone identifiers|h3}}

== See Also ==

;[[Help:Schematic]]
:Guide to reading wiki schematics
;[[Minecraft Wiki:Redstone style guide|Redstone style guide]]
:Guide to writing wiki articles about redstone structures, including tips for authoring schematics

{{doc/end}}