RedmineAttachedFiles » History » Version 1

Mischa The Evil, 2010-10-17 06:05
Pulled from [[RedmineFiles]]; Initial version with "Attached Files"-content only

1 1 Mischa The Evil
h1. Redmine Attached Files
2 1 Mischa The Evil
3 1 Mischa The Evil
{{>toc}}
4 1 Mischa The Evil
5 1 Mischa The Evil
h2. Introduction
6 1 Mischa The Evil
7 1 Mischa The Evil
Attached files can be added to just about anything in the Redmine system where you see a "New File" link at the bottom of the page.
8 1 Mischa The Evil
9 1 Mischa The Evil
h2. Usage
10 1 Mischa The Evil
11 1 Mischa The Evil
h3. Inline Images
12 1 Mischa The Evil
13 1 Mischa The Evil
Attached files can be shown within the parent page by targeting it's name via image url (i.e. @!attached_image!@).
14 1 Mischa The Evil
15 1 Mischa The Evil
h3. Non plain text files
16 1 Mischa The Evil
17 1 Mischa The Evil
Keep in mind there is a dedicated [[RedmineDocuments|documents]] module for storing technical and user documentation that can be linked via the [[RedmineWikis|wiki]] and a dedicated [[RedmineFiles|files]] module for publishing versions of the tracked project, as a bundle (release).
18 1 Mischa The Evil
19 1 Mischa The Evil
However, if that doesn't fit the bill, file upload support provides a way to distribute any file for user download.
20 1 Mischa The Evil
21 1 Mischa The Evil
h2. File storage
22 1 Mischa The Evil
23 1 Mischa The Evil
All uploaded attached files are stored at the @/{install dir}/files@ directory.
24 1 Mischa The Evil
25 1 Mischa The Evil
The uploaded file name is prefixed with a unique id based on it's parent for directory storage. Multiple files can be uploaded with the same name, however a link within the wiki will only show the most recently uploaded one.
26 1 Mischa The Evil
27 1 Mischa The Evil
h2. Attach files form
28 1 Mischa The Evil
29 1 Mischa The Evil
Regardless where an attached file is added, the input form is as shown below. Adding multiple attached files at once is possible using the "Add another file" link.
30 1 Mischa The Evil
31 1 Mischa The Evil
The optional description is used for an @alt@ text if the image is shown using @!image_url!@ within the parent.
32 1 Mischa The Evil
33 1 Mischa The Evil
!UploadFile.png!
34 1 Mischa The Evil
35 1 Mischa The Evil
h2. Files added via "New File"
36 1 Mischa The Evil
37 1 Mischa The Evil
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.
38 1 Mischa The Evil
39 1 Mischa The Evil
See the [[RedmineFiles#Usage|Usage]] section for more information.