RedmineFiles » History » Revision 3

Revision 2 (James Rowe, 2010-09-23 21:21) → Revision 3/10 (James Rowe, 2010-09-23 22:03)

h1. RedmineFiles 


 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. system. 

 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!@ @!image_name.ext!@ within the parent. wiki. 


 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). 


 h2. Files added via "New File" 

 At the bottom of many of the attached to issues/wiki 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.