Help:Images - Revision history

Ibjadmin: /* Syntax */

2010-07-21T10:00:27Z

Syntax

← Older revision		Revision as of 12:00, 21 July 2010
Line 28:		Line 28:
	* ''Link option'': one of		* ''Link option'': one of
	** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;		** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;

	*: Note that the '''link''' option cannot be used in conjunction with '''thumb''' or '''thumbnail''', as '''thumb''' is always meant to link to the larger version of the image.
	*: In addition, '''link''' cannot be used with '''frame'''.
	*----		----
	See [[Help:Contents]]		See [[Help:Contents]]

Ibjadmin: /* Syntax */

2010-07-21T10:00:05Z

Syntax

@@ Line 31: / Line 31: @@
 *: Note that the '''link''' option cannot be used in conjunction with '''thumb''' or '''thumbnail''', as '''thumb''' is always meant to link to the larger version of the image.
 *: In addition, '''link''' cannot be used with '''frame'''.
-* Other specific options:
+*----
 See [[Help:Contents]]

Ibjadmin: /* Syntax */

2010-07-21T09:59:23Z

Syntax

← Older revision		Revision as of 11:59, 21 July 2010
Line 28:		Line 28:
	* ''Link option'': one of		* ''Link option'': one of
	** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;		** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;
	~~[[</nowiki>File:~~Example.jpg~~\|20px\|link=]]</~~code> renders as ~~[[File:~~Example.jpg~~\|20px\|link=]]~~.
	*: Note that the '''link''' option cannot be used in conjunction with '''thumb''' or '''thumbnail''', as '''thumb''' is always meant to link to the larger version of the image.		*: Note that the '''link''' option cannot be used in conjunction with '''thumb''' or '''thumbnail''', as '''thumb''' is always meant to link to the larger version of the image.
	*: In addition, '''link''' cannot be used with '''frame'''.		*: In addition, '''link''' cannot be used with '''frame'''.
Line 39:		Line 39:
	If a parameter does not match any of the other possibilities, it is assumed to be the caption text. Caption text shows below the image in '''thumb''' and '''frame''' formats, or as mouseover text in '''border''', '''frameless''' formats or when the format is omitted. Caption text displayed in the '''thumb''' and '''frame''' formats may contain wiki links and other formatting. In the other options, wiki-formatting will not work though transclusion will.		If a parameter does not match any of the other possibilities, it is assumed to be the caption text. Caption text shows below the image in '''thumb''' and '''frame''' formats, or as mouseover text in '''border''', '''frameless''' formats or when the format is omitted. Caption text displayed in the '''thumb''' and '''frame''' formats may contain wiki links and other formatting. In the other options, wiki-formatting will not work though transclusion will.

	If no caption text is supplied, a caption is automatically created showing the file name. To completely remove the caption, set it to <code><nowiki><span title=""></span></nowiki></code>. For example, <code><nowiki>~~[[File:~~Example.jpg~~\|20px\|<span title="">~~</span>]]</nowiki></code> renders as ~~[[File:~~Example.jpg~~\|20px\|<span title=""></span>]]~~.		If no caption text is supplied, a caption is automatically created showing the file name. To completely remove the caption, set it to <code><nowiki><span title=""></span></nowiki></code>. For example, <code><nowiki>Example.jpg</span>]]</nowiki></code> renders as Example.jpg.

	----		----
	See [[Help:Contents]]		See [[Help:Contents]]

Ibjadmin: 1 revision

2010-07-07T18:26:29Z

1 revision

← Older revision	Revision as of 20:26, 7 July 2010
(No difference)

Ibjadmin: /* Syntax */

2010-07-07T18:08:05Z

Syntax

← Older revision		Revision as of 20:08, 7 July 2010
Line 40:		Line 40:

	If no caption text is supplied, a caption is automatically created showing the file name. To completely remove the caption, set it to <code><nowiki><span title=""></span></nowiki></code>. For example, <code><nowiki>[[File:Example.jpg\|20px\|<span title=""></span>]]</nowiki></code> renders as [[File:Example.jpg\|20px\|<span title=""></span>]].		If no caption text is supplied, a caption is automatically created showing the file name. To completely remove the caption, set it to <code><nowiki><span title=""></span></nowiki></code>. For example, <code><nowiki>[[File:Example.jpg\|20px\|<span title=""></span>]]</nowiki></code> renders as [[File:Example.jpg\|20px\|<span title=""></span>]].

			----
			See [[Help:Contents]]

Ibjadmin: /* Syntax */

2010-07-07T18:07:01Z

Syntax

← Older revision		Revision as of 20:07, 7 July 2010
Line 15:		Line 15:
	* ''Format'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail''');		* ''Format'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail''');
	*: Controls how the rendered image is formatted and embedded in the rest of the page.		*: Controls how the rendered image is formatted and embedded in the rest of the page.
	* ''~~[[#Size and Frame\|~~Resizing]]'' option: one of		* ''Resizing'' option: one of
	** ''{width}'''''px''' � Resizes the image to fit within the given maximum width in pixels, without restricting its height;		** ''{width}'''''px''' � Resizes the image to fit within the given maximum width in pixels, without restricting its height;
	** '''x'''''{height}'''''px''' � Resizes the image to fit within the given maximum height in pixels, without restricting its width;		** '''x'''''{height}'''''px''' � Resizes the image to fit within the given maximum height in pixels, without restricting its width;
Line 22:		Line 22:
	*: Note that the image will always retain its aspect ratio, and can only be reduced in size if it's not in a scalable media type such as SVG (bitmap images cannot be scaled up).		*: Note that the image will always retain its aspect ratio, and can only be reduced in size if it's not in a scalable media type such as SVG (bitmap images cannot be scaled up).
	*: The default maximum size depends on the ''format'' and the internal image dimensions (according to its media type).		*: The default maximum size depends on the ''format'' and the internal image dimensions (according to its media type).
	* ''~~[[#~~Horizontal alignment~~\|Horizontal alignment]]~~'' option: one of '''left''', '''right''', '''center''', '''none''';		* ''Horizontal alignment'' option: one of '''left''', '''right''', '''center''', '''none''';
	*: Controls the horizontal alignment (and inline/block or floatting styles) of the image within a text (no default value).		*: Controls the horizontal alignment (and inline/block or floatting styles) of the image within a text (no default value).
	* ''Vertical alignment'' option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';		* ''Vertical alignment'' option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';

Ibjadmin: /* Syntax */

2010-07-07T18:05:53Z

Syntax

← Older revision		Revision as of 20:05, 7 July 2010
Line 26:		Line 26:
	* ''Vertical alignment'' option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';		* ''Vertical alignment'' option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';
	*: Controls the vertical alignment of a non-floatting inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle''').		*: Controls the vertical alignment of a non-floatting inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle''').
	* ''~~[[#Altering the default link target\|~~Link]] option'': one of		* ''Link option'': one of
	** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;		** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;
	** '''link=''' (with an empty value) � ({{mediawiki\|rev:41727\|MediaWiki 1.14+}}) Displays an image without any activable link; e.g. <code><nowiki>[[</nowiki>File:Example.jpg\|20px\|link=]]</code> renders as [[File:Example.jpg\|20px\|link=]].		** '''link=''' (with an empty value) � ({{mediawiki\|rev:41727\|MediaWiki 1.14+}}) Displays an image without any activable link; e.g. <code><nowiki>[[</nowiki>File:Example.jpg\|20px\|link=]]</code> renders as [[File:Example.jpg\|20px\|link=]].

Ibjadmin: /* Syntax */

2010-07-07T18:05:28Z

Syntax

← Older revision		Revision as of 20:05, 7 July 2010
Line 13:		Line 13:

	where ''options'' can be zero or more of the following, separated by pipes ('''\|'''):		where ''options'' can be zero or more of the following, separated by pipes ('''\|'''):
	* ''~~[[#~~Format~~\|Format]]~~'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail''');		* ''Format'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail''');
	*: Controls how the rendered image is formatted and embedded in the rest of the page.		*: Controls how the rendered image is formatted and embedded in the rest of the page.
	* ''[[#Size and Frame\|Resizing]]'' option: one of		* ''[[#Size and Frame\|Resizing]]'' option: one of
Line 24:		Line 24:
	* ''[[#Horizontal alignment\|Horizontal alignment]]'' option: one of '''left''', '''right''', '''center''', '''none''';		* ''[[#Horizontal alignment\|Horizontal alignment]]'' option: one of '''left''', '''right''', '''center''', '''none''';
	*: Controls the horizontal alignment (and inline/block or floatting styles) of the image within a text (no default value).		*: Controls the horizontal alignment (and inline/block or floatting styles) of the image within a text (no default value).
	* ''~~[[#~~Vertical alignment~~\|Vertical alignment]]~~ option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';		* ''Vertical alignment'' option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';
	*: Controls the vertical alignment of a non-floatting inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle''').		*: Controls the vertical alignment of a non-floatting inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle''').
	* ''[[#Altering the default link target\|Link]] option'': one of		* ''[[#Altering the default link target\|Link]] option'': one of

Ibjadmin: Created page with '== Supported media types for images == The file name extension (remapped to lowercase) is used to determine the supported media type for images and to retrieve its internal prefe�'

2010-07-07T18:04:42Z

Created page with '== Supported media types for images == The file name extension (remapped to lowercase) is used to determine the supported media type for images and to retrieve its internal prefe�'

New page

== Supported media types for images ==
The file name extension (remapped to lowercase) is used to determine the supported media type for images and to retrieve its internal preferred dimensions:
* .jpg or .jpeg : bitmap image compressed in the standard JPEG format (this lossy format is most suitable for photographs).
* .png : bitmap image in the ''Portable Network Graphics'' format (specified by the ''W3 Consortium'').
* .gif : bitmap image in the legacy ''Graphics Interchange Format''.
* .pdf : multipaged documents in the ''Portable Document Format'' (initially specified by ''Adobe'').

== Rendering a single image ==

=== Syntax ===
The full syntax for displaying an image is:
<nowiki>[[</nowiki>File:''file name.extension''|''options''|''caption'']]

where ''options'' can be zero or more of the following, separated by pipes ('''|'''):
* ''[[#Format|Format]]'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail''');
*: Controls how the rendered image is formatted and embedded in the rest of the page.
* ''[[#Size and Frame|Resizing]]'' option: one of
** ''{width}'''''px''' � Resizes the image to fit within the given maximum width in pixels, without restricting its height;
** '''x'''''{height}'''''px''' � Resizes the image to fit within the given maximum height in pixels, without restricting its width;
** ''{width}'''''x'''''{height}'''''px''' � Resizes the image to fit within the given width and height in pixels;
** '''upright''' � Resizes an image to fit within reasonnable dimensions, according to user preferences (suitable for images whose height is larger than width).
*: Note that the image will always retain its aspect ratio, and can only be reduced in size if it's not in a scalable media type such as SVG (bitmap images cannot be scaled up).
*: The default maximum size depends on the ''format'' and the internal image dimensions (according to its media type).
* ''[[#Horizontal alignment|Horizontal alignment]]'' option: one of '''left''', '''right''', '''center''', '''none''';
*: Controls the horizontal alignment (and inline/block or floatting styles) of the image within a text (no default value).
* ''[[#Vertical alignment|Vertical alignment]] option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';
*: Controls the vertical alignment of a non-floatting inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle''').
* ''[[#Altering the default link target|Link]] option'': one of
** '''link='''''{target}'' � Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface;
** '''link=''' (with an empty value) � ({{mediawiki|rev:41727|MediaWiki 1.14+}}) Displays an image without any activable link; e.g. <code><nowiki>[[</nowiki>File:Example.jpg|20px|link=]]</code> renders as [[File:Example.jpg|20px|link=]].
*: Note that the '''link''' option cannot be used in conjunction with '''thumb''' or '''thumbnail''', as '''thumb''' is always meant to link to the larger version of the image.
*: In addition, '''link''' cannot be used with '''frame'''.
* Other specific options:
** '''alt='''''{alternative text}'' � ({{mediawiki|rev:41837|MediaWiki 1.14+}}) Defines the alternative text (maps to the HTML attribute <code>alt="..."</code> of the generated <code><image /></code> element) of an image that will be rendered if either the referenced image cannot be downloaded and embedded, or if the support media must use the alternative description text (e.g. when using a Braille reader or with accessibility options set by the user in its browser).
** '''page='''''{number}'' � Renders the specified page number (currently only applicable when showing a .djvu or .pdf file).

The options can be given in any order. If the given ''options'' conflict each other, the latter is applied, except for the ''format'' options, where the options take the priority in the order of: '''frame'''; '''thumb''' (or '''thumbnail'''); '''frameless''' and/or '''border'''.

If a parameter does not match any of the other possibilities, it is assumed to be the caption text. Caption text shows below the image in '''thumb''' and '''frame''' formats, or as mouseover text in '''border''', '''frameless''' formats or when the format is omitted. Caption text displayed in the '''thumb''' and '''frame''' formats may contain wiki links and other formatting. In the other options, wiki-formatting will not work though transclusion will.

If no caption text is supplied, a caption is automatically created showing the file name. To completely remove the caption, set it to <code><nowiki></nowiki></code>. For example, <code><nowiki>[[File:Example.jpg|20px|]]</nowiki></code> renders as [[File:Example.jpg|20px|]].