Template:Plain image with caption

Template page
Revision as of 11:51, 31 July 2023 by Timothy (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Caption goes here.
Caption goes here.
Template documentationview · edit · history · purge ]

Since MediaWiki does not provide a way to add visible captions to images integrated seamlessly in a page (i.e., without borders), this template aims to provide that functionality.

Usage

This template can be either with named parameters, as in

{{Plain image with caption|image=Example.svg|caption=Example text|upright=1|align=right|caption position=bottom}}

...or in its shorthand form:

{{Plain image with caption|Example.svg|Example text|upright|right|bottom}}
  • The only compulsory parameters are image and caption.
  • When using the shorthand version, keep in mind that the order of parameters is important.
Parameter Default Acceptable values
image mandatory any image filename ("File:" or "Image:" is optional)
caption mandatory any valid wiki markup
upright 1 any decimal number (decimal point is optional)
width none any pixel width ("px" suffix optional)
height none any pixel height ("px" suffix optional)
align right left, center, right, none
caption position bottom top, bottom
triangle none triangle, none
triangle color #ff0080 any CSS color
image override Anything (lets you replace the image block with anything—useful for stacking image overlays)
caption override Anything (lets you replace the caption block with anything)

Examples

The triangle parameters give the option to add a colored triangle label—

This is a picture of the James Webb Space Telescope.
This is a picture of the James Webb Space Telescope.

<syntaxhighlight lang="wikitext" inline>

This is a picture of the James Webb Space Telescope.
This is a picture of the James Webb Space Telescope.
</syntaxhighlight>

Using "image-override" to stack images

Grana structure The prevailing model for granal structure is a stack of granal thylakoids linked by helical stromal thylakoids that wrap around the grana stacks and form large sheets that connect different grana.
Helical granum.png
The prevailing model for granal structure.

<syntaxhighlight lang="wikitext" inline>

Grana structure The prevailing model for granal structure is a stack of granal thylakoids linked by helical stromal thylakoids that wrap around the grana stacks and form large sheets that connect different grana.
Helical granum.png
The prevailing model for granal structure.
</syntaxhighlight>

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Plain image with caption in articles based on its TemplateData.

TemplateData for Plain image with caption

A template for adding a caption to a frameless image.

Template parameters[Edit template data]

ParameterDescriptionTypeStatus
Imageimage 1

The image to use. The ''File:'' prefix is optional.

Default
Stringrequired
Image caption and alt textcaption 2

The caption to display under or above the image. Also sets the alt text.

Default
Stringrequired
Image width scaling factorupright

Decimal multiplier that sets the width of the image relative to the user's preferred thumbnail size, as set in their Preferences (220px by default or when not logged in). Decimal point optional.

Default
1
Example
0.75
Stringoptional
Image widthwidth 3

Sets the pixel width of the image. Per WP:THUMBSIZE, fixed image widths should not be used unless align is set to ''center'' or otherwise necessary. The ''px'' suffix is optional.

Default
Numberoptional
Image heightheight

Sets the pixel height of the image. The ''px'' suffix is optional.

Numberoptional
Float and centeralign 4

Floats the template to the left, right, or centers it. Accepts ''left'', ''center'', ''right'', or ''none''. If set to ''center'', width must be set to a pixel-defined width, or else an error will be displayed.

Default
right
Stringoptional
Caption positioncaption position 5

Determines whether the caption goes above or below the image. Accepts ''top'' or ''bottom''.

Default
bottom
Stringoptional
Triangle pointertriangle 6

Allows you to add a triangular pointer next to the caption text. Accepts ''triangle'' or ''none''.

Default
none
Stringoptional
Triangle pointer colortriangle color 7

Lets you set a CSS color for the triangular pointer.

Default
#ff0080
Stringoptional
Replacement content for the imageimage override 8

Lets you substitute any allowed HTML where the image would normally be.

Default
Stringoptional
Replacement content for the captioncaption override 9

Lets you substitute any allowed HTML where the caption would normally be.

Default
Stringoptional

See also