×
Namespaces

Variants
Actions
(Redirected from FNWiki:Quick help - Media)

Help:Files & Images

From Nokia Developer Wiki
Jump to: navigation, search
Help.png
This Help topic explains how to create and work with files, images and galleries of images. It is intended to complement the more exhaustive generic mediawiki topics Help:Images and Help:Managing_files.


The basic syntax is the same for both images and other files - the only difference being that image files (in supported formats) are rendered as their image rather than as a file link. If you link to a file/image that does not yet exist the link is rendered as a red link - clicking on the link takes you to a page where you can upload the file. Alternatively you can upload the file from the appropriate option in the wiki sidebar Toolbox section.

Contents

Using the wiki editor

Files and images are most easily added using the Wiki Editor Embedded File button highlighted on the left below. Simply highlight the target file then click the tool button (alternatively you can just press the tool to create boilerplate wiki text then copy-paste in the names of your files).

WikiEditorAdvancedFileGalleryTool.png

Galleries are added using Gallery tool on the right; again you can select the list of files to be in the gallery then select the tool button.

The tools create, by default, syntax for the most basic image/gallery. It is possible to customise sizes, position, how text wraps, frames, captions etc., as discussed in the following sections.

Tip.pngTip: It is important to give your files descriptive names. Names like "Example.jpg" or "1.png" can make them hard to find later.

Files

The syntax for linking to a file is shown below. The first line shows the default syntax, the second shows how to define custom link text (note the preceding colon and pipe separator)

[[File:NotifierExample.zip]]
[[:File:NotifierExample.zip|Text to be displayed for link]]

If the file doesn't exist you can open the link to upload it (or select the sidebar option Toolbox | Upload file) and provide a file description. If the file does exist then selecting the link takes you to the file description page, from which users can download it.

If you need to link direct to the file rather than its description you can use the "Media" namespace:

[[Media:bulb_small.jpg]] 

Images

The recommended image style is to display the image on it's own line (left aligned) and have a border and caption. This can be done using a "frame" or "thumb" and using "none" to force left alignment. The difference between "frame" and "thumb" is that "frame" displays the image full size, while the thumb allows you to specify any size smaller than the full image size.

[[File:bulb_small.jpg|none|thumb|100px|A light bulb]] 
A light bulb

Remember that the file/image you upload must belong to you, or you must have the right to upload it. If you do use a file that belongs to someone else then always attribute it by linking to where it came from.

The full image syntax is provided here: Help:Images.

Minimum syntax (no frame)

The most basic syntax for adding an image is shown below. This is the same syntax as for adding any other file, and displays the image at its full size and without frame or caption and in-line with text.

This file is inline  [[File:bulb_small.jpg]] with the text.

This file is inline Bulb small.jpg with the text.

You can also specify the width of the image to be any size (just specify the size and units), whether the image is on its own line or left-right floated using none, right, left, and use link=URL or page name to link the image:

[[File:bulb_small.jpg|50px|none|link=Azure - Mobile Services on Windows Phone]] 
Bulb small.jpg

Frames and thumbnails

As described in the first section, you can use "frame" or "thumb" to put a border around the image, and then you can also provide a caption. The image is displayed in-line with text, in its full size, without a frame or caption. All of these parameters can be specified using the syntax described in . It is common (but not mandatory) on this wiki to use a frame and caption, and to left align images without text wrapping. Using the previous image, this would be done with the wiki text:

[[File:bulb_small.jpg|none|frame|A light bulb]] 
A light bulb

The "frame" displays the image at full size. If you use "thumb" you can get a default minimum size, or specify any size less than the full size:

[[File:bulb_small.jpg|none|thumb|A light bulb thumbnail at default size]] 
A light bulb
[[File:bulb_small.jpg|none|thumb|100px|A light bulb thumbnail with size set to 100px ]] 
A light bulb

Link to file rather than display image

If you need to link direct to the file description page you can use a colon preceding "File:":

[[File:bulb_small.jpg]] 

If you need to link direct to the file itself you can use the "Media" namespace:

[[Media:bulb_small.jpg]] 

Note.pngNote: Don't use the "Image" prefix. While this is "supported", it is deprecated.

Galleries

A gallery is simply a list of image files (one per line) surrounded by <gallery> ... </gallery> tags. You can optionally add a caption for each image by adding a pipe (|) after the filename. You can also change the number of images per row, their sizes and heights, and the caption for the whole gallery. The full syntax is given in Help:Images#Rendering_a_gallery_of_images

An example of the syntax and rendering of a gallery with individual and gallery captions is given below:

<gallery caption="Gallery caption">
File:bulb_small.jpg|An individual image caption
File:bulb_small.jpg
</gallery>