Template:Annotation: Difference between revisions
Richardpruen (talk | contribs) m (1 revision imported) |
m (how long has the text align been broken for???) |
||
| Line 1: | Line 1: | ||
<includeonly><div id="annotation_{{{1}}}x{{{2}}}" style="position:absolute; left:{{{1}}}px; top:{{{2}}}px; {{#if:{{{font-family|}}}|font-family:{{{font-family}}};|}} {{#if:{{{font-size|}}}|font-size:{{{font-size}}}px;|}} {{#if:{{{font-weight|}}}|font-weight:{{{font-weight}}};|}} {{#if:{{{font-style|}}}|font-style:{{{font-style}}};|}} {{#if:{{{line-height|}}}|line-height:{{{line-height}}};|{{#if:{{{font-size|}}}|line-height:{{#expr:{{{font-size|}}}+2}}px; |line-height:110%}}}} {{#if:{{{text-align|}}}|text-align:{{{text-align}}};|}}"><span style="background-color:{{{background-color|transparent}}}; {{#if:{{{color|}}}|color:{{{color}}};|}}">{{{3}}}</span></div></includeonly><noinclude><!-- | <includeonly><div id="annotation_{{{1}}}x{{{2}}}" style="position:absolute; left:{{{1}}}px; top:{{{2}}}px; {{#if:{{{font-family|}}}|font-family:{{{font-family}}};|}} {{#if:{{{font-size|}}}|font-size:{{{font-size}}}px;|}} {{#if:{{{font-weight|}}}|font-weight:{{{font-weight}}};|}} {{#if:{{{font-style|}}}|font-style:{{{font-style}}};|}} {{#if:{{{line-height|}}}|line-height:{{{line-height}}};|{{#if:{{{font-size|}}}|line-height:{{#expr:{{{font-size|}}}+2}}px; |line-height:110%;}}}} {{#if:{{{text-align|}}}|text-align:{{{text-align}}};|}}"><span style="background-color:{{{background-color|transparent}}}; {{#if:{{{color|}}}|color:{{{color}}};|}}">{{{3}}}</span></div></includeonly><noinclude><!-- | ||
Uses "template language" expressions so that most CSS formatting keywords are not generated if the corresponding template param is missing. That way the formatting wherever possible stays as per the user's preferences or values set by containing template. | Uses "template language" expressions so that most CSS formatting keywords are not generated if the corresponding template param is missing. That way the formatting wherever possible stays as per the user's preferences or values set by containing template. | ||
Revision as of 19:59, 23 February 2022
Creates an annotation for annotated images, for example in the diagram on the right the labels for the various extinctions are generated by Template:Annotation:
- You specify the position within the image at which each annotations is to appear.
- Annotations may be links, including wikilinks.
Usage
 | This template will malfunction unless used within the templates [[Template:{{{2}}}|{{{2}}}]] or [[Template:{{{2}}}|{{{2}}}]]. |
{{Annotation | left (in px)| top (in px) | text | text-align=left | font-size=12 | font-weight=bold | font-family=Times New Roman | background-color=#ffcccee | color=blue |line-height=1}}
where:
- There are no keywords for the top, left and text parameters, which are mandatory and must appear in the order given above. The other parameters are optional, must be identified by their keywords (e.g. font-size=...), and may appear in any order.
- left and top specify the annotation's position relative to the top left corner of the box that contains the image. i.e. the box' top left corner is 0,0. The box will usually be larger than the actual image, to make room for the annotations.
- text is the text that will be displayed.
- text-align can be set to left, center or right, and is only noticeable when the annotation spans multiple lines.
- font-size is in px (pixel) units – CSS relative sizes are not supported.
- font-weight is bold or normal.
- font-family is the CSS name for the font, e.g. Times New Roman or Verdana
- background-color defaults to transparent.
- color is the color of the text and defaults to black, which is the default text color in most Wikipedia style sheets. In particular, it's best to use blue only for links.
- line-height set the line height, e.g. 80% or 0.8, and is only noticeable when the annotation spans multiple lines.
Extended parameter names for use in other templates
Some of the parameters have alternative names that are used by containing templates to call Template:Annotation. The alternative names are provided in case the containing templates call other templates that use similar parameters.
These alternative names are provided so that the containing templates can provide default values for the corresponding parameters in Template:Annotation, and should not be used for any other purpose. Values specified using the basic parameter names listed above will over-ride the alternative names that are used by containing templates.
Here are the alternative names and the basic Template:Annotation parameters for which they set defaults:
| Alternative name | Basic name |
|---|---|
| annot-text-align | text-align |
| annot-font-size | font-size |
| annot-font-weight | font-weight |
| annot-font-family | font-family |
| annot-background-color | background-color |
| annot-color | color |