Linking Files
Downloadable Files
Files (binary and otherwise) can be linked by the [file:] command with the name of the file as its argument.
[file:TechnicalDetails.pdf]
creates a link to the local file TechnicalDetails.pdf. File names, like page names, must be chosen following the local naming conventions. The base name of a file follows the same rules as the name of a page. Unlike pages, however, all file names end with a suffix, that is, an extension that is separated from the base name using a period character (.). Note that files are linked using a command placed in single brackets instead of the double brackets used with pages.
Clicking on a file link evoked via [file:] causes the linked file to be downloaded to the users hard disk. If the link file does not exist (yet), the user is asked to upload it instead to complete the new link.
Images
Images are treated as a special kind of files. Images are displayed on your page instead of being just linked as a downloadable file. Use the [image:] command to link a file as an image:
[image:MyPortrait.jpg]
Because this image does not exist (because you haven't uploaded it yet), it won't show up in your document, but will just appear in form of its alternate text, or, if you didn't provide any, as an image placeholder, an X in a circle. Unlike pages, you cannot just click this symbol to upload the image, but have to list all the links of the page, including the image, and follow the link provided for it. You get this list with all the links of a page by Verifying the page.
Like pages, an image can be provided with an alternate text that is shown when the user moves the mouse pointer over the image. Separate the alternate text from the file name using the | character, just the way it is used with pages:
[image:MyPortrait.jpg|That's me!]
Preview Images
To embed a preview of an image in the content of a page, use the [preview:] command with the name of the image as its argument. Doing so, inserts a preview, a so-called thumbnail, into the document. To open and view the original image in full format in a new browser window, click the preview thumbnail. The actual size, geometry and style of previews is derived from the preview CSS class, which is defined in the local server setup. Like with ordinary, unscaled images, a preview image may have an alternate text specified.
[preview:TempleEntranceFront.jpg|Front view of the entrance to the temple] [preview:TempleEntranceLeft.jpg|Side view of the entrance to the temple]
Media Files
To embed arbitrary media files, like movies and sound, into your document use the [media:] or [embed:] command:
[media:RadioShow.mp3] [media:ShockWaveFlashMovie.swf]
If you provide parameter assignments as the link's alternate text, these values are treated as specifiers for the embedded object:
[media:MovieTrailer.mpg|width="320" height="240"]
All images and media files can be treated as ordinary, downloadble files. Just use the [file:] command instead of the [image:] or [media:] command.
Links, images and alternate text can be combined with one another in this very order. To create a link to a local page or external resource in form of a clickable image whose alternate text is also being provided, you would create a link like this:
[[http://pie.ekkaia.org/|image:LocalImage.png Portal to Pie]]
This creates a link to http://pie.ekkaia.org/ using the image LocalImage.png as a portal and the string Portal to Pie as an alternate text.