Project

General

Profile

RedmineFiles » History » Version 3

James Rowe, 2010-09-23 22:03
expanded sections, more on file upload process, usage

1 1 Huyen Khanh
h1. RedmineFiles
2 2 James Rowe
3
{{toc}}
4
5
h2. Introduction
6
7 3 James Rowe
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.
8 1 Huyen Khanh
9 3 James Rowe
h2. Usage
10
11
h3. Inline Images
12
13
Attached files can be shown within the parent page by targeting it's name via image url (i.e. @!attached_image!@).
14
15
h3. Non plain text files
16
17
Keep in mind there is a [[RedmineDocuments]] module for storing technical and user documentation that can be linked via the wiki.
18
19
However, if that doesn't fit the bill, file upload support provides a way to distribute any file for user download.
20
21
h2. File storage
22
23
All uploaded files are stored at the @/{install dir}/files@ directory.
24
25
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.
26
27 2 James Rowe
h2. Attach files form
28
29 1 Huyen Khanh
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.
30 2 James Rowe
31 3 James Rowe
The optional description is used for an @alt@ text if the image is shown using @!image_url!@ within the parent.
32 2 James Rowe
33
!UploadFile.png!
34 1 Huyen Khanh
35
h2. Files Module
36
37 3 James Rowe
Each project can have a files module enabled/disabled via the settings menu.
38
39
A sortable HTML table shows the details on the uploaded files. Of note are the MD5 hash, and D/L(Download Count).
40
41
!Files.png!
42
43
h2. Files added via "New File"
44
45
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.
46
47
See the [[RedmineFiles#Usage|Usage]] section for more information.