When creating a wiki page for information and file sharing, the upload of files and images are important. In this context "files" refer to files that are not explicitly displayed on the wiki, for instance this pdf file. "Images" refer to pictures and graphs shown on the wiki pages, for example the logo panel on the Main Page and the photo on the pH rig page.
Uploading and using images on the wiki is a simple procedure using only the web browser.
- Click the Upload file link on the left (below Toolbox). You must be logged in to upload.
- Click Browse to select the image to upload (permitted file types: png, gif, jpg, jpeg)
- Fill in a filename (important) and description and click Upload file.
Inserting in pages
Using the filename as entered when uploading the image, one of the following forms can be used to display the image;
- [[File:File.jpg]] to use the full version of the file
- [[File:File.png|200px|thumb|left|alt text]] to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
The Mediawiki image help page can be consulted for more explanations and options when using images.
The wiki also supports external images (i.e. images not uploaded using the Upload file link). There are some issues which needs to be noted when using this feature;
- External, used here, refers only to sites on the UP network - the server does not have proxy access.
- At present, only the http protocol is supported. Public ftp files can be accessed (using http) with the following link: http://ragnarok.up.ac.za/ftp/
- Using image commands (e.g. thumbnailing and resizing) is not possible as these commands are performed by the wiki only on files which have been uploaded to it. In short, a large image will be displayed in its original size.
- Usage: simply use the url of the image, e.g. http://web.up.ac.za/images/UP_centenary_logo.jpg
Uploading files to the wiki requires an ftp client (Windows Explorer also works). Most ftp clients have a GUI making file uploading very similar to file management in a file manager such as Windows Explorer or Nautilus. Anonymous access to the ftp or simply ftp://ragnarok/publicftp (type this in the Windows Explorer address bar) allows for file uploading in the publicftp directory (or its subdirectories).
Linking to files
Once uploaded, the files can be linked to in a page using standard external links (as explained in the formatting/links help page). As an example, the Ubuntu Pocket Guide can be linked to using;
[ftp://ragnarok/publicftp/documents/linux/ubuntupocketguide-v1-1.pdf Ubuntu Pocket Guide]
which generates this; Ubuntu Pocket Guide