You are on page 1of 69

Redmine User guide

Redmine User Guide

Document: Redmine User guide.doc Page 1 of 69


Confidential – For internal circulation only
Redmine User guide

Contents

1. Introduction ................................................................................................................................. 7
2. Accounts....................................................................................................................................... 7
2.1 My Account .......................................................................................................................... 8
2.1.1 Mail notifications ....................................................................................................... 8
2.1.2 Password ...................................................................................................................... 8
2.1 My page ................................................................................................................................ 8
2.3 Password lost.......................................................................................................................... 9
2.4 Register ................................................................................................................................ 10
3. Login .......................................................................................................................................... 10
4. Register .......................................................................................................................................11
4.1 Registration Process...............................................................................................................11
4.1.1 Account Activation by Email ...................................................................................11
4.1.2 Manual Account Activation ..................................................................................... 12
4.1.3 Automatic Account Activation ............................................................................... 12
6. Project Overview........................................................................................................................ 14
8. Activity Tracking ......................................................................................................................... 16
8.1 Listing of the activity ............................................................................................................ 16
8.1.1 Related activities ..................................................................................................... 16
8.1.2 Watchers .................................................................................................................... 17
8.1.3 Associated revisions................................................................................................. 18
8.2 Adding a new activity ........................................................................................................... 18
8.3 Updating an existing activity................................................................................................. 19
8.4 Editing an existing activity's Subject or Description ............................................................... 19
8.5 Subtasks ............................................................................................................................... 20
9. The activity list........................................................................................................................... 20
9.1 Overview .............................................................................................................................. 20
9.2 Applying and saving filters .................................................................................................... 21
9.2.1Custom queries .......................................................................................................... 21
9.3 Bulk editing activities ........................................................................................................... 22
9.4 Sidebar ................................................................................................................................. 22
10. The Change log......................................................................................................................... 23
10.1 Overview ............................................................................................................................ 23

Document: Redmine User guide.doc Page 2 of 69


Confidential – For internal circulation only
Redmine User guide

10.2 Sidebar ............................................................................................................................... 24


11. Activity summary...................................................................................................................... 24
11.1 Overview ............................................................................................................................ 25
11.2 Drill-through links ............................................................................................................... 25
11.3 Detailed reports.................................................................................................................. 25
12. Roadmap .................................................................................................................................. 26
12.1 Overview ............................................................................................................................ 26
12.2 Managing the Roadmap....................................................................................................... 27
12.3 Sidebar ............................................................................................................................... 27
13. Version overview ...................................................................................................................... 27
14. Time tracking ........................................................................................................................... 28
14.1 Introduction........................................................................................................................ 28
14.2 Installing/Configuration ...................................................................................................... 28
14.3 Logging time on an activity................................................................................................. 29
14.4 Logging time at project level .............................................................................................. 29
14.5 Accepted time formats ....................................................................................................... 29
14.5.1 Decimal time format ............................................................................................. 29
14.6 Logging time via commit messages..................................................................................... 30
15. Redmine Timelog Details .......................................................................................................... 30
15.1 Introduction........................................................................................................................ 30
15.2 Searching............................................................................................................................ 30
15.3 Results ................................................................................................................................ 31
15.3.1 HTML output ........................................................................................................... 31
15.3.2CSV output ............................................................................................................... 31
16. Redmine Timelog Report .......................................................................................................... 32
16.1 Introduction........................................................................................................................ 32
16.2 Searching............................................................................................................................ 33
16.3 Results ................................................................................................................................ 33
16.3.1 HTML output ........................................................................................................... 33
16.3.2 CSV output .............................................................................................................. 33
18. Calendar................................................................................................................................... 35
18.1 Overview ............................................................................................................................ 35
18.2 Access control..................................................................................................................... 35

Document: Redmine User guide.doc Page 3 of 69


Confidential – For internal circulation only
Redmine User guide

18.2.1 Module activation .................................................................................................. 35


18.2.2 Roles and permissions ........................................................................................... 35
18.3 Filters ................................................................................................................................. 35
19. News ........................................................................................................................................ 36
20. Redmine Documents................................................................................................................. 37
20.1 Introduction........................................................................................................................ 37
20.2 Adding Documents .............................................................................................................. 37
20.3 Viewing Documents ............................................................................................................ 38
21. Redmine Files ........................................................................................................................... 39
21.1 Files Module........................................................................................................................ 39
21.2 File storage......................................................................................................................... 39
21.3 New file form¶.................................................................................................................... 40
22. Forums ..................................................................................................................................... 40
22.1 Adding a topic..................................................................................................................... 40
23. Wikis......................................................................................................................................... 40
23.1 Creating a new wiki page.................................................................................................... 41
23.2 Creating an additional wiki side bar .................................................................................... 41
23.3 Creating sub-pages (parent/child relationships).................................................................. 41
23.4 Protecting a wiki page ........................................................................................................ 41
23.5 Wiki page history ................................................................................................................ 41
23.6 Sidebar ............................................................................................................................... 42
24. Repository Statistics.................................................................................................................. 43
24.1 Definitions .......................................................................................................................... 44
24.2 Notes .................................................................................................................................. 44
25. Project Settings ........................................................................................................................ 45
25.1 Information......................................................................................................................... 45
25.1.1 General settings ..................................................................................................... 45
25.1.2 Activity types .......................................................................................................... 46
25.1.3 Custom fields .......................................................................................................... 46
25.2 Modules .............................................................................................................................. 46
25.2.1 Core modules .......................................................................................................... 46
25.3 Members............................................................................................................................. 46
25.4 Versions .............................................................................................................................. 47

Document: Redmine User guide.doc Page 4 of 69


Confidential – For internal circulation only
Redmine User guide

25.5 Activity categories .............................................................................................................. 48


25.6 Wiki .................................................................................................................................... 48
25.7 Repository........................................................................................................................... 49
25.8 Forums ............................................................................................................................... 49
26. Redmine Attached Files ............................................................................................................ 49
26.1 Introduction........................................................................................................................ 49
26.2 Usage.................................................................................................................................. 49
26.2.1Inline Images ............................................................................................................ 49
26.2.2 Non plain text files ................................................................................................ 49
26.3 File storage......................................................................................................................... 49
Unattached uploaded files ........................................................................................... 50
26.4 Attach files form ................................................................................................................. 50
26.5 Files added via "New File"¶ ................................................................................................. 50
27. Text formatting......................................................................................................................... 50
27.1 Links ................................................................................................................................... 50
27.1.1 Redmine links ......................................................................................................... 50
27.1.2 External links .......................................................................................................... 52
27.1.3 Email addresses...................................................................................................... 53
27.2 Text formatting................................................................................................................... 53
27.2.1 Acronym ................................................................................................................... 53
27.2.2 Font style ................................................................................................................ 53
27.2.3 Inline images .......................................................................................................... 54
27.2.4 Headings .................................................................................................................. 54
27.2.5 Paragraphs .............................................................................................................. 54
27.2.6 Horizontal rule ....................................................................................................... 55
27.2.7 Predefined............................................................................................................... 55
27.2.8 Blockquotes ............................................................................................................ 55
27.2.9 Unordered lists ....................................................................................................... 56
27.2.10 Ordered lists ......................................................................................................... 56
27.2.11 Tables ..................................................................................................................... 57
27.2.11.1 Table of content ............................................................................................... 58
27.3 Macros ................................................................................................................................ 58
27.4 Code highlighting ................................................................................................................ 59

Document: Redmine User guide.doc Page 5 of 69


Confidential – For internal circulation only
Redmine User guide

28. Resource Utilization Factor................................................................................................... 60


29. Resource Allocation .............................................................................................................. 62
29.1 Project Status ..................................................................................................................... 62
29.1.1 Add project link ..................................................................................................... 63
29.1.2 Add members link .................................................................................................. 64
29.1.3 New request link .................................................................................................... 64
29.2 Resource allocation - Planning ............................................................................................ 65
29.2.1 Create new request ............................................................................................... 65
29.2.2 Change planning..................................................................................................... 66
29.2.3 Deny request .......................................................................................................... 66
29.3 Resource allocation charts................................................................................................. 67

Document: Redmine User guide.doc Page 6 of 69


Confidential – For internal circulation only
Redmine User guide

1. Introduction
Redmine is a flexible project management web application. Written using the Ruby on Rails
framework, it is cross-platform and cross-database.

Some of the main features of Redmine are:

Multiple projects support


Flexible role based access control

Flexible activity tracking system

Gantt chart and calendar

News, documents & files management

Feeds & email notifications

Per project wiki

Per project forums

Time tracking

Custom fields for activities , time-entries, projects and users

SCM integration (SVN, CVS, Git, Mercurial, Bazaar and Darcs)

Activity creation via email

Multiple LDAP authentication support

User self-registration support

Multilanguage support

Multiple databases support

2. Accounts

Document: Redmine User guide.doc Page 7 of 69


Confidential – For internal circulation only
Redmine User guide

2.1 My Account

This screen lets you edit your account settings: lastname, firstname, email address, language.

2.1.1 Mail notifications

If Mail notifications is checked, you will receive notifications about any event that occurs on the
projects you belong to (activity added or edited, new document,...).

If it's unchecked, you will only receive notifications about the activities you're involved in (author or
assignee) and about things you watch (eg. activities , forums).

2.1.2 Password

To change your password, type your old password and your new password twice. Password length
must be between 4 and 12 characters.

If your account uses an external authentication mean (LDAP), you can't change your password in
Redmine.

2.1 My page
This page lets you display various blocks of information about your projects. By default only the
following two blocks are enabled:
Activities assigned to me
o providing a cross-project list of activities , which are assigned to the current user,
showing the activity id's, projects, activity types and subjects with the current activity
status appended between braces

Reported activities

o providing a cross-project list of activities , which are reported by the current user,
showing the activity id's, projects, activity types and subjects with the current activity
status appended between braces

Document: Redmine User guide.doc Page 8 of 69


Confidential – For internal circulation only
Redmine User guide

Each user can personalize the own "My page" by clicking on "Personalize this page". Then the user can
choose which of the available blocks of information should be displayed or not.
The additional blocks besides the two default ones are:
Calendar
o providing a cross-project weekly calendar overview

Documents

o providing a cross-project overview of the latest documents

Latest news

o providing a cross-project overview of the latest news

Spent time

o providing a cross-project overview of the spent time entries of the current user of the
last seven days

Watched activities

o providing a cross-project list of activities , which are watched by the current user,
showing the activity id's, projects, activity types and subjects with the current activity
status appended between braces

The layout (as in positioning of the blocks) of the "My page" can also be re-ordered and modified using
drag-and-drop.

2.3 Password lost

If you forget your password, a procedure lets you to choose a new one.

Document: Redmine User guide.doc Page 9 of 69


Confidential – For internal circulation only
Redmine User guide

On the login screen, click on Lost password. Enter your email address and submit the form. An email
is then sent to you. It contains a link that allows you to change your password.

Note that this functionality can be disabled by the administrator. Also, if your account uses an external
authentication mean (LDAP), this procedure isn't be available.

2.4 Register

By registering, you can get an account without the intervention of the administrator.

On the login screen, click on Register. Fill the form and submit it. An email will be sent to you.
To activate your account, use the link that is contained in this email.

Note that this functionality can be disabled by the administrator.

3. Login
The Sign in page is used to login into the project where you have been activated for. The Lost
password link is only displayed if the administrator has activated it.

Document: Redmine User guide.doc Page 10 of 69


Confidential – For internal circulation only
Redmine User guide

4. Register
The Register page is used to register a new user. A new user has to give the information about
his Login, Password, Firstname, Lastname and Email address and which language the user would
like to use to for the user interface.

4.1 Registration Process

Based on the
Redmine settings, the user will have to either activate his account by email, wait
for an administrator to validate his account or see his account automatically activated.

4.1.1 Account Activation by Email

After providing the information required on the Registration page, the user will receive an email to the
email provided on the Registration page. By clicking on the activation link provided in the email, the
user enables himself his account.

Document: Redmine User guide.doc Page 11 of 69


Confidential – For internal circulation only
Redmine User guide

Such method is often used to prevent email spamming.

4.1.2 Manual Account Activation

After providing the information required on the Registration page, the user must wait for the approval
of an administrator. The administrator, by login to the Administration panel, will enable the user
account. When the user account is enabled, the user is allowed to login.

4.1.3 Automatic Account Activation

After providing the information required on the Registration page, the user is allowed to login at any
moment, no further steps are required.

5. RedmineSearch
A part of any project management process is spent looking for existing information. Enter the Redmine
search capability..

Document: Redmine User guide.doc Page 12 of 69


Confidential – For internal circulation only
Redmine User guide

5.1 Search box

At the top right-hand side of Redmine is a simple search box. Type anything and press enter to search.

Searching for #{ActivityID} or {ActivityID} will go straight to the activity. Search parameters can be
enclosed in double quotation marks.

Depending on permission settings and project membership a drop down menu option may show the
current project. Simple search searches full text on the project currently displayed in that chooser.

Clicking on the word Search will immediately take you to the advanced search and results page.
Notice the project chooser has followed, and there are checkboxes to limit search to specific types of
entries. The checkboxes displayed only if the module is enabled at that project level.

5.2 Search configuration


5.2.1 Search titles only

From the advanced search box, Search titles only can be enabled to limit results.

5.2.2 Search custom fields

Don't forget to set custom fields checkbox Searchable to true to also search these fields.

5.3 Results

Here is a sample results page from this site on "test activity".

Many links to go to what was found.


Unique text highlighting by search terms.

Document: Redmine User guide.doc Page 13 of 69


Confidential – For internal circulation only
Redmine User guide

Capability to jump to groupings of results (ie News items).

Leading icons to categorize type of result (ie changeset, activity, comment)

5.4 Search controller

Always check the source first:

source:/trunk/app/controllers/search_controller.rb

A more advanced look at the controller explains some of the above behavior:

Only searches the first 5 tokens of a search


Tokens must be at least 2 characters long

Results are returned in paginated sets of 10

6. Project Overview
The Project overview will give you an overview of the whole project. On left upper side in the Activity
tracking area you will get an overview of how many task are open and closed for each activity
type specified for the project. In the Members area you can see who are the members of the given
project and in particular who is the administrator of the project. In the Latest news area you can see
which are the latest news for the particular project.

Document: Redmine User guide.doc Page 14 of 69


Confidential – For internal circulation only
Redmine User guide

On the upper right side you see Sign in and Register. The Sign in link allows those who have an
account for this project to login. The Register link allow unregistered users to register themselves,
allowing them to be part of any projects contained within this installation of Redmine.

Note that the Register link can be disabled by the administrator.

7. Project Activity
The Activity log page will give an historical log of at least all activities which had happen in the given
project.

This will include:


A new activity (feature, defect...) has been created.
The status of the activity has been changed.

The given activity has been closed.

A note to the activity has been added.

This means a changeset has been commited to the repository.

A news has been added to the news area.

A message in the forum area has been added.

A reply to a message in the forum has been added.

A wiki page has been edited or newly created.

A new file has been added in the files area or to a document.

Document: Redmine User guide.doc Page 15 of 69


Confidential – For internal circulation only
Redmine User guide

A new document has been added.

Some hours has been logged.

A new project has been added.

Using the checkboxes in the sidebar of the right, you can choose which items are displayed.

The activity is also available as an Atom feed.

A cross-project activity view is available from the Projects page, it will lists the activity of all visible
projects.

8. Activity Tracking
Issues are the heart of the Redmine business. An activity is bound to a project, owned by a user, can
be related to a version, etc.

8.1 Listing of the activity

From a selected activity page, you can see the work in progress that is done to fix the activity. The
messages are displayed in chronological order, starting from the oldest to the newest message. It is
possible to quote others' messages as well as to edit yours.

8.1.1 Related activities

Document: Redmine User guide.doc Page 16 of 69


Confidential – For internal circulation only
Redmine User guide

Related activities allow developers to link activities to each other in order to remove duplicates or
simplify their workflow.

It is possible to link activities based on various relations. Current relations are:

related to - Just adds a link to the other activity

duplicates - Links activities so that closing one, will close the other (e.g. closing A will close
B)
For example, if activity B duplicates A:
- closing B will leave A open
- closing A will automatically close B

duplicated by - Reciprocal of duplicates


For example, if activity A is duplicated by activity B:
- closing B will leave A open
- closing A will automatically close B

blocks - Links activities so that closing one can be blocked by an activity which is still open
If activity B blocks A,
A can't be closed unless B is.

blocked by - Reciprocal of blocks

precedes - Links activities to define an "order", where A needs to be completed x days


before B can be started on
If B follows A, you can't give B
a starting date equal or less
than the ending date of A.

follows - Reciprocal of precedes


If activity B follows A (ex A ends the 21/04 and B begins the 22/04)
and you add +2 day at the ending date of A,
the starting and ending dates of B will be +2 too.

Administrators can define the permissions of users to add and edit such relations.

8.1.2 Watchers

Display a list of all the users who are watching this activity. If the activity is updated, those users will
be notified.

If you are logged in as a project administrator, it is possible for you to add users to the watch list on
this page. By clicking on the Add link, a drop-down menu with a Add button appear, which allows you
to select which user to add to the watch list.

Document: Redmine User guide.doc Page 17 of 69


Confidential – For internal circulation only
Redmine User guide

Administrators can define the permissions of users to add/delete watchers as well as to see the list of
watchers.

8.1.3 Associated revisions

If the administrator has defined Referencing Activites Keywords, a developer that uses such
keyword(s) will see its commit message displayed on the activity page, under the Associated revisions
block (generally to the right of the first reply).

Revisions can also be associated to activities manually, from a changeset (revision) view in the
Repository browser. The manual associations are reversible. They can be revoked by using the broken
chain icon to the right of an added association, again in the changeset view.

8.2 Adding a new activity

People can create a new activity when they meet the roles and permissions configured by the
Redmine Administrator (Role: Activity Tracking > Add Issues).
When creating a new activity, one of the most important items is the activity type field, which defines

Document: Redmine User guide.doc Page 18 of 69


Confidential – For internal circulation only
Redmine User guide

the nature of the activity. By default, Redmine comes with three different activity types: bug, feature,
and support.

8.3 Updating an existing activity

To edit the activity, Click Update link (having a pencil icon) at the top or the bottom of the activity
page:

Depending you your role permissions (see roles and permissions), you will see a complete or a
limited set of editable activity properties.

8.4 Editing an existing activity's Subject or Description

In order to edit an existing activity, your role has to have the Activity Tracking > Edit Issues right in
the the roles and permissions configuration.
This right gives you a (More) link after the Change Properties section title in the "Update activity"
panel.

1. Open the activity


2. Click Update link (having a pen icon) at the top or the bottom of the activity page.

3. See Change properties dialog with the (More) link (see a screenshot below).
4. Clicking on the (More) link will bring-up an editable copy of the Subject and Description of the
activity.

For version 2.0 onwards, the (More) link does not exist anymore. Instead the subject line is editable
by default. The description of the activity has pencil icon right next to it that you can click to change
the description.

Document: Redmine User guide.doc Page 19 of 69


Confidential – For internal circulation only
Redmine User guide

8.5 Subtasks

You can update an activity and access the "More"-link to (re)set the "Parent task" field. This can be
used to "convert" a normal activity into a subtask, move a subtask from one parent to another, or
convert a subtask to a normal activity.

9. The activity list


9.1 Overview

The activity list provides a way to look at the opened activities for a project.

Document: Redmine User guide.doc Page 20 of 69


Confidential – For internal circulation only
Redmine User guide

9.2 Applying and saving filters

The activity list displays open activities by default.


Standard and custom fields can be used to build a custom query. Once the filters are set, click on
to refresh the activity list. Click on to clear the filters.

It is possible to select multiple values at once for a specified field by pressing the button. This will
convert the drop-down menu in a selection list. In order to add to the selection list, use the ctrl key on
your keyboard.

9.2.1Custom queries

Custom queries can be saved by clicking on .


A form lets you give it a name and select the columns that you want to be displayed on the activity list
for this query (both standard and custom fields can be displayed). Checking the public attribute will
make the query visible to everyone, otherwise only you will see the query.

Document: Redmine User guide.doc Page 21 of 69


Confidential – For internal circulation only
Redmine User guide

Once saved, the query is listed in the sidebar.

9.3 Bulk editing activities

From the activity list, you can bulk edit/move/delete activities by selecting multiple activities and
then right-click on the selection.
Activity can be selected either by using the checkboxes or by clicking on the rows with Control or Shift
key pressed.
You can also use the little tick at the upper-left corner of the list to select/unselect all the activities .

9.4 Sidebar

Document: Redmine User guide.doc Page 22 of 69


Confidential – For internal circulation only
Redmine User guide

The contextual sidebar on the right of the activity list provides links to several different things:

a quick link to the default activity list without any other filters applied (thus only open
activities ), which is useful when you are looking at a custom query and want to get back to
the default activity list
a link to the activity summary, which is a report of all the activities at a project-level (in
contrast to the version overview which provides an overview at version-level)

a link to the change log, which provides a project-level overview of all closed and targeted
activities , sorted per target-versions

links to several levels of custom queries:

o global (cross-project) queries

 public queries

 private queries

o current-project's queries

 public queries

 private queries

depending on the project settings it also shows a planning section with links to:

o the calendar

o the gantt chart

10. The Change log


10.1 Overview

Document: Redmine User guide.doc Page 23 of 69


Confidential – For internal circulation only
Redmine User guide

Redmine provides a change log, which provides a project-level overview of all closed activities , sorted
per target version.

Considering the fact that this is an overview of what has changed in the specified target-versions, only
closed activities which have the target-version field filled are shown in this overview.

10.2 Sidebar

The contextual sidebar on the right of the change log provides several things:

checkboxes and an apply-button to include/exclude activities from specific activity types on


the changelog (which activity types are shown here with checkboxes depends on the
individual activity type-configuration)
links to the configured target-versions of the project, where each link links to the change log
itself starting with the selected target-version

11. Activity summary


Document: Redmine User guide.doc Page 24 of 69
Confidential – For internal circulation only
Redmine User guide

11.1 Overview
The activity summary provides a report of the amount of all the activities at a project-level (in
contrast to the version overview which provides an overview at version-level). This report is split-up in
different blocks where each block shows the amount of open/closed/total activities per:

Activity type
Priority

User to which the activity is assigned to

User who opened the activity (the author)

Version

Category

11.2 Drill-through links

Each activity type, priority, assigned user, author, version and category links to the activity list which
has the selected item as the current filter.
Also the numbers of activities in the reports provides drill-through links to their respective views in
the activity list.

11.3 Detailed reports

Each report-block can be selected to get a detailed report from it. This not only shows the amount of
open/closed/total activities but also provides details for all the other configured activity statuses. The
screenshot below shows the detailed report for the versions.

Document: Redmine User guide.doc Page 25 of 69


Confidential – For internal circulation only
Redmine User guide

12. Roadmap
The roadmap provides a highly-configurable, version-based view on the activity tracking system that
helps planning and managing the development of a project. It also provides an in-depth (version-
based) overview of the current state of your project.

Note: the roadmap menu-item shows up in the project-menu only when the activity tracking module is
enabled for the project and at least one version is configured in the projects settings.

12.1 Overview

If you select the Roadmap you will get an overview of the current state of your project, like the
following:

The above mentioned view contains the following "blocks" of information for all (incomplete) versions:

the version name


the date the version is scheduled to be complete

Document: Redmine User guide.doc Page 26 of 69


Confidential – For internal circulation only
Redmine User guide

a progress bar which indicates overall active/done/closed-ratio based on the %-done,


estimated time and statuses of the activities targeted to the corresponding version, visualized
by different color gradients

if configured: the content of the wiki-page that has been configured to be attached to the
version (see below)

if configured: a list of all the activities assigned to the specific version (see below)

The mentioned progress bar includes drill-down links to the activity-list which preloads the specific
filters thus providing quick links to open/closed activities targeted to a corresponding version. Simply
click on the number left to open to see all open activities in the activity-list. If you like to know which
activities are already solved/closed simply click on the number left to closed.

If you click on the version itself (0.8 right from the -icon), you can get a detailed view of the
current, overall state of a specific version. This is the version-view.

12.2 Managing the Roadmap

If you have the appropriate permissions you can change the Roadmap-view in two ways:

1. You can attach a wikipage to the version (see RedmineProjectSettings) which can be used for
describing main objectives of the version etc.
2. You can select the activity types of which individual activities , which are targeted to the
corresponding version, are listed in a way that you will see an area with all related activities
directly under the version. This behaviour can be changed as an administrator in the area of
the activity types.

12.3 Sidebar
The contextual sidebar on the right of the roadmap provides several things:

a checkbox to include completed target-versions on the roadmap


checkboxes and an apply-button to include/exclude activities from specific activity types on
the roadmap (which activity types are shown here with checkboxes depends on the
individual activity type-configuration)

links to the configured target-versions of the project where each links to the roadmap itself
starting with the selected target-version

13. Version overview


The version overview provides a detailed view of the current, overall state of a specific version. This
includes:

a list of all the activities assigned to the specific version, including a progress bar which
indicates overall active/done/closed-ratio based on the %-done and statuses of the activities ,
visualized by different color-gradients
the content of the wiki-page that has been configured to be attached to the version

a block which shows the time-tracking totals of all estimated- and spent-time on the activities
assigned to the version

Document: Redmine User guide.doc Page 27 of 69


Confidential – For internal circulation only
Redmine User guide

a block which shows the activity-statistics using the same active/done/closed-ratio progress
bar grouped by:

o Assigned To Users

o Authors

o Categories

o Priorities

o Activity types

Both the "grouped by criteria" and the statistics itself (the number of activities ) provides drill-down
links to the activity-list which preloads the specific filters thus providing quick links to activities of a
specific author, category, etc.

The version-view can be reached from the roadmap by clicking on a specific version.

14. Time tracking


14.1 Introduction

Time tracking allows users to track how many hours of work are logged to a specific activity or
project. Each time entry of "spent time" can be categorized by activity, and further explained with
comments. By filling time estimates, project managers are able to produce better suited project
planning as well as follow individual users progress.

Time tracking is always related to a user, thus it can be used to track how many billable hours this
user has accomplished. See the spent-time details or spent-time report pages for more information.

14.2 Installing/Configuration

Document: Redmine User guide.doc Page 28 of 69


Confidential – For internal circulation only
Redmine User guide

Time tracking is a standard module of Redmine and can be enabled/disabled for each project in
the Modules section of the new project form, or the Settings tab of an existing project.

14.3 Logging time on an activity

You can log time on an activity by clicking Log time from the activity details view.

You can also log time when updating an activity.

14.4 Logging time at project level

You can log hours at project level by leaving the activity field empty.

14.5 Accepted time formats


Estimated and spent hours can be entered using the following formats:

Hours and minutes using standard time format: 1h, 1 h, 1 hour, 2


hours, 30m, 30min, 1h30, 1h30m, 1:30
Hours and minutes using decimal time format: 1.5, 1,5 (equals to 1h30)

14.5.1 Decimal time format

When entering estimated- and spent-time values in Redmine using decimal time format you have to
be aware of the following situation:

Example: you have 4 activities with the following spent time values: 1.00, 0.10, 0.15, & 0.40.
Now in the Spent-Time reports (Project overview -> Spent time -> [Details | Report]) you see
a total of 1.65 hours instead of 2.05 hours...???

Document: Redmine User guide.doc Page 29 of 69


Confidential – For internal circulation only
Redmine User guide

Explanation: this "behaviour" is normal and intended since you enter those four spent-time
values using decimal time format. This means that:

o 1.00 decimal equals 60 minutes (1 hour)

o 0.10 decimal equals 6 minutes

o 0.15 decimal equals 9 minutes

o 0.40 decimal equals 24 minutes

o 1.65 decimal equals 99 minutes

o 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation

Of course there can possibly be a very tiny difference (as you can see) due to the rounding to two
decimals done by Redmine.

14.6 Logging time via commit messages

With the Enable time logging option turned on (see Application settings -> Repositories),
developers can log time against an activity via their commit messages using the following syntax
(hours must be preceded with an activity id):

Fixed something, #435 @1h30

This commit message will log 1h30 on activity #435.

If you encounter a problem with this, ensure that under Application settings -> Repositories, make
sure that Activity for logged time is set to something other than 'Default' and use a format similar
to the below in your commit message.

refs #435 @1h30

15. Redmine Timelog Details


15.1 Introduction

After building a set of time entries through Redmine the Timelog Details page can help show running
totals of time against a project.

15.2 Searching

Shares the same search interface as RedmineTimelogReport

Document: Redmine User guide.doc Page 30 of 69


Confidential – For internal circulation only
Redmine User guide

15.3 Results

By default the detail time log shows all time entries in the system.

From top to bottom in the image

Total time result of the search


pagination table of time entries

o sortable columns

Atom and CSV format available

Notice the bottom line has no activity, it was logged against the project.

Links work the same as the rest of the wiki; closed activities have strike through applied to them.

15.3.1 HTML output

15.3.2CSV output

A sample CSV output of the above time entries (and attached):

Document: Redmine User guide.doc Page 31 of 69


Confidential – For internal circulation only
Redmine User guide

Activit Activit Subjec Commen


Date User Activity Project Hours
y y type t t

Bug
make sure
Test Report
09/24/201 Developer 0.33333 the
Develope Testing 10 Bug from
0 s 3 changes
r Test
work
user

Bug
Test Report Doing the
09/23/201 Developer
Develope Development 10 Bug from 1.0 actual
0 s
r Test coding
user

Test showing a
09/23/201 Implementatio Developer Build a
Develope 11 Feature 2.0 closed
0 n s bridge
r activity

Bug what are


Test Report the
09/22/201 Developer 0.33333
Develope Research 10 Bug from problems
0 s 3
r Test with this
user bug

Bug
Test Report Designing
09/22/201 Developer
Develope Design 10 Bug from 1.0 an elegant
0 s
r Test solution
user

Create
Test this
09/21/201 Developer
Develope Support 1.0 project
0 s
r and demo
activity

16. Redmine Timelog Report


16.1 Introduction

Time entries can be viewed at a detailed level, but sometimes a report format is desired.

Document: Redmine User guide.doc Page 32 of 69


Confidential – For internal circulation only
Redmine User guide

Timelog Report allows users to display their time grouped by categories.

16.2 Searching

Shares the same search interface with RedmineTimelogDetails.

16.3 Results
16.3.1 HTML output

Using the drop down choosers this result set is based on the detailed time entries found
at RedmineTimelogDetails.

For this example Days is set for the Details parameter.

Add groupings to show the report; until anything is added this area will be blank. For this example
first Activity was selected, then Activity. The list will always go back to blank after a selection. The
drop down will disable once the maximum number of combinations are added, use the clear button to
start over.

16.3.2 CSV output

Activity Activity Total


2010- 2010- 2010- 2010- 2010-

Document: Redmine User guide.doc Page 33 of 69


Confidential – For internal circulation only
Redmine User guide

09-20 09-21 09-22 09-23 09-24

none 1.00 1.00

Support 1.00 1.00

Bug #10: Bug Report


1.33 1.00 0.33 2.67
from Test user

Design 1.00 1.00

Development 1.00 1.00

Research 0.33 0.33

Testing 0.33 0.33

Feature #11: Build a


2.00 2.00
bridge

Implementation 2.00 2.00

Total 1.00 1.33 3.00 0.33 5.67

17. Gantt chart


The gantt chart displays activities that have a start date and a due date or are assigned to a version
with a date.

Document: Redmine User guide.doc Page 34 of 69


Confidential – For internal circulation only
Redmine User guide

18. Calendar
18.1 Overview

The calendar provides an overview of the current project as a monthly view. This view displays all the
activities that have at least a start date and indicates their start date and (if available) their due date.
The calendar also displays all versions which have a due date set.

18.2 Access control


18.2.1 Module activation

The calendar module can be enabled or disabled per project via the project's configuration tab. Within
the configuration page go to the Modules tab and check or uncheck the Calendar checkbox to activate
or disable the module.

18.2.2 Roles and permissions

Access to the module can be granted or denied at a role level.


To do this go to the administration page, follow the roles and permissions link, choose a role and
check or uncheck the Calendar permissions checkbox.

18.3 Filters

Like on the activity-lists and the Gantt chart, it is possible to define filters to define a subset of
activities to be shown on the calendar. Such filters are similar to those specified on any activity-list.

Document: Redmine User guide.doc Page 35 of 69


Confidential – For internal circulation only
Redmine User guide

19. News
In the news area you can publish news items about the project or any subject you like.

You can give the news item a title, a summary and the detailed description. The summary will be
displayed in the Latest news area of the project overview whereas the description will be displayed if
you click on the title of the news item.

Document: Redmine User guide.doc Page 36 of 69


Confidential – For internal circulation only
Redmine User guide

If you have the permissions to create news items, then you can add/edit/delete an existing news entry
(see Redmine Permissions).

If you have the permission to create new news items, you have a green plus sign (+ Add news) in
the upper right of you screen. If you click on that, you can add a new news item. On this page, you
have to insert the Title, Summary and Description of the news item.

20. Redmine Documents


20.1 Introduction

Documents is an available module to projects in Redmine.

20.2 Adding Documents

From the Documents tab press the New document link.

Document: Redmine User guide.doc Page 37 of 69


Confidential – For internal circulation only
Redmine User guide

By default there are two categories for documentation:

1. User documentation
2. Technical documentation

These categories can be modified and other categories can be added by a Redmine administrator
using document category enumerations.

20.3 Viewing Documents

Once documents have been uploaded, the title is used as the link to download the attached
documents, and add more if necessary.

Document: Redmine User guide.doc Page 38 of 69


Confidential – For internal circulation only
Redmine User guide

21. Redmine Files


21.1 Files Module

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

A sortable table shows the details of all the uploaded files. If a version if selected while uploading the
file the file is shown below the version. Of note are the MD5 hash and D/L(Download Count).

New files are added via the New File button in the upper right hand corner.

21.2 File storage


Document: Redmine User guide.doc Page 39 of 69
Confidential – For internal circulation only
Redmine User guide

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

The uploaded file name is prefixed with a unique id based on it's parent for directory storage.

21.3 New file form¶

If a new file is added, the input form is as shown below. Select a version from the list to link a file to a
specific version. Adding multiple files at once is possible using the "Add another file" link.

The optional description is used for an alt text.

22. Forums
The forums allow users from a project to communicate with each others. The administrator defines a
list of forums in the Project Settings.

The forum list displays the project forums overview:

total number of topics


total number of messages

a link to the latest message

22.1 Adding a topic

To add a topic in a given forum, click on the forum name, then click on New message.

You can now enter a subject, a body and attach files to your message.
Two options are available:

sticky: if checked, the topic will stay displayed at the top of topic list, in bold
locked: if checked, users can not add replies to the message

23. Wikis

Document: Redmine User guide.doc Page 40 of 69


Confidential – For internal circulation only
Redmine User guide

23.1 Creating a new wiki page

As in every wiki, just add a link to the page you want to create.

[[MyNewWikiPage]]

Save the page and click on that link: you have created a new wiki page with "MyNewWikiPage" as its
name.

23.2 Creating an additional wiki side bar

The content of the wiki page named 'Sidebar' is rendered in the wiki sidebar if it exists. Permission to
protect wiki pages is required to create this page.

23.3 Creating sub-pages (parent/child relationships)


It is possible to create parent/child relationships between wiki-pages. This has two benefits:

On the "Index by title", the page tree in sorted according to the relationhips:

Guide

o RedmineAccounts

o RedmineCustomFields

o RedmineInstall

o RedmineIssueList

o RedmineIssues

On each child page a breadcrumb is displayed showing the location of the page within the
page tree:
TODO, add image

These relations can be set by assigning a parent page to a to-be child-page. This assignment can be
done via the rename dialog only.
Thus, create both the child- and parent-pages and then open the to-be child-page and click "rename",
then select the name of the parent page and click "save".

23.4 Protecting a wiki page

If you have the permission to protect wiki pages, you can click on Lock.

A locked wiki page can only be edited by users who have the permission to protect wiki pages.
It can be unlocked by those users by clicking Unlock.

23.5 Wiki page history

Document: Redmine User guide.doc Page 41 of 69


Confidential – For internal circulation only
Redmine User guide

Redmine keeps a record of every change made to a wiki page. You can view the list of these changes
by clicking on History.

To view a specific version of the page click on its number.

What is displayed can be misleading: Version 31/41 (diff) means that you are viewing version
31 out of 41, it does not mean that the diff link will show you the differences between 31 and 41. It
does show you the differences between version 30 and 31. If you're looking at version 30, you'll see
Version 30/41, and the diff will show you the changes in version 30.

If you want to see differences between 40 and 41, go to the revisions list and click 'View changes' (by
default, it will show the diff of the last version).

You can revert a page to a previous version by clicking on Rollback to this version, then Save.
In that case a new page version is created without losing the wiki page history.

If you instead do want to delete all history of a wiki page you have to copy the content of that page to
a save place (copy/paste in edit window), delete the page and re-create it with the same name. Then
re-insert the copied content.

23.6 Sidebar
The contextual sidebar on the right of any wiki page provides links to:

Start page: Link to the configured start page of the wiki


Index by title: Index of all the wiki pages sorted by name (and, if configured, by parent/child
relationships)

Document: Redmine User guide.doc Page 42 of 69


Confidential – For internal circulation only
Redmine User guide

Index by date: Index of all the wiki pages sorted by date of last modification

Repository: The Repository tab lets you browse the project repository and view the latest
commits.

You can expand a directory by clicking on .


You can also enter a directory by clicking on its name.

Clicking a revision number will display the details of the commit.

To browse the repository at a given revision, enter the revision number in the upper-right field
and hit Enter.

24. Repository Statistics

Document: Redmine User guide.doc Page 43 of 69


Confidential – For internal circulation only
Redmine User guide

Redmine generates two SVG images representing the number of Changes and the number
of Revisions in the configured repository. One image shows a month to month break down
of Changes vs Revisions. The other image shows the number of Changes and Revisions made by
each commiter.

24.1 Definitions

Dae brow@@@

Revisions is a count of repository commits and is displayed in redish/orange.


Changes is a count of the number of files that have changed overall and is displayed in blue.

24.2 Notes

It is known that the SVG images won't render properly using certain browsers and when running
Redmine on certain Ruby distribution(s) (versions).

Document: Redmine User guide.doc Page 44 of 69


Confidential – For internal circulation only
Redmine User guide

25. Project Settings


25.1 Information

In this screen you can configure the basic (though important) settings for the selected project.

25.1.1 General settings


The following general settings are available:

Name: project display name (must be unique).

Subproject of: lets you define a parent project to the project being created. Projects can be
unlimitedly nested.

Description: description that appears on the project overview.

Identifier: used by the application for various things (eg. in URLs). It must be unique. Once
the project is created, this identifier cannot be modified.

Homepage: homepage-link that appears on the project overview.

Public: if checked, the project can be viewed by all the users, including those who are not
members of the project. If unchecked, only the project members have access to it, according
to their role.

Document: Redmine User guide.doc Page 45 of 69


Confidential – For internal circulation only
Redmine User guide

If there are any projects custom fields configured by the administrator, they'll show up behind the
"Public"-setting noted above.

25.1.2 Activity types

Redmine lets you define which of the configured activity types (thus also their
respective workflows) you are able to use within this specific project.

Activity types: select the activity types that you want to use for activities of the project.
Only the administrator can define new activity types.

25.1.3 Custom fields

Custom fields: select the activities custom fields that you want to use for activities of the
project. Only the administrator can define new custom fields.

Note that some of these custom fields can be only configured (e.g. unchecked) if the activity custom
field is not defined as a global activity custom field (which can be done by the administrator by
checking the "For all projects" checkbox in the custom field create/edit view).

25.2 Modules

This screen lets you choose the modules you want to use for the project.

Disabling a module doesn't delete the associated data. It only prevents users from accessing it. After a
module was disabled, it can be re-enabled with all its data.
You can for example disable 'Activity tracking' module for a single project. Existing activities are not
deleted. You will be able to access them if you re-enable the module.

25.2.1 Core modules

Activity tracking: provides Activity tracking feature, including activity categories, versions,
the Roadmap and version overviews
Time tracking: provides Time tracking feature

News: provides News feature

Documents: provides Documents feature

Files: provides Files feature

Wiki: provides Wiki feature

Repository: provides Repository feature

Boards: provides Forum feature

Calendar: provides Calendar feature

Gantt: provides Gantt feature

25.3 Members

Document: Redmine User guide.doc Page 46 of 69


Confidential – For internal circulation only
Redmine User guide

This screen lets you define project members and their roles. You can add a user or a group, with one
or multiple role(s) in a given project.

25.4 Versions

Projects versions allow you to track and plan changes. You can assign activities to versions and then
view the list of assigned activities for each version on the roadmap.
You can also assign a wikipage to a version which will be added to the roadmap and the version
overview.

Note: the roadmap menu-item shows up in the project-menu only when the activity tracking module is
enabled for the project and at least one version is configured in the projects settings.

The following properties are configurable for (each of the) versions:

Name: The text you want to be displayed to identify the version. This field is required.

Description: A short description to describe the version. This field is optional.

Status: the status lets you control how activities can be assigned to the version:

o open: no restriction (default)

o locked: can not assign new activities to the version

o closed: can not assign new activities and can not reopen assigned activities

Wiki Page: The name of a wikipage assigned to the version. This field is optional.

Date: The due date for the version to be completed. This field is optional.

Sharing: this option lets you share the version with other projects, so that activities from
these other projects can be assigned to the shared versions. Each version can be shared with:

o subprojects: all the descendant projects

o projects in the project hierarchy: ancestors + descendants (needs versions


management permission on the root project)

o projects in the project tree: root project + all its descendants (same as above)

o all projects (can be set by admin users only)

---------------------------------------------------------------------------------

| None | Subprojects | Hierarchy | Tree | All projects |

| | | | | |

| X X | X X | o X | o X | o o |

| | | | | | | | | | | | | | | |

Document: Redmine User guide.doc Page 47 of 69


Confidential – For internal circulation only
Redmine User guide

| --X-- X | --X-- X | --o-- X | --o-- X | --o-- o |

| / | \ | / | \ | / | \ | / | \ | / | \ |

| X V X | X V X | X V X | o V o | o V o |

| / \ | / \ | / \ | / \ | / \ |

| X X | o o | o o | o o | o o |

| / | / | / | / | / |

| X | o | o | o | o |

---------------------------------------------------------------------------------

V = project with the shared version

o = projects that can assign activities to the shared version

X = projects that can't assigne activities to the shared version

Sharing a version of a private project with public projects will make its name visible to everyone.

From the versions list, you can click on


Close completed versions to automatically set the status of
all the completed versions (due date reached and no open activities ) to closed.

25.5 Activity categories

Activity categories let you to organize activities . Categories can for example correspond to the
different components of your project.

You are able to configure your own set of activity categories for each individual project. It is also
possible to auto-assign new activities to a specific user based on the chosen category of the newly
created activities .

The following properties are configurable for (each of the) activity categories:

Name: The text you want to be displayed to identify the activity category. This field is
required.

Assigned to: The project member to who you want to auto-assign newly created activities in
this category. This field is optional.

25.6 Wiki

Each project can have its own wiki. Enable the module on the desired project to activate it.

Start page: This page is used as the start page for the wiki in both the project menu wiki link
as well as in the start page link in the wiki sidebar (default: 'Wiki'). This field is required.

Document: Redmine User guide.doc Page 48 of 69


Confidential – For internal circulation only
Redmine User guide

25.7 Repository

A SCM repository can be associated with each project. Once the repository is configured, you can
browse it and view the changesets. The changesets also appear in the Activity view.
See the following page for details about how to configure your repository in Redmine.

25.8 Forums
Each project can have one or more discussion forums. Each forum has the following properties:

Name: The text you want to be displayed to identify the discussion forum. This field is
required.

Description: A short description to describe the subject of the specific forum. This field is
required.

26. Redmine Attached Files


26.1 Introduction
Attached files can be added to different resources within the Redmine system:

activities - using the "New File" form while adding/editing an activity


documents - using the "New File" form while adding/editing a document

forum messages - using the "New File" form while adding/editing a forum message

wiki pages - using the "New File" link at the bottom of the page

26.2 Usage
26.2.1Inline Images

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

26.2.2 Non plain text files

Keep in mind there is a dedicated documents module for storing technical and user documentation
that can be linked via the wiki and a dedicated files module for publishing versions of the tracked
project, as a bundle (release).

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

26.3 File storage

Uploaded attached files are stored in <Redmine install dir>/files directory subdirectories
named after the year the file has been uploaded.

Document: Redmine User guide.doc Page 49 of 69


Confidential – For internal circulation only
Redmine User guide

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.

Unattached uploaded files

Uploaded files can be left unattached if the user doesn't submit the form; a Rake task is made
available and can be scheduled for regular deletion of these files.

26.4 Attach files form

The input form is as shown below.

Starting from version 2.3.0 and depending on the browser supporting it (IE10+), it is possible to:

select and attach multiple files at once


drag and drop files over the form

The optional description field, which appears once the file upload is finished, is also used as the
alternate text of the image file inserted using !image_url! syntax within the parent content (i.e.
activity description or note, forum message, wiki page, document, …).

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

27. Text formatting


27.1 Links
27.1.1 Redmine links

Redmine allows hyperlinking between resources (activities , changesets, wiki pages...) from anywhere
text formatting is used.

Link to an activity: #124 (displays #124, link is striked-through if the activity is closed)
Link to an activity note: #124-6, or #124!#note-6

Link to a changeset: r758 (displays r758)

Link to a changeset with a non-numeric hash: commit:c6f4d0fd (displays c6f4d0fd).

Wiki links:

[[Guide]] displays a link to the page named 'Guide': Guide


Document: Redmine User guide.doc Page 50 of 69
Confidential – For internal circulation only
Redmine User guide

[[Guide|User manual]] displays a link to the same page but with different text: User
manual

[[Guide#User-guide|User guide]] displays a link to the header on the same page with
different text: User guide

You can also link to pages of another project's wiki (using the project identifier):

[[sandbox:some page]] displays a link to the page named 'Some page' of the Sandbox wiki
[[sandbox:]] displays a link to the Sandbox wiki main page

Wiki links are displayed in red if the page doesn't exist yet, eg: Nonexistent page.

Links to others resources:

Documents:
o document#17 (link to document with id 17)

o document:Greetings (link to the document with title "Greetings")

o document:"Some document" (double quotes can be used when document title


contains spaces)

o sandbox:document:"Some document" (link to a document with title "Some


document" in project identifier "sandbox")

Versions:

o version#3 (link to version with id 3)

o version:1.0.0 (link to version named "1.0.0")

o version:"1.0 beta 2"

o sandbox:version:1.0.0 (link to version "1.0.0" in the project identifier "sandbox")

Attachments:

o attachment:file.zip (link to the attachment of the current object named file.zip)

o attachment:"file.zip" (double quotes can be used when the filename contains non
word characters)

o For now, attachments of the current object can be referenced only (if you're on an
activity, it's possible to reference attachments of this activity only)

Changesets:

o r758 (link to a changeset)

o commit:c6f4d0fd (link to a changeset with a non-numeric hash)

o svn1|r758 (link to a changeset of a specific repository, for projects with multiple


repositories)

Document: Redmine User guide.doc Page 51 of 69


Confidential – For internal circulation only
Redmine User guide

o commit:hg|c6f4d0fd (link to a changeset with a non-numeric hash of a specific


repository)

o sandbox:r758 (link to a changeset of another project)

o sandbox:commit:c6f4d0fd (link to a changeset with a non-numeric hash of another


project identifier)

Repository files:

o source:some/file -- Link to the file located at /some/file in the project's repository

o source:some/file@52 -- Link to the file's revision 52

o source:some/file#L120 -- Link to line 120 of the file

o source:some/file@52#L120 -- Link to line 120 of the file's revision 52

o source:"some file@52#L120" -- Double quotes can be used when the URL contains
spaces

o source:repo_identifier|some/file -- Link to a file in a repository other than the


project default repository.

o source:"repo_identifier|some file" -- Link to a file in a repository other than the


project default repository, with spaces in the path.

o export:some/file -- Force the download of the file

Forum messages:

o message#1218 (link to message with id 1218)

Projects:

o project#<id> (link to project with id, eg. project#3 link to project with id 3)

o project:<name> (link to project with name, eg. project:someproject link to


project identifier "project")

Escaping:

You can prevent Redmine links from being parsed by preceding them with an exclamation
mark: !

27.1.2 External links


HTTP URLs are automatically turned into clickable links:

http://www.redmine.org -- External link to the redmine website: http://www.redmine.org


someone@foo.bar -- Link to an email address: someone@foo.bar

HTTP URLs can also use different text than the link itself:
"Redmine web site":http://www.redmine.org -- External link with different
text: Redmine web site

Document: Redmine User guide.doc Page 52 of 69


Confidential – For internal circulation only
Redmine User guide

27.1.3 Email addresses

Email addresses are automatically turned into clickable links:

"Email someone":mailto:someone@foo.bar -- Email link with different text: Email


someone

More complex email instructions can be added to an email link. A default subject, default body and CC
information can be defined. Note that spaces in any of these fields need to be replaced with the code
%20.
"Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar --
Email to webmaster, CC admin: Email webmaster and admin
"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help --
Email link with the subject "Website Help": Email someone for help

"Email someone for


help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%
20is%20 -- Email link with the subject "Website Help" and a default body: Email someone for
help

27.2 Text formatting

For things such as headlines, bold, tables, lists, Redmine supports Textile syntax.
See http://redcloth.org/hobix.com/textile/ for information on using any of these features. A few
samples are included below, but the engine is capable of much more of that.

27.2.1 Acronym

JPL(Jean-Philippe Lang)

Display:

JPL

27.2.2 Font style

* *bold*

* _italic_

* *_bold italic_*

* +underline+

* -strike-through-

* Plain ^superscript^

* Plain ~subscript~

Document: Redmine User guide.doc Page 53 of 69


Confidential – For internal circulation only
Redmine User guide

* @inline monospace@

Display:

bold
italic

bold italic

underline

superscript
Plain

Plain subscript

inline monospace

27.2.3 Inline images

!image_url! displays an image located at image_url (textile syntax)


!>image_url! right floating image

!image_url(Image title)! displays an image with an alt/title attribute

!image_url!:URL displays an image located at image_url with link URL added

If you have an image attached to your wiki page, it can be displayed inline using its
filename: !attached_image.png!

You can also apply a CSS style to the image in the same ways as styling SPANs. The code !{width:
100%}attached_image.png! will make the image adjusts to the parent's width.

27.2.4 Headings

h1. Heading

h2. Subheading

h3. Subheading

Redmine assigns an anchor to each of those headings thus you can link to them with "#Heading",
"#Subheading" and so forth.

27.2.5 Paragraphs

p. left aligned

Document: Redmine User guide.doc Page 54 of 69


Confidential – For internal circulation only
Redmine User guide

p(. left ident 1em

p((. left ident 2em

as well as for following lines

p>. right aligned

p)))>. right ident 3em

p=. This is centered paragraph.

27.2.6 Horizontal rule

----
Display:

27.2.7 Predefined

To escape wiki syntax

<pre> *Your text won't become bold* </pre>

Display:

*Your text won't become bold*

27.2.8 Blockquotes

Start the paragraph with bq.:

bq. Rails is a full-stack framework for developing database-backed web


applications according to the Model-View-Control pattern.

To go live, all you need to add is a database and a web server.

Displays:
Document: Redmine User guide.doc Page 55 of 69
Confidential – For internal circulation only
Redmine User guide

Rails is a full-stack framework for developing database-backed web applications according to the
Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

You can also use > at the beginning of each line and stack them for nested quotes:

>> Rails is a full-stack framework for developing database-backed web applications


according to the Model-View-Control pattern.

>> To go live, all you need to add is a database and a web server.

> Great!

Displays:

Rails is a full-stack framework for developing database-backed web applications according to the
Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

Great!

27.2.9 Unordered lists

* Item 1

* Item 2

** Item 21

** Item 22

* Item 3

displays:

Item 1
Item 2

o Item 21

o Item 22

Item 3

27.2.10 Ordered lists

# Item 1

# Item 2

# Item 3

## Item 3.1

Document: Redmine User guide.doc Page 56 of 69


Confidential – For internal circulation only
Redmine User guide

## Item 3.2

displays:

1. Item 1
2. Item 2

3. Item 3

1. Item 3.1

2. Item 3.2

27.2.11 Tables

|_.UserID |_.Name |_.Group |_. attribute list |

|Starting with | a | simple |row |

|\3=.IT |<. align left |

|1 |Artur Pirozhkov |/2.Users |>. align right |

|2 |Vasya Rogov |=. center |

|3 |John Smith |Admin

(root) |^. valign top |

|4 |- |Nobody

(anonymous) |~. valign bottom |

displays (all multiple spaces are replaced by 1 space):

UserID Name Group attribute list

Starting with a simple row

IT align left

1 Artur Pirozhkov Users align right

2 Vasya Rogov center

Admin valign top


3 John Smith
(root)

Document: Redmine User guide.doc Page 57 of 69


Confidential – For internal circulation only
Redmine User guide

Nobody
4 -
(anonymous) valign bottom

If you want to include pipe characters inside your table (e.g. for Wiki links), you need to prevent
textile from interpreting them:

Input Output

<notextile>|</notextile> |

27.2.11.1 Table of content

{{toc}} => left aligned toc

{{>toc}} => right aligned toc

Please keep in mind, that the toc-tag needs an empty line above and underneath it and no other text
before and after it.

Example:

h1. headLineOne

h2. something

{{toc}}

h2. something more

27.3 Macros

Redmine includes a macros system that lets you add custom functions to insert dynamic content in
formatted text. You can learn about writing your own macros in RedmineMacros. Redmine also
includes a few built-in macros:

hello_world

Sample macro.

macro_list

Document: Redmine User guide.doc Page 58 of 69


Confidential – For internal circulation only
Redmine User guide

Displays a list of all available macros, including description if available.

child_pages

Displays a list of child pages. With no argument, it displays the child pages of the current wiki
page. Examples:

!{{child_pages}} -- can be used from a wiki page only

!{{child_pages(depth=2)}} -- display 2 levels nesting only

include

Include a wiki page. Example:

!{{include(Foo)}}

or to include a page of a specific project wiki:

!{{include(projectname:Foo)}}

collapse

Inserts of collapsed block of text. Example:

{{collapse(View details...)

This is a block of text that is collapsed by default.

It can be expanded by clicking a link.

}}

thumbnail

Displays a clickable thumbnail of an attached image. Examples:

{{thumbnail(image.png)}}

{{thumbnail(image.png, size=300, title=Thumbnail)}}

sample_macro

Sample macro

27.4 Code highlighting

Code highlighting relies on CodeRay, a fast syntax highlighting library written completely in Ruby. It
currently supports C, C++, CSS, Delphi, Diff, Groovy, HTML, Java, Javascript, JSON, Nitro-XHTML, PHP,
Python, RHTML, Ruby, Scheme, SQL, XML and YAML code.

Document: Redmine User guide.doc Page 59 of 69


Confidential – For internal circulation only
Redmine User guide

You can highlight code in your wiki page using this syntax:

<pre><code class="ruby">

Place your code here.

</code></pre>

Example:

# The Greeter class

class Greeter

def initialize(name)

@name = name.capitalize

end

def salute

puts "Hello #{@name}!"

end

end

28. Resource Utilization Factor

To use the resource utilization factor go to view all activities from in the projects page as shown in
diag.

Document: Redmine User guide.doc Page 60 of 69


Confidential – For internal circulation only
Redmine User guide

After opening the view all activities


Go to the “Add filter” and select the “Assignee” and then select the desired user from the filter.
Go the the “Options” filter below it and choose the “% Resource Utilization” and this column to the
right column and click on “Apply” it will show you as in the diagram below.

Document: Redmine User guide.doc Page 61 of 69


Confidential – For internal circulation only
Redmine User guide

29. Resource Allocation


29.1 Project Status
Project status shows summarize view of project. In project status user can view project name,
current status of project, Start and end date of project, purpose, product type and region of
interest of project. Different colours indicate different stages of project.

Also to fasten the resource planning process there are some quick links to create new project, add
members to particular project and create new resource requests for different projects from single
screen.

Document: Redmine User guide.doc Page 62 of 69


Confidential – For internal circulation only
Redmine User guide

29.1.1 Add project link

Direct link to create new project

Document: Redmine User guide.doc Page 63 of 69


Confidential – For internal circulation only
Redmine User guide

29.1.2 Add members link

Using this link you can add, edit project members of project

29.1.3 New request link

From this link user can initiate new resource requests for particular project

Document: Redmine User guide.doc Page 64 of 69


Confidential – For internal circulation only
Redmine User guide

29.2 Resource allocation - Planning


29.2.1 Create new request

Select resource, add description and click on create button to create new create new resource request.

Next screen demonstrates the actual resource planning.

1. Select start date, number of weeks to plan.


2. Add resource workload for that period.
3. Select working days.
4. Click on apply to see workload for that particular resource calculated based on other projects
and available workload.

5. Click on submit if you are ready with this allocation


6. You can adjust the workload and apply again to see the changes.

Document: Redmine User guide.doc Page 65 of 69


Confidential – For internal circulation only
Redmine User guide

29.2.2 Change planning

Click on resource requests to view existing planning.

Planning shows all previous resource requests, that are created by the user logged in.

Resource requests can be created, viewed, edited here.


Planning is possible as long as request is still in the status new.

29.2.3 Deny request

To change the existing planning select deny and change the plan.

Document: Redmine User guide.doc Page 66 of 69


Confidential – For internal circulation only
Redmine User guide

29.3 Resource allocation charts

On clicking the “Resource Allocation” tab, It will show all the members and by selecting a member
allocation of that particular member can be seen.

Click on project name to see whole project team chart

29.3.1 Project team chart


Document: Redmine User guide.doc Page 67 of 69
Confidential – For internal circulation only
Redmine User guide

You can change the staring date and weeks to show project workload as per your requirement.
Chart shows project load in percentage for all project resources.

In below you can see project load with different colors for different resources.

You can click on any resource to view his workload for all projects

Document: Redmine User guide.doc Page 68 of 69


Confidential – For internal circulation only
Redmine User guide

29.3.2 Single resource workload showing workload for all projects

You can change the staring date and weeks to show resource workload as per your
requirement. Chart shows resource load in percentage for all projects.

In below you can see work load with different colors for different projects.

You can click on any project to view workload for that particular project.

Document: Redmine User guide.doc Page 69 of 69


Confidential – For internal circulation only