> HelpOnActions/AttachFile

The following 155 words could not be found in the dictionary of 7206 words (including 7206 LocalSpellingWords) and are highlighted below:

abused   action   add   addition   After   after   allow   Any   any   applet   Attach   attached   attachment   attachments   attacks   Atttach   automatically   be   behaviour   below   blank   break   built   case   change   changes   click   clicking   Clicking   Configuration   conflict   consist   content   copy   could   deletion   Denial   details   detected   diagrams   difference   different   directly   displayed   displaying   displays   Draw   draw   drawing   drawings   easily   either   enabled   Enabling   existing   explained   ext   extension   fields   filename   first   follows   form   generated   get   gif   highlighted   how   if   inline   inlined   input   Instead   instead   interactively   Java   just   keep   kind   lead   left   lets   like   Linking   links   looking   means   need   never   new   next   normal   not   optional   or   original   Otherwise   otherwise   overwrite   own   pages   picture   picturename   pictures   Plugins   possible   py   reconfigurations   refer   reflected   results   revert   review   rules   save   saved   Saving   saving   second   section   shown   simple   Since   since   sources   specify   store   syntax   than   then   these   they   third   this   though   three   thus   tries   two   type   Unlike   upload   Upload   uploads   used   using   vandalism   vector   view   want   while   will   works   you   your  

Clear message

1. Enabling the AttachFile action

The AttachFile action lets a page have multiple attached files. Since file uploads could be abused for DoS (Denial of Service) attacks, AttachFile is an action that has to be enabled by the wiki administrator. See [Self]Configuration of MoinMoin for details.

2. Creating attachments

To create a new attachment, you can either add an attachment link to any page (see below on how to do that), or click on the AtttachFile link at the bottom of the page. In the first case, you will see an Upload new attachment link after saving the page. Clicking on it will lead you to the upload page, just like directly clicking on the AttachFile link.

The upload form consist of three fields, in addition to the file input there are two optional fields, one to specify a MIME type for the file (which will be detected automatically otherwise), the second to store the file under a different name than on your own computer.

An upload will never overwrite an existing file. If there is a name conflict, you have to rename the file that you want to upload. Otherwise, if "Rename to" is left blank, the original filename will be used.

Any upload or deletion of attachments is reflected on RecentChanges and thus subject to peer review. Unlike page changes, there is no history though, so keep a local copy of files so you can revert possible vandalism.

3. Linking to attachments

To refer to attachments on a page, use attachment:filename.ext; a link of this kind follows all the rules for normal links, i.e. pictures are automatically inlined. Do not use the URL of the [get] link you can see on the attachments upload page, since these links are subject to change and can break easily on reconfigurations of the wiki. To refer to files attached to other pages, use attachment:WikiName/filename.ext.

Instead of attachment:, you can also use inline:, which tries to inline the attachment's content. For pictures there is no difference. For Python sources (i.e. attachments with a .py extension), they are shown as syntax-highlighted source displays. For all other files, the behaviour is the same as for simple attachment: links.

The third type of link is drawing:, explained in the next section.

4. Editing vector drawings

A link looking like drawing:picturename will allow you to interactively edit vector diagrams via the built-in Java applet. The applet will then store two attachments, "picturename.draw" and "picturename.gif". After you first saved a drawing, the generated GIF picture is displayed for the drawing: link. This means that you only need Java enabled for editing, while displaying the results works with any browser.

To edit a drawing after the first save, click on AttachFile and use the [edit] link that is displayed instead of [view] for the .draw attachment. Saving a drawing is reflected in RecentChanges.

For details on using the drawing applet, see [TWiki]Plugins/TWikiDrawPlugin.