authors (intermediate)

### Attach: Syntax

PmWiki can be configured to allow authors to upload and attach files to pages. Each WikiGroup can have its own collection of named attachments that are shared among all pages in the group. To add or link to an attachment, an author edits a page to include the markup "Attach:" followed by a name of an attachment (e.g., "Attach:resume.pdf"). When the page is displayed, the Attach: markup becomes one of the following:

• A link to the named attachment
• A link to a form whereby the author can specify a file to be uploaded and used as the new attachment
• If the attachment is an image file such as .gif, .jpg, or .png, then it is displayed as an image.

To prevent an image attachment from displaying as an image, place it in double brackets (e.g., [[Attach:image.jpg]]).

To have a link to an attachment appear without the "Attach:" at the beginning of the link, use [[(Attach:)file.ext]].

To link to attachments on another page or Wiki Group, use Attach:PageName/file.ext or Attach:Group.PageName/file.ext.

To link to an uploaded image from another group, you need to refer to a page within another group, not just the group itself. Thus, Attach:Group.SomePage/image_name.ext. Note, you must use the , but that there is no requirement that the page actually exist.

### Listing All Files For A Page

To list all files that have been uploaded to the current page, enter the markup: (:attachlist:)

This will list all files, file size and a link to download the file on the page.