Help:Images: Difference between revisions
Update to syntax of current version of MediaWiki (link to comprehensive guide on MediaWiki) |
|||
| (7 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
This article explains the '''image''' syntax when editing the wiki. For a comprehensive guide go to [https://www.mediawiki.org/wiki/Help:Images Help:Images - MediaWiki]. | |||
__TOC__ | __TOC__ | ||
|- | ==Uploading images== | ||
|{ | Images must be [[Help:Managing files|uploaded]] to LabVIEW Wiki before they can be rendered on a page. The most convenient way is to do it after writing the article. Images that don't exist will appear as <font color="red"><u>red</u></font> links that point to the upload page of the particular image. When the image is finally available, it will be displayed on the page without further changes. | ||
==Rendering images== | |||
Images are rendered by using the <code>File:</code> namespace prefix as the target of a [[Help:Wikilink|wikilink]]. | |||
To use an image or other file which has been [[Help:Managing files|uploaded to the wiki]], use: | |||
<code><nowiki>[[File:Example.jpg]]</nowiki></code> | |||
If you add a pipe (|) and some text after the filename, the text will be used as alternative text for text-only browsers: | |||
<code><nowiki>[[File:Example.jpg|alternative text]]</nowiki></code> | |||
If you don't want to display the image, you can link to the file's description page, by adding a colon: | |||
<code><nowiki>[[:File:Example.jpg]]</nowiki></code> | |||
To bypass the description page and link directly to a file, use the <code>Media:</code> pseudo-namespace: | |||
<code><nowiki>[[Media:Example.jpg]]</nowiki></code> | |||
You can also make piped links if you want some other text to be used: | |||
<code><nowiki>[[:File:Example.jpg|link text]]</nowiki></code> | |||
<code><nowiki>[[Media:Example.jpg|link text]]</nowiki></code> | |||
'''Examples''' | |||
{| class="wikitable" | |||
!'''Description''' | |||
!'''You type''' | |||
!'''You get''' | |||
|- | |- | ||
|Embed image<br | |Embed an image<br> (with alt text) | ||
| | | | ||
<code><nowiki>[[ | <code><nowiki>[[File:Example.jpg|Sunflowers]]</nowiki></code> | ||
| | | | ||
[[ | [[File:Example.jpg|Sunflowers]] | ||
|- | |- | ||
|Link to description page | |Link to the description page | ||
| | | | ||
<code><nowiki>[[: | <code><nowiki>[[:File:Example.jpg]]</nowiki></code><br> | ||
<code><nowiki>[[: | <code><nowiki>[[:File:Example.jpg|Sunflowers]]</nowiki></code> | ||
| | | | ||
[[: | [[:File:Example.jpg]]<br> | ||
[[: | [[:File:Example.jpg|Sunflowers]] | ||
|- | |- | ||
|Link directly to file | |Link directly to the file | ||
| | | | ||
<code><nowiki>[[Media:Example.jpg]]</nowiki></code><br | <code><nowiki>[[Media:Example.jpg]]</nowiki></code><br> | ||
<code><nowiki>[[Media:Example.jpg|Sunflowers]]</nowiki></code> | <code><nowiki>[[Media:Example.jpg|Sunflowers]]</nowiki></code> | ||
| | | | ||
[[Media:Example.jpg]]<br | [[Media:Example.jpg]]<br> | ||
[[Media:Example.jpg|Sunflowers]] | [[Media:Example.jpg|Sunflowers]] | ||
|- | |- | ||
|Thumbnail<br | |Thumbnail<br> (centered, 100 pixels<br> wide, with caption) | ||
| | | | ||
<code><nowiki>[[ | <code><nowiki>[[File:Example.jpg|center|thumb|100px|Sunflowers]]</nowiki></code> | ||
| | | | ||
[[ | [[File:Example.jpg|center|thumb|100px|Sunflowers]] | ||
|} | |} | ||
===Advanced options=== | ===Advanced options=== | ||
The full syntax for displaying an image is: | The full syntax for displaying an image is: | ||
<code><nowiki>[[ | <code><nowiki>[[File:{name}|{options}]]</nowiki></code> | ||
Where options can be zero or more of the following, separated by pipes: | Where <code><nowiki>{options}</nowiki></code> can be zero or more of the following, separated by pipes: | ||
*<code>thumb</code>, <code>thumbnail</code>, or <code>frame</code>: Controls how the image is formatted | *<code>thumb</code>, <code>thumbnail</code>, or <code>frame</code>: Controls how the image is formatted | ||
*<code>left</code>, <code>right</code>, <code>center</code>, <code>none</code>: Controls the alignment of the image on the page | *<code>left</code>, <code>right</code>, <code>center</code>, <code>none</code>: Controls the alignment of the image on the page | ||
| Line 61: | Line 67: | ||
===Gallery of images=== | ===Gallery of images=== | ||
It's easy to make a | It's easy to make a gallery of thumbnails with the <code><nowiki><gallery></nowiki></code> tag. The syntax is: | ||
<pre> | <pre> | ||
<gallery> | <gallery> | ||
File:{filename}|{caption} | |||
File:{filename}|{caption} | |||
{...} | {...} | ||
</gallery> | </gallery> | ||
| Line 71: | Line 77: | ||
Captions are optional, and may contain wiki links or other formatting. | Captions are optional, and may contain wiki links or other formatting. | ||
For example, | |||
<pre> | <pre> | ||
<gallery> | <gallery> | ||
File:Example.jpg|Item 1 | |||
File:Example.jpg|a link to [[Help:Contents]] | |||
File:Example.jpg|70px | |||
File:Example.jpg | |||
File:Example.jpg|''italic caption'' | |||
</gallery> | </gallery> | ||
</pre> | </pre> | ||
is formatted as: | is formatted as: | ||
<gallery> | <gallery> | ||
File:Example.jpg|Item 1 | |||
File:Example.jpg|a link to [[Help:Contents]] | |||
File:Example.jpg|70px | |||
File:Example.jpg | |||
File:Example.jpg|''italic caption'' | |||
</gallery> | </gallery> | ||
== | ==See also== | ||
* [[Help:Managing files]] | |||
==External links== | |||
* [https://www.mediawiki.org/wiki/Help:Images Help:Images - MediaWiki] | |||
[[Category:Help | [[Category:Help]] | ||
Latest revision as of 20:16, 18 May 2020
This article explains the image syntax when editing the wiki. For a comprehensive guide go to Help:Images - MediaWiki.
Uploading images
Images must be uploaded to LabVIEW Wiki before they can be rendered on a page. The most convenient way is to do it after writing the article. Images that don't exist will appear as red links that point to the upload page of the particular image. When the image is finally available, it will be displayed on the page without further changes.
Rendering images
Images are rendered by using the File: namespace prefix as the target of a wikilink.
To use an image or other file which has been uploaded to the wiki, use:
[[File:Example.jpg]]
If you add a pipe (|) and some text after the filename, the text will be used as alternative text for text-only browsers:
[[File:Example.jpg|alternative text]]
If you don't want to display the image, you can link to the file's description page, by adding a colon:
[[:File:Example.jpg]]
To bypass the description page and link directly to a file, use the Media: pseudo-namespace:
[[Media:Example.jpg]]
You can also make piped links if you want some other text to be used:
[[:File:Example.jpg|link text]][[Media:Example.jpg|link text]]
Examples
Advanced options
The full syntax for displaying an image is:
[[File:{name}|{options}]]
Where {options} can be zero or more of the following, separated by pipes:
thumb,thumbnail, orframe: Controls how the image is formattedleft,right,center,none: Controls the alignment of the image on the page{width}px: Resizes the image to the given width in pixels{caption text}
The options can be given in any order. If a given option does not match any of the other possibilities, it is assumed to be the caption text. Caption text can contain wiki links or other formatting.
Gallery of images
It's easy to make a gallery of thumbnails with the <gallery> tag. The syntax is:
<gallery>
File:{filename}|{caption}
File:{filename}|{caption}
{...}
</gallery>
Captions are optional, and may contain wiki links or other formatting.
For example,
<gallery> File:Example.jpg|Item 1 File:Example.jpg|a link to [[Help:Contents]] File:Example.jpg|70px File:Example.jpg File:Example.jpg|''italic caption'' </gallery>
is formatted as:
-
Item 1
-
a link to Help:Contents
-
70px
-
italic caption

