Uploading and embedding files and images

From ISPGR Wiki

Jump to: navigation, search

General Principles

  • By default you are only allowed to upload certain types of files (extensions gif, jpg, jpeg ogg, and png).
  • The preferred formats are JPEG for photographic images with millions of colors and shades; PNG for fixed-color pixelated images such as icons; OGG for audio.
  • It is recommended images file sizes are 150KB or less.
  • For reasons of security executable programs are not allowed by default.

Uploading Images and Files

  • Click the Upload file link in the toolbox.
  • On the Upload file screen click Browse next to the source filename field to locate your file.
  • If the source filename is different from the standard naming convention (i.e., ispgrWiki-DescriptiveFilenameHere.jpg) you can rename it in the destination filename field.
  • Write a brief summary describing the file.
  • Click Upload file.
  • The file names are case-sensitive (this applies even for the file name extension) except, in most wikis, for the first character.

Embedding Images

  • To embed an internal file in a text, you just have to specify its file name with the internal link syntax ([[ ]]). Thus, [[image:Icon_pdf.gif]] gives image:Icon_pdf.gif
  • You may embed images that are uploaded to the ISPGR Wiki or [[1]]. An image name is assumed to refer to the one in the ISPGR Wiki if it exists there, otherwise to one on Commons. If neither exists a link to the upload page appears, with class="new" ("red link").
  • Only images proper can be automatically presented, sound is not automatically played.
  • An embedded internal image automatically links to the image page, which shows the full image, or, depending on preferences, a reduced version with a link to the full version. The page also provides info about the image.

Options

The internal-link style markup for embedding a file can take various options separated with a pipe character ("|"). In brief, they are [[Image:{name}|{type}|{location}|{size}|{upright}|{border}|{caption}]].

  • Type: 'thumb' / 'thumbnail' or 'frame'. Causes image to be displayed with specific formatting.
  • Location: 'right', 'left', 'center' or 'none'. Determines placement of the image on the page. Defaults to 'right', when combined with 'thumb' or 'frame'.
  • Size: {width}px or {width}x{height}px, scales the image to be no greater than the given width and height, keeping its aspect ratio.
  • Upright: for use only on images that are taller than they are wide. This scales the image differently, considering both width and height instead of only width.
  • Border: adds a border around the image.
  • Caption: Any element which cannot be identified as one of the above is assumed to be caption text.
  • Link: To allow an image to link to an arbitrary title, URL or just nowhere.
Help