Template:Stack documentation

From WikiMSK

Template:Ombox

This template can be used to stack images and other floating content such as infobox templates without causing problems with spacing and floating. Enter a string of images/templates as the first parameter to have them stack without generating floating errors or spacing errors. You can stack many objects from the top of a section and not force further subsections to space out.

Template:TOClimit

Usage

At its simplest:

{{stack|<objects>}}

Alternatively, using Template:Tld and Template:Tld:

{{stack begin}}
<objects>
{{stack end}}

The <object> may simply be a string of wikicode for many images/templates.

Optional parameters

{{stack| <object(s)> | float=left or right | clear=true or false | margin=true or false}}

or

{{stack begin | float=left or right | clear=true or false | margin=true or false}}

where

  • float= left or right (default is right)
    This option can be used to float the stack to the left or right of the page
  • clear= true or false (default is false)
    This option can be used to force the stack to the far left or right (e.g., near an infobox).
  • margin= true or false (default is false)
    This option can be used to add a 1em margin to the left (for float right) or right (for float left).

You can also explicitly list multiple arguments:

{{stack| float=left or right | clear=true or false | margin=true or false
|1=<object(s)>
|2=<object(s)>, etc. up to 9 parameters in the current version
}}
  • This multiple argument version does include extra vertical whitespace between each (set of) <object(s)>.

Examples

To illustrate the utility of the stack templates, consider the following situation. We would like to have two right floating images at the top of the first section of our article (here, the Lipsum section), and one left floating image at the top of the second section (here, the Lorem section). To achieve this layout, without using a stack template, we could try the following code:

=====''Lipsum''=====
[[File:Simple shapes example.png|thumb|right|Example 1a]]
[[File:Simple shapes example.png|thumb|right|Example 1b]]
... text ...

=====''Lorem''=====
[[File:Simple shapes example.png|thumb|left|Example 1c]]
... text ...

=====''Ipsum''=====
... text ...

The result of this is shown in the without stack section below. Notice how the left floating image (Example 1c) is prevented from floating above the last right floating image (Example 1b). You may need to resize the width of your browser to fully appreciate the issue. To fix this problem, we can stack the two right floating images together, using the following code:

=====''Lipsum''=====
{{stack |[[File:Simple shapes example.png|thumb|right|Example 2a]] [[File:Simple shapes example.png|thumb|right|Example 2b]]}}
... text ...

=====''Lorem''=====
[[File:Simple shapes example.png|thumb|left|Example 2c]]
... text ...

=====''Ipsum''=====
... text ...

The result of this is shown in the with stack section below. Notice how by adding this stack template, the left floating image (Example 2c) can now float higher and is not blocked from floating higher than the top of the last right floating image (Example 2b).


Template:Anchor

Without Template:Tlf

Lipsum
Example 1a
Example 1b

Template:Lorem ipsum spanTemplate:Lorem ipsum spanTemplate:Lorem ipsum spanTemplate:Lorem ipsum span[[:T

Lorem
Example 1c

Template:Lipsum

Ipsum

Template:Lipsum

Template:Lipsum


Template:Anchor

With Template:Tlf


Lipsum
Example 2a
Example 2b

Template:Lorem ipsum spanTemplate:Lorem ipsum spanTemplate:Lorem ipsum spanTemplate:Lorem ipsum span[[:T

Lorem
Example 2c

Template:Lipsum

Ipsum

Template:Lipsum

Template:Lipsum


With Template:Tlf and Template:Tlf

Lipsum with second table wider
Sample table 1
Example 1a
Example 1b
Sample wider table 2
Example 2a
Example 2b

Template:Lipsum

Lorem
Sample table 3
Example 3a

Template:Lipsum

Ipsum

Template:Lipsum

Template:Lipsum


Lipsum with first table wider
Sample wider table 1
Example 1a
Example 1b
Sample table 2
Example 2a
Example 2b

Template:Lipsum

Lorem
Sample table 3
Example 3a

Template:Lipsum

Ipsum

Template:Lipsum

Template:Lipsum


More examples

Template:Tlf can also be used to float one or more images across a page.

Simple shapes example.png
Simple shapes example.png
{{stack|[[File:Simple shapes example.png|80px]]}}
{{stack|[[File:Simple shapes example.png|120px]]}}

It might take some experience to learn how the box area floats, in combination with various images or wikitables on a page. Template:Tlf's operation is very quick, as it uses an HTML <table> to achieve its effects.

Floating portal boxes

Template:Tlf can be used to float a portal box beside an infobox (or other right-aligned item) when other methods might not work as anticipated.

{{{1}}}
{{{title}}}
Test image

This is a wikitable serving as a typical left-aligned table. The overlap on left-aligned tables had been a frequent problem when other boxes nearby were set to "float:right". So this is a test of how well a floating portal-box would avoid overlapping onto a left-side table.

This template characterizes the portal page and places it in the category of the same name. You can change a category by using a categoryparameter .
General input
  • {{Portal|picture=<image name>|background=<background color>|font=<font color>|category=<category>}}
Specific uses
  • {{Portal|picture=Bulb_001.png|background=#F5F5DC|font=#000000|category=light bulbs}}

Stack documentation

This template characterizes the portal page and places it in the category of the same name. You can change a category by using a categoryparameter .
General input
  • {{Portal|picture=<image name>|background=<background color>|font=<font color>|category=<category>}}
Specific uses
  • {{Portal|picture=Bulb_001.png|background=#F5F5DC|font=#000000|category=light bulbs}}

Stack documentation

The example here uses Template:Tld to float two portal boxes (Animals, Cats) as follows:

{{stack |{{portal|Animals}}{{portal|Cats}} }}

The two portal-boxes are stacked and floated together by both being listed as Template:Tld's (first) parameter. Because the infobox and image were also stacked together, Template:Tld moved the two portal-boxes alongside the infobox despite they are being specified after the image.

Normally, a portal-box would be stuck below the Mona Lisa image, causing this entire text section to format further below, and causing a large text-gap of empty whitespace to appear near the infobox. There is no limit to the number of portalboxes (or Commonscat boxes) which can be listed within a Template:Tld call, such as in a stub or an article with many stacked images near the bottom. Using Template:Tld is extremely efficient, due to being a short template which uses builtin tag <table> to float the boxes.

Stack template family

Tracking category

See also