Jump to content

Help:Images: Difference between revisions

From LabVIEW Wiki
m 1 revision(s)
Update to syntax of current version of MediaWiki (link to comprehensive guide on MediaWiki)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{PD Help Page}}
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__
{| {{Prettytable}}
 
|-
==Uploading images==
|{{Hl3}}|'''Description'''
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.
|{{Hl3}}|'''You type'''  
 
|{{Hl3}}|'''You get'''
==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 /> (with alt text)
|Embed an image<br> (with alt text)
|
|
<code><nowiki>[[Image:Example.jpg|Sunflowers]]</nowiki></code>
<code><nowiki>[[File:Example.jpg|Sunflowers]]</nowiki></code>
|
|
[[Image:Example.jpg|Sunflowers]]
[[File:Example.jpg|Sunflowers]]
|-
|-
|Link to description page
|Link to the description page
|
|
<code><nowiki>[[:Image:Example.jpg]]</nowiki></code><br />
<code><nowiki>[[:File:Example.jpg]]</nowiki></code><br>
<code><nowiki>[[:Image:Example.jpg|Sunflowers]]</nowiki></code>
<code><nowiki>[[:File:Example.jpg|Sunflowers]]</nowiki></code>
|
|
[[:Image:Example.jpg]]<br />
[[:File:Example.jpg]]<br>
[[:Image:Example.jpg|Sunflowers]]
[[: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 /> (centered, 100 pixels<br /> wide, with caption)
|Thumbnail<br> (centered, 100 pixels<br> wide, with caption)
|
|
<code><nowiki>[[Image:Example.jpg|center|thumb|100px|Sunflowers]]</nowiki></code>
<code><nowiki>[[File:Example.jpg|center|thumb|100px|Sunflowers]]</nowiki></code>
|
|
[[Image:Example.jpg|center|thumb|100px|Sunflowers]]
[[File:Example.jpg|center|thumb|100px|Sunflowers]]
|}
|}
==Uploaded files==
To use an image or other file which has been [[Help:Managing files|uploaded to the wiki]], use:
*<code><nowiki>[[Image: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>[[Image: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>[[:Image:Example.jpg]]</nowiki></code>
To bypass the description page and link directly to a file , use the "Media" 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>[[:Image:Example.jpg|link text]]</nowiki></code>
*<code><nowiki>[[Media:Example.jpg|link text]]</nowiki></code>


===Advanced options===
===Advanced options===
The full syntax for displaying an image is:
The full syntax for displaying an image is:
  <code><nowiki>[[Image:{name}|{options}]]</nowiki></code>
  <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 [[gallery]] of thumbnails with the <code><nowiki><gallery></nowiki></code> tag. The syntax is:
It's easy to make a gallery of thumbnails with the <code><nowiki><gallery></nowiki></code> tag. The syntax is:
<pre>
<pre>
<gallery>
<gallery>
Image:{filename}|{caption}
File:{filename}|{caption}
Image:{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:
For example,
<pre>
<pre>
<gallery>
<gallery>
Image:Example.jpg|Item 1
File:Example.jpg|Item 1
Image:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg|a link to [[Help:Contents]]
Image:Example.jpg|70px
File:Example.jpg|70px
Image:Example.jpg
File:Example.jpg
Image:Example.jpg|''italic caption''
File:Example.jpg|''italic caption''
</gallery>
</gallery>
</pre>
</pre>
is formatted as:
is formatted as:
<gallery>
<gallery>
Image:Example.jpg|Item 1
File:Example.jpg|Item 1
Image:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg|a link to [[Help:Contents]]
Image:Example.jpg|70px
File:Example.jpg|70px
Image:Example.jpg
File:Example.jpg
Image:Example.jpg|''italic caption''
File:Example.jpg|''italic caption''
</gallery>
</gallery>


==Other files==
==See also==
You can link to an external file using the same syntax used for [[Help:Links#External links|linking to an external web page]]. This feature has to be enabled by the admin; in the new releases of MediaWiki its disabled due to security reasons.
* [[Help:Managing files]]
*<code><nowiki>[http://url.for/some/image.png]</nowiki></code>
Or with different text:
*<code><nowiki>[http://url.for/some/image.png link text here]</nowiki></code>
 
If it is enabled on your wiki, you can also embed external images. To do that, simply insert the url:
*<code><nowiki>http://url.for/some/image.png</nowiki></code>
 
== Administration of images/files ==
 
See here: [[Manual:Image Administration]]
 
==External Links==
{{meta|Help:Images and other uploaded files}}


{{Languages|Help:Images}}
==External links==
* [https://www.mediawiki.org/wiki/Help:Images Help:Images - MediaWiki]


[[Category:Help|Images]]
[[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

Description You type You get
Embed an image
(with alt text)

[[File:Example.jpg|Sunflowers]]

Sunflowers

Link to the description page

[[:File:Example.jpg]]
[[:File:Example.jpg|Sunflowers]]

File:Example.jpg
Sunflowers

Link directly to the file

[[Media:Example.jpg]]
[[Media:Example.jpg|Sunflowers]]

Media:Example.jpg
Sunflowers

Thumbnail
(centered, 100 pixels
wide, with caption)

[[File:Example.jpg|center|thumb|100px|Sunflowers]]

Sunflowers

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, or frame: Controls how the image is formatted
  • left, 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:

See also

External links