Redmine

h1. RedmineFiles

{{toc}}

h2. Introduction

Files can be added just about anywhere in the Remdine system you see a "New File" link at the bottom of the page or with the Files module via the !/images/add.png! *New File* button in the upper right hand corner.

h2. Usage

h3. Inline Images

Attached files can be shown within the parent page by targeting it's name via image url (i.e. @!attached_image!@).

h3. Non plain text files

Keep in mind there is a [[RedmineDocuments]] module for storing technical and user documentation that can be linked via the wiki.

However, if that doesn't fit the bill, file upload support provides a way to distribute any file for user download.

h2. File storage

All uploaded files are stored at the @/{install dir}/files@ directory.

Their file name is prefixed with a unique id based on it's parent. Multiple files can be uploaded with the same name, however a link within the wiki will only show the most recently uploaded one.

h2. Attach files form

Regardless where a file is added, the input form is as shown below. Adding multiple files at once is possible using the "Add another file" link.

The optional description is used for an @alt@ text if the image is shown using @!image_url!@ within the parent.

!UploadFile.png!

h2. Files Module

Each project can have a files module enabled/disabled via the settings menu.

A sortable HTML table shows the details on the uploaded files. Of note are the MD5 hash, and D/L(Download Count).

!Files.png!

h2. Files added via "New File"

At the bottom of many of the pages in Redmine is a "New File" link. Attaching a file makes that page the parent of the file and it is limited in scope to that page.

See the [[RedmineFiles#Usage|Usage]] section for more information.