Template:Portal/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>Eubulides
Document desired behavior for link and alt text.
meta>Eubulides
Mention attribution.
Line 8: Line 8:
The units assumed for <code>size</code> (the width of the image) and <code>boxsize</code> (the width of the box containing the image and portal link) are pixels (px). By default, the box is surrounded by a margin of width 0.5em, but this can be customized using <code>margin=''top'' ''right'' ''bottom'' ''left''</code> (e.g. <code style="font-size:95%;">margin=0.25em 0 0.25em 0.25em</code>) or removed using <code>margin=0</code> (zero).
The units assumed for <code>size</code> (the width of the image) and <code>boxsize</code> (the width of the box containing the image and portal link) are pixels (px). By default, the box is surrounded by a margin of width 0.5em, but this can be customized using <code>margin=''top'' ''right'' ''bottom'' ''left''</code> (e.g. <code style="font-size:95%;">margin=0.25em 0 0.25em 0.25em</code>) or removed using <code>margin=0</code> (zero).


Normally the image are assumed to be purely decorative, and no link is generated for it. However, if <code>alt=''Alt text''</code> is specified (see [[WP:ALT]]), a link to the image's page is generated; this link can be overridden with <code>link=''Page to link to''</code>. As per [[WP:ALT]], if a link is specified, alt text for that link's function should also be specified.
Normally the image are assumed to be purely decorative, and no link is generated for it; in this case the image should not have a license that requires attribution, for technical reasons involving copyright law and the current implementation of Wikipedia. However, if <code>alt=''Alt text''</code> is specified (see [[WP:ALT]]), a link to the image's page is generated; this link can be overridden with <code>link=''Page to link to''</code>. As per [[WP:ALT]], if a link is specified, alt text for that link's function should also be specified.


===Location===
===Location===

Revision as of 09:10, 18 July 2009

This template is used to produce a link in a box to a portal.

Optional parameters

{{portal|name|image|size|boxsize|break=yes|left=yes|margin=|alt=Alt text|link=Link}}

The units assumed for size (the width of the image) and boxsize (the width of the box containing the image and portal link) are pixels (px). By default, the box is surrounded by a margin of width 0.5em, but this can be customized using margin=top right bottom left (e.g. margin=0.25em 0 0.25em 0.25em) or removed using margin=0 (zero).

Normally the image are assumed to be purely decorative, and no link is generated for it; in this case the image should not have a license that requires attribution, for technical reasons involving copyright law and the current implementation of Wikipedia. However, if alt=Alt text is specified (see WP:ALT), a link to the image's page is generated; this link can be overridden with link=Page to link to. As per WP:ALT, if a link is specified, alt text for that link's function should also be specified.

Location

Within articles, this template is meant to be placed at the bottom of the article in the "See also" section.

Examples

Code
Result
{{portal}}
{{portal|Science}}
{{portal|Spaceflight|RocketSunIcon.svg}}
{{portal|Spaceflight|RocketSunIcon.svg|size=50}}
{{portal|Spaceflight|RocketSunIcon.svg|boxsize=50}}
{{portal|Spaceflight|RocketSunIcon.svg|break=yes}}
{{portal|Spaceflight|RocketSunIcon.svg|break=yes|left=yes}}

See also