×
Namespaces

Variants
Actions
Revision as of 02:43, 23 February 2013 by Vitor Pombeiro (Talk | contribs)

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 most basic syntax for adding an image is shown below. This is the same syntax as for adding any other file -

[[File:bulb_small.jpg]] 

Tip.pngTip: 

  • 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]] 
  • Don't use the "Image" prefix. While this is "supported", it is deprecated.


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 Help:Images. 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

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>
 
×