Editing Help:Images
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision
Your text
Line 98:
Line 98: * The alternative is to specify the desired maximum height (in pixels) explicitly. * The alternative is to specify the desired maximum height (in pixels) explicitly. * By writing <code>thumb={filename}</code>, you can use a different image for the thumbnail. * By writing <code>thumb={filename}</code>, you can use a different image for the thumbnail. − * In the examples above, the original size of the image is 400×267 pixels. === Size and frame === === Size and frame === − {{collapse top|title=Among different formats, the effect of the size parameter may be different, as shown by expanding this.}}+ + Among different formats, the effect of the size parameter may be different, as shown below. + + * For how it appears when its size is not specified, see [[#Format|Format]] section above. + * When the format is not specified, or only <code>border</code>ed, the size can be both reduced and enlarged to any specified size. + * In the examples below, the original size of the image is 400×267 pixels. + * An image with <code>frame</code> always '''ignores''' the size specification; the original image will be reduced if it exceeds the maximum size defined in user preferences, and the page information will display a Linter error. + * The size of an image with <code>thumb</code> or <code>frameless</code> can be reduced, but cannot be enlarged beyond the original size of the image. + {|class="wikitable" {|class="wikitable" |- |- Line 113:
Line 120: {{/size|frame=frameless}} {{/size|frame=frameless}} |} |} − {{collapse bottom}} − ==== Notes ==== − * For how it appears when its size is not specified, see [[#Format|Format]] section above. − * When the format is not specified, or only <code>border</code>ed, the size can be both reduced and enlarged to any specified size. − * In the examples above, the original size of the image is 400×267 pixels. − * An image with <code>frame</code> always '''ignores''' the size specification; the original image will be reduced if it exceeds the maximum size defined in user preferences, and the page information will display a Linter error. − * The size of an image with <code>thumb</code> or <code>frameless</code> can be reduced, but cannot be enlarged beyond the original size of the image. === Horizontal alignment === === Horizontal alignment === − {{collapse top|title=The following table shows the effects of horizontal alignment.}}+ + Note that when using the <code>frame</code> or <code>thumb[nail]</code> formats, the default horizontal alignment will be ''right'' for left-to-right languages, and ''left'' for right-to-left languages. + {|class="wikitable" {|class="wikitable" |- |- Line 134:
Line 136: {{/frame|2=100px|frame=right|ex=specify horizontal alignment as: '''right'''|inline=no|float=yes}} {{/frame|2=100px|frame=right|ex=specify horizontal alignment as: '''right'''|inline=no|float=yes}} |} |} − {{collapse bottom}} − ==== Notes ==== − * When using the <code>frame</code> or <code>thumb[nail]</code> formats, the default horizontal alignment will be ''right'' (As BTW's default and only language is English, and it is a ''left-to-right'' language.) === Vertical alignment === === Vertical alignment === Line 142:
Line 141: They alter the way the inlined image will be vertically aligned with the text present in the same block before and/or after this image on the same rendered row. They alter the way the inlined image will be vertically aligned with the text present in the same block before and/or after this image on the same rendered row. − ==== Examples ====+ Note that the rendered line of text where inline images are inserted (and the lines of text rendered after the current one) may be moved down (this will increase the line-height conditionally by additional line spacing, just as it may occur with spans of text with variable font sizes, or with superscripts and subscripts) to allow the image height to be fully displayed with this alignment constraint. − In these examples, to show the alignment result more clearly, the text spans are overlined and underlined, the font-size is increased to 200%, and the paragraph block is outlined with a thin border; additionally images of different sizes are aligned: − {{collapse top|title=Toggle source code view}} + <div class="mw-collapsible mw-collapsed"> + <div class="mw-collapsible-toggle toccolours" style="float:none;text-align:center">'''{{Blue|1=Toggle source code view}}'''</div> + <div class="mw-collapsible-content"> <syntaxhighlight lang="html4strict"> <syntaxhighlight lang="html4strict"> <p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> <p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> Line 191:
Line 191: '''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]] '''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]] <del>text</del></u></span></p> <del>text</del></u></span></p> − </syntaxhighlight></div> + </syntaxhighlight></div></div> − {{collapse bottom}}+ + To show the alignment result more clearly, the text spans are overlined and underlined, the font-size is increased to 200%, and the paragraph block is outlined with a thin border; additionally images of different sizes are aligned: <p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> <p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> Line 239:
Line 240: <del>text</del></u></span></p> <del>text</del></u></span></p> − ====Notes====+ Notes: − * The rendered line of text where inline images are inserted (and the lines of text rendered after the current one) may be moved down (this will increase the line-height conditionally by additional line spacing, just as it may occur with spans of text with variable font sizes, or with superscripts and subscripts) to allow the image height to be fully displayed with this alignment constraint.+ − * The "middle" vertical alignment position of the image (which is also the default) usually refers to the middle between the x-height and the baseline of the text (on which the vertical middle of the image will be aligned, and on which usually the text may be overstroke), but not to the middle of the line-height of the font-height that refers to the space between the "text-top" and "text-bottom" positions ; the font-height excludes:+ # The "middle" vertical alignment position of the image (which is also the default) usually refers to the middle between the x-height and the baseline of the text (on which the vertical middle of the image will be aligned, and on which usually the text may be overstroke), but not to the middle of the line-height of the font-height that refers to the space between the "text-top" and "text-bottom" positions ; the font-height excludes: − ** The additional line separation spacing normally divided equally into two line-margins (here 0.5em, according to line-height set to 200%) above and below the font-height). + #* the additional line separation spacing normally divided equally into two line-margins (here 0.5em, according to line-height set to 200%) above and below the font-height). − ** The additional line spacing which may be added by superscripts and subscripts. + #* the additional line spacing which may be added by superscripts and subscripts. − * If the image height causes its top or bottom position to go above or below the normal full line-height of text, the middle position will be adjusted after the increasing the top and/or bottom line-margins so that the image can fit and align properly, and all images (including those with smaller heights) will be vertically centered on the adjusted middle position (for computing the effective line-height, the text of each rendered row with the larger font-height will be considered).+ # However, if the image height causes its top or bottom position to go above or below the normal full line-height of text, the middle position will be adjusted after the increasing the top and/or bottom line-margins so that the image can fit and align properly, and all images (including those with smaller heights) will be vertically centered on the adjusted middle position (for computing the effective line-height, the text of each rendered row with the larger font-height will be considered). − * The "text-top" and "text-bottom" alignment positions also excludes the extra line spacing added by superscripts and subscripts, but not the additional line-spacing defined by the line-height.+ # The "text-top" and "text-bottom" alignment positions also excludes the extra line spacing added by superscripts and subscripts, but not the additional line-spacing defined by the line-height. − * The "top" and "bottom" alignment positions take into account all these extra line spacings (including superscripts and subscripts, if they are present in a rendered line span). + # The "top" and "bottom" alignment positions take into account all these extra line spacings (including superscripts and subscripts, if they are present in a rendered line span). When the image alignment constrains the image to grow above or below the normal line-spacing, and the image is not absolutely positioned, the image will cause the "top" and "bottom" positions to be adjusted (just like superscripts and subscripts), so the effective line-height between rendered lines of text will be higher. − * When the image alignment constrains the image to grow above or below the normal line-spacing, and the image is not absolutely positioned, the image will cause the "top" and "bottom" positions to be adjusted (just like superscripts and subscripts), so the effective line-height between rendered lines of text will be higher.+ # The "underline", "overline" and "overstrike" text-decoration positions should be somewhere within these two limits and ''may'' depend on the type and height of fonts used (the superscript and subscript styles may be taken into account in some browsers, but usually these styles are ignored and the position of these decorations may not be adjusted); so these decorations normally don't affect the vertical position of images, relatively to the text. − * The "underline", "overline" and "overstrike" text-decoration positions should be somewhere within these two limits and ''may'' depend on the type and height of fonts used (the superscript and subscript styles may be taken into account in some browsers, but usually these styles are ignored and the position of these decorations may not be adjusted); so these decorations normally don't affect the vertical position of images, relatively to the text. === Stopping the text flow === === Stopping the text flow === Line 260:
Line 260: === Altering the default link target === === Altering the default link target === − {{collapse top|title=The following table shows how to alter the link target (whose default is the image description page) or how to remove it.+ The following table shows how to alter the link target (whose default is the image description page) or how to remove it. − Changing the link does not alter the format described in the previous sections.}} + Changing the link does not alter the format described in the previous sections. + {|class="wikitable plainlinks" {|class="wikitable plainlinks" |- |- Line 271:
Line 272: {{/frame|2=link=|ex=no link (external or file page)}} {{/frame|2=link=|ex=no link (external or file page)}} |} |} − {{collapse bottom}} == Rendering a gallery of images == == Rendering a gallery of images == Line 559:
Line 559: * <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. Only plain text may be used in the caption; formatting, templates and the like will not work. * <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. Only plain text may be used in the caption; formatting, templates and the like will not work. − * <code>widths={width}px</code>: sets the (max) widths of the images; the default value is 120px. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover.) ''Note the plural: width'''s'''''. + * <code>widths={width}px</code>: sets the (max) widths of the images; the [[Special:MyLanguage/Manual:$wgGalleryOptions|default value]] is 120px. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) ''Note the plural: width'''s'''''. − * <code>heights={heights}px</code>: sets the (max) heights of the images; the default value is 120px. + * <code>heights={heights}px</code>: sets the (max) heights of the images; the default value is 120px. (It has no effect if mode is set to slideshow.) * <code>perrow={integer}</code>: sets the number of images per row. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 0 means automatically adjust based on width of screen. * <code>perrow={integer}</code>: sets the number of images per row. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 0 means automatically adjust based on width of screen. − * <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image. + * <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image (1.17+). − * <code>mode={traditional|nolines|packed|packed-hover|packed-overlay}</code>. + * <code>mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}</code>: See section above (1.22+; 1.28+ for "slideshow"). + * <code>showthumbnails</code>: For "slideshow" mode only, display the strip with image thumbnails below the slideshow by default (1.29+). ==== Examples ==== ==== Examples ==== Line 616:
Line 617: == Row of images that will wrap to browser width == == Row of images that will wrap to browser width == − This is an odd one, here are 3 examples that can possibly work.+ One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". − === Examples ===+ If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. − {{collapse top|title=Toggle source code view}}+ If necessary, narrow the browser window to see the images wrap to the next row. + <pre> <pre> [[File:Example.jpg|220px]] [[File:Example.jpg|220px]] Line 629:
Line 631: [[File:Example.jpg|175px]] [[File:Example.jpg|175px]] </pre> </pre> − {{collapse bottom}}+ [[File:Example.jpg|220px]] [[File:Example.jpg|220px]] [[File:Example.jpg|100px]] [[File:Example.jpg|100px]] Line 638:
Line 640: [[File:Example.jpg|220px]] [[File:Example.jpg|220px]] [[File:Example.jpg|175px]] [[File:Example.jpg|175px]] − {{collapse top|title=Toggle source code view}}+ + '''To wrap images of varying widths with captions''' it is necessary to use div HTML for an unordered list. Along with <code>style="display: inline-block;"</code>. For more info and ideas see: [http://www.sitepoint.com/give-floats-the-flick-in-css-layouts Give Floats the Flick in CSS Layouts]. + <syntaxhighlight lang="html"> <syntaxhighlight lang="html"> <div><ul> <div><ul> Line 651:
Line 655: </ul></div> </ul></div> </syntaxhighlight> </syntaxhighlight> − {{collapse bottom}}+ <div><ul> <div><ul> <li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> <li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> Line 662:
Line 666: <li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li> <li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li> </ul></div> </ul></div> − {{collapse top|title=Toggle source code view}}+ + To '''align the top edge of images''' add the vertical-align command + <syntaxhighlight lang="html"> <syntaxhighlight lang="html"> <div><ul> <div><ul> Line 675:
Line 681: </ul></div> </ul></div> </syntaxhighlight> </syntaxhighlight> − {{collapse bottom}}+ <div><ul> <div><ul> <li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> <li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> Line 687:
Line 693: </ul></div> </ul></div> − === Notes ===+ Some wiki farms do not have all gallery options (such as "widths"). − * One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none".+ Also, sometimes one wants varying widths for images in a row. − * If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width.+ Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. − * If necessary, narrow the browser window to see the images wrap to the next row.+ Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar. − * To '''align the top edge of images''' add the vertical-align command.+ − * To wrap images of varying widths with captions, it is necessary to use div HTML for an unordered list. Along with <code>style="display: inline-block;"</code>. For more info and ideas see: [http://www.sitepoint.com/give-floats-the-flick-in-css-layouts Give Floats the Flick in CSS Layouts].+ Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. − * Outside a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width.+ Weird things will occur. − * Weird things will occur!+ At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images. − ** You may need to try saving it and see, as previewing it only works so well. − ** Nothing else using wikitext works correctly. − ** Images can (and will) either overlap stuff on the right, or force a horizontal scroll bar. − * Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. − * At narrower browser or screen widths, an image out of the row may appear far down the page after the end of the right sidebar of images. == Link behavior == == Link behavior ==
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 98: | Line 98: | ||
* The alternative is to specify the desired maximum height (in pixels) explicitly. | * The alternative is to specify the desired maximum height (in pixels) explicitly. | ||
* By writing <code>thumb={filename}</code>, you can use a different image for the thumbnail. | * By writing <code>thumb={filename}</code>, you can use a different image for the thumbnail. | ||
| − | |||
=== Size and frame === | === Size and frame === | ||
| − | + | ||
| + | Among different formats, the effect of the size parameter may be different, as shown below. | ||
| + | |||
| + | * For how it appears when its size is not specified, see [[#Format|Format]] section above. | ||
| + | * When the format is not specified, or only <code>border</code>ed, the size can be both reduced and enlarged to any specified size. | ||
| + | * In the examples below, the original size of the image is 400×267 pixels. | ||
| + | * An image with <code>frame</code> always '''ignores''' the size specification; the original image will be reduced if it exceeds the maximum size defined in user preferences, and the page information will display a Linter error. | ||
| + | * The size of an image with <code>thumb</code> or <code>frameless</code> can be reduced, but cannot be enlarged beyond the original size of the image. | ||
| + | |||
{|class="wikitable" | {|class="wikitable" | ||
|- | |- | ||
| Line 113: | Line 120: | ||
{{/size|frame=frameless}} | {{/size|frame=frameless}} | ||
|} | |} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Horizontal alignment === | === Horizontal alignment === | ||
| − | + | ||
| + | Note that when using the <code>frame</code> or <code>thumb[nail]</code> formats, the default horizontal alignment will be ''right'' for left-to-right languages, and ''left'' for right-to-left languages. | ||
| + | |||
{|class="wikitable" | {|class="wikitable" | ||
|- | |- | ||
| Line 134: | Line 136: | ||
{{/frame|2=100px|frame=right|ex=specify horizontal alignment as: '''right'''|inline=no|float=yes}} | {{/frame|2=100px|frame=right|ex=specify horizontal alignment as: '''right'''|inline=no|float=yes}} | ||
|} | |} | ||
| − | |||
| − | |||
| − | |||
=== Vertical alignment === | === Vertical alignment === | ||
| Line 142: | Line 141: | ||
They alter the way the inlined image will be vertically aligned with the text present in the same block before and/or after this image on the same rendered row. | They alter the way the inlined image will be vertically aligned with the text present in the same block before and/or after this image on the same rendered row. | ||
| − | + | Note that the rendered line of text where inline images are inserted (and the lines of text rendered after the current one) may be moved down (this will increase the line-height conditionally by additional line spacing, just as it may occur with spans of text with variable font sizes, or with superscripts and subscripts) to allow the image height to be fully displayed with this alignment constraint. | |
| − | |||
| − | {{ | + | <div class="mw-collapsible mw-collapsed"> |
| + | <div class="mw-collapsible-toggle toccolours" style="float:none;text-align:center">'''{{Blue|1=Toggle source code view}}'''</div> | ||
| + | <div class="mw-collapsible-content"> | ||
<syntaxhighlight lang="html4strict"> | <syntaxhighlight lang="html4strict"> | ||
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> | <p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> | ||
| Line 191: | Line 191: | ||
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]] | '''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]] | ||
<del>text</del></u></span></p> | <del>text</del></u></span></p> | ||
| − | </syntaxhighlight></div> | + | </syntaxhighlight></div></div> |
| − | + | ||
| + | To show the alignment result more clearly, the text spans are overlined and underlined, the font-size is increased to 200%, and the paragraph block is outlined with a thin border; additionally images of different sizes are aligned: | ||
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> | <p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2"> | ||
| Line 239: | Line 240: | ||
<del>text</del></u></span></p> | <del>text</del></u></span></p> | ||
| − | + | Notes: | |
| − | + | ||
| − | + | # The "middle" vertical alignment position of the image (which is also the default) usually refers to the middle between the x-height and the baseline of the text (on which the vertical middle of the image will be aligned, and on which usually the text may be overstroke), but not to the middle of the line-height of the font-height that refers to the space between the "text-top" and "text-bottom" positions ; the font-height excludes: | |
| − | * | + | #* the additional line separation spacing normally divided equally into two line-margins (here 0.5em, according to line-height set to 200%) above and below the font-height). |
| − | * | + | #* the additional line spacing which may be added by superscripts and subscripts. |
| − | + | # However, if the image height causes its top or bottom position to go above or below the normal full line-height of text, the middle position will be adjusted after the increasing the top and/or bottom line-margins so that the image can fit and align properly, and all images (including those with smaller heights) will be vertically centered on the adjusted middle position (for computing the effective line-height, the text of each rendered row with the larger font-height will be considered). | |
| − | + | # The "text-top" and "text-bottom" alignment positions also excludes the extra line spacing added by superscripts and subscripts, but not the additional line-spacing defined by the line-height. | |
| − | + | # The "top" and "bottom" alignment positions take into account all these extra line spacings (including superscripts and subscripts, if they are present in a rendered line span). When the image alignment constrains the image to grow above or below the normal line-spacing, and the image is not absolutely positioned, the image will cause the "top" and "bottom" positions to be adjusted (just like superscripts and subscripts), so the effective line-height between rendered lines of text will be higher. | |
| − | + | # The "underline", "overline" and "overstrike" text-decoration positions should be somewhere within these two limits and ''may'' depend on the type and height of fonts used (the superscript and subscript styles may be taken into account in some browsers, but usually these styles are ignored and the position of these decorations may not be adjusted); so these decorations normally don't affect the vertical position of images, relatively to the text. | |
| − | |||
=== Stopping the text flow === | === Stopping the text flow === | ||
| Line 260: | Line 260: | ||
=== Altering the default link target === | === Altering the default link target === | ||
| − | + | The following table shows how to alter the link target (whose default is the image description page) or how to remove it. | |
| − | Changing the link does not alter the format described in the previous sections. | + | Changing the link does not alter the format described in the previous sections. |
| + | |||
{|class="wikitable plainlinks" | {|class="wikitable plainlinks" | ||
|- | |- | ||
| Line 271: | Line 272: | ||
{{/frame|2=link=|ex=no link (external or file page)}} | {{/frame|2=link=|ex=no link (external or file page)}} | ||
|} | |} | ||
| − | |||
== Rendering a gallery of images == | == Rendering a gallery of images == | ||
| Line 559: | Line 559: | ||
* <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. Only plain text may be used in the caption; formatting, templates and the like will not work. | * <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. Only plain text may be used in the caption; formatting, templates and the like will not work. | ||
| − | * <code>widths={width}px</code>: sets the (max) widths of the images; the default value is 120px. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover.) ''Note the plural: width'''s'''''. | + | * <code>widths={width}px</code>: sets the (max) widths of the images; the [[Special:MyLanguage/Manual:$wgGalleryOptions|default value]] is 120px. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) ''Note the plural: width'''s'''''. |
| − | * <code>heights={heights}px</code>: sets the (max) heights of the images; the default value is 120px. | + | * <code>heights={heights}px</code>: sets the (max) heights of the images; the default value is 120px. (It has no effect if mode is set to slideshow.) |
* <code>perrow={integer}</code>: sets the number of images per row. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 0 means automatically adjust based on width of screen. | * <code>perrow={integer}</code>: sets the number of images per row. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 0 means automatically adjust based on width of screen. | ||
| − | * <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image. | + | * <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image (1.17+). |
| − | * <code>mode={traditional|nolines|packed|packed-hover|packed-overlay}</code>. | + | * <code>mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}</code>: See section above (1.22+; 1.28+ for "slideshow"). |
| + | * <code>showthumbnails</code>: For "slideshow" mode only, display the strip with image thumbnails below the slideshow by default (1.29+). | ||
==== Examples ==== | ==== Examples ==== | ||
| Line 616: | Line 617: | ||
== Row of images that will wrap to browser width == | == Row of images that will wrap to browser width == | ||
| − | + | One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". | |
| − | + | If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. | |
| − | + | If necessary, narrow the browser window to see the images wrap to the next row. | |
| + | |||
<pre> | <pre> | ||
[[File:Example.jpg|220px]] | [[File:Example.jpg|220px]] | ||
| Line 629: | Line 631: | ||
[[File:Example.jpg|175px]] | [[File:Example.jpg|175px]] | ||
</pre> | </pre> | ||
| − | + | ||
[[File:Example.jpg|220px]] | [[File:Example.jpg|220px]] | ||
[[File:Example.jpg|100px]] | [[File:Example.jpg|100px]] | ||
| Line 638: | Line 640: | ||
[[File:Example.jpg|220px]] | [[File:Example.jpg|220px]] | ||
[[File:Example.jpg|175px]] | [[File:Example.jpg|175px]] | ||
| − | + | ||
| + | '''To wrap images of varying widths with captions''' it is necessary to use div HTML for an unordered list. Along with <code>style="display: inline-block;"</code>. For more info and ideas see: [http://www.sitepoint.com/give-floats-the-flick-in-css-layouts Give Floats the Flick in CSS Layouts]. | ||
| + | |||
<syntaxhighlight lang="html"> | <syntaxhighlight lang="html"> | ||
<div><ul> | <div><ul> | ||
| Line 651: | Line 655: | ||
</ul></div> | </ul></div> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ||
<div><ul> | <div><ul> | ||
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> | <li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> | ||
| Line 662: | Line 666: | ||
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li> | <li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li> | ||
</ul></div> | </ul></div> | ||
| − | + | ||
| + | To '''align the top edge of images''' add the vertical-align command | ||
| + | |||
<syntaxhighlight lang="html"> | <syntaxhighlight lang="html"> | ||
<div><ul> | <div><ul> | ||
| Line 675: | Line 681: | ||
</ul></div> | </ul></div> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ||
<div><ul> | <div><ul> | ||
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> | <li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li> | ||
| Line 687: | Line 693: | ||
</ul></div> | </ul></div> | ||
| − | + | Some wiki farms do not have all gallery options (such as "widths"). | |
| − | + | Also, sometimes one wants varying widths for images in a row. | |
| − | + | Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. | |
| − | + | Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar. | |
| − | + | ||
| − | + | Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. | |
| − | + | Weird things will occur. | |
| − | + | At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Link behavior == | == Link behavior == | ||