diff --git a/redmine/app/controllers/help_controller.rb b/redmine/app/controllers/help_controller.rb
index 6fde039d..32d82299 100644
--- a/redmine/app/controllers/help_controller.rb
+++ b/redmine/app/controllers/help_controller.rb
@@ -31,7 +31,7 @@ class HelpController < ApplicationController
end
end
# choose language according to available help translations
- lang = (@help_config['langs'].include? current_language) ? current_language : @help_config['langs'].first
+ lang = (@help_config['langs'].include? current_language.to_s) ? current_language.to_s : @help_config['langs'].first
if template
redirect_to "/manual/#{lang}/#{template}"
diff --git a/redmine/config/help.yml b/redmine/config/help.yml
index 362165bf..b02a06fb 100644
--- a/redmine/config/help.yml
+++ b/redmine/config/help.yml
@@ -17,6 +17,7 @@
# available languages for help pages
langs:
+ - en
- fr
# mapping between controller/action and help pages
diff --git a/redmine/doc/docbook/en/redmine-userdoc-en.xml b/redmine/doc/docbook/en/redmine-userdoc-en.xml
new file mode 100644
index 00000000..c290bb85
--- /dev/null
+++ b/redmine/doc/docbook/en/redmine-userdoc-en.xml
@@ -0,0 +1,429 @@
+
+
+
+ RedMine Documentation
+
+ Administration
+
+ Users
+ These screens allow you to manage the application users.
+
+ Users’ List
+
+
+ Users’ List
+
+
+
+
+
+
+ The Lock/Unlock buttons allow you to lock/unlock the user accounts.
+ A user having a locked account cannot log in and access the application.
+
+
+ User Creation or Modification
+ In modification mode, please leave the Password field blank in order to keep the user’s password unchanged.
+ A user designated as administrator has unrestricted access to the application and to all projects.
+
+
+
+ Administrator
+ : designate the user as the administrator of the application.
+
+
+
+
+ E-mail notifications
+ : activate or de-activate automatic e-mail notifications for this user
+
+
+
+
+ Locked
+ : de-activates the user’s account
+
+
+
+
+
+
+
+ Roles and Permissions
+ Roles organize the permissions of various members of a project. Each member of a project has a one Role in a project. A user can have different roles in different projects.
+ On the new or edit Role screen, check off the actions authorized for the Role.
+
+
+ Trackers
+ Trackers allow the sorting of Issues and can define specific workflows.
+
+
+ Customized fields
+ Customized fields allow you to add additional information in Projects, Issues or Users. A customized field can be of one the following types:
+
+
+
+ Integer
+ : positive or negative number
+
+
+
+
+ String
+ : a string of characters - one single line of input.
+
+
+
+
+ Text
+ : a string of characters with multiple lines of input. Differs from String Format by providing multiple lines of input instead of a single line.
+
+
+
+
+ Date
+ : date
+
+
+
+
+ Boolean
+ : true or false (check if necessary)
+
+
+
+
+ List
+ : value to select from a predefined list (aka: scroll list or select box)
+
+
+
+ Validation elements can be defined:
+
+
+
+ Required
+ : A required field must have input in the forms
+
+
+
+
+ For all the projects
+ : field automatically associated to all of the projects
+
+
+
+
+ Min - max length
+ : minimum and maximum length for the input fields (0 means that there is no restriction)
+
+
+
+
+ Regular Expression
+ : regular expressions may provide validation of the input value
+
+ Examples:
+
+ ^\[A-Z]{4}\d+$
+ : 4 capital letters followed by one or several digits
+
+
+ ^[^0-9]*$
+ : characters only - no digits
+
+
+
+
+ Possible values
+ : possible values for the fields of "List" type. Values are separated by the character |
+
+
+
+
+
+ Fields for Projects
+
+
+
+
+ Required
+ : required field
+
+
+
+
+
+
+ Fields for Issues
+
+
+
+
+ For all projects
+ : field automatically associated to all project Issues
+
+ If this option is not activated, each project could choose whether or not to use the field for its Issues (please see the project configuration).
+
+
+
+
+
+ Field for Users
+
+
+
+
+ Required
+ : required field
+
+
+
+
+
+
+
+ Issue status
+ These screens allow you to define the different possible Issue statuses.
+
+
+
+ Closed
+ : indicates Issue is considered as closed
+
+
+
+
+ Default
+ : status applied by default to new Issue requests (only one status can be Default status)
+
+
+
+
+ Color
+ : HTML color code (6 characters) representing the displayed status
+
+
+
+
+
+
+ Workflow
+ The workflow allows to define changes the various project members are allowed to make on the Issues, according to their type.
+ Select the role and the tracker for which you want to modify the workflow, then click Edit. The screen allows you then to modify the authorized change, for the chosen role and tracker. The Current Status options indicate the initial request status. The "New Statuses allowed" columns stand for the authorized status to apply.
+
+ Note: In order for a particular Role to change an Issue status, the authorization must be given to it explicitly, regardless of the workflow configuration.
+
+
+
+ Example of a workflow configuration
+
+
+
+
+
+
+ In the above example, Bug type Issue requests with a New status could be given an Assigned or Resolved status by the Developer role. Those with an Assigned status could get a Resolved status. The status of all the other Bug type requests cannot be modified by the Developer.
+
+
+ Enumerations
+ The value lists used by the application can be customized (for example, setting Issue priorities). This screen allows you to define the possible values for each of the following lists:
+
+
+ Issue Priorities
+
+
+ Document Categories
+
+
+
+
+
+ E-mail notifications
+ This screen allows you to select the actions that will generate an e-mail notification for project members.
+ Note: E-mail sending must be activated in the application configuration if you want to make any notifications.
+
+
+ Authentication
+ By default, redMine refers to its own database to authenticate users, by a specific password.
+ If you already have one or several external user references (like LDAP), you can make them known in order to be used for authentication on redMine. This allows users to access redMine with their usual user names and passwords.
+ For each known reference, you can specify if the accounts can be created on the fly on redMine. If needed, the user accounts will be created automatically during the user’s signing in (without any specific rights on the projects), according to information available in the reference. Otherwise, the administrator must have previously created the user account on redMine.
+
+
+ LDAP statement
+
+
+
+
+ Name
+ : reference display name
+
+
+
+
+ Host
+ : LDAP server host name
+
+
+
+
+ Port
+ : connection port to the LDAP server
+
+
+
+
+ Account
+ : DN of the connection account to LDAP (please leave it blank if the directory authorizes anonymous read access)
+
+
+
+
+ Password
+ : password of the connection account
+
+
+
+
+ Base DN
+ : Basic DN used for user search in the directory
+
+
+
+
+ LDAP screen
+ : User search screen in the directory (optional)
+
+
+
+
+ LDAP features
+ :
+
+
+
+
+ Identifier
+ : LDAP feature name used as user identifier (e.g.: uid)
+
+
+
+
+ First name
+ : LDAP feature name including the user’s first name (ex: givenName)
+
+
+
+
+ Last name
+ : LDAP feature name including the user’s last name (ex: familyName)
+
+
+
+
+ E-mail
+ : LDAP feature name including the user’s e-mail address (ex: mail)
+
+
+
+
+
+
+ The features"
+ First name
+ ", "
+ Last name
+ " and "
+ E-mail
+ " are not used except when the accounts are created on the fly.
+
+
+
+
+ Information
+ Displays application and environment information.
+
+
+
+ Projects
+
+ Project preview
+ The preview presents the general project information, its main members, the latest announcements, as well as an synthesis of Issue requests open by tracker.
+
+
+
+ Issue management
+
+
+ Issue list
+ By default, the entire list of the project open Issues are displayed. Various screens allow you to select the Issues to be displayed. If the project has sub-projects, you have the possibility to display the sub-project's Issues as well (not displayed by default).
+ Once applied, a screen is valid during the entire session. You can re-define it or delete it by clicking Cancel.
+
+
+ Request list
+
+
+
+
+
+
+
+
+
+
+ Reports
+ This screen presents the number of Issues and Issue status synthesis according to various criteria (tracker, priority, category). Direct links allow for access to the detailed Issue list for each criterion.
+
+
+ Change log
+ This page presents the entire list of the resolved Issues for each version of the project. Certain types of Issues can be excluded from this display.
+
+
+ News
+ Allows you to inform users on project activity.
+
+
+ Documents
+ Documents are grouped by categories (see Value Lists). A document can contain several files (for example: revisions or successive versions).
+
+
+ Files
+ This module allows you to display various folders (sources, binaires, ...) for each version of the application.
+
+
+ Settings
+
+
+ Project features
+
+
+
+
+ Public
+ : if it’s a public project, it can be viewed (request consultation, documents consultation, ...) for all the users, including those who are not project members. If it’s not a public project, only the project members have access to it, according to their role.
+
+
+
+
+ Customized fields
+ : Select the customized fields that you want to use. Only the administrator can define new customized fields.
+
+
+
+
+
+
+ Members
+ This screen allows you to define the project members as well as their corresponding roles. A user can have only one role in a given project. The role of a member determines the permissions they have in a project.
+
+
+ Versions
+ Versions allow you to follow the changes made during all the project. For instance, at the close of an Issue, you can indicate which version takes it into account. You can display the various versions of the application (see Files).
+
+
+ Request categories
+ Issue categories allow you to organize Issues. Categories can correspond to different project modules.
+
+
+
+
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01.html b/redmine/public/manual/en/ch01.html
new file mode 100644
index 00000000..aa86147e
--- /dev/null
+++ b/redmine/public/manual/en/ch01.html
@@ -0,0 +1,3 @@
+
+
+ Chapter 1. AdministrationredMine home
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s01.html b/redmine/public/manual/en/ch01s01.html
new file mode 100644
index 00000000..9f83e7d3
--- /dev/null
+++ b/redmine/public/manual/en/ch01s01.html
@@ -0,0 +1,3 @@
+
+
+ 1. UsersredMine home
These screens allow you to manage the application users.
1.1. Users’ List
The Lock/Unlock buttons allow you to lock/unlock the user accounts.
A user having a locked account cannot log in and access the application.
1.2. User Creation or Modification
In modification mode, please leave the Password field blank in order to keep the user’s password unchanged.
A user designated as administrator has unrestricted access to the application and to all projects.
Administrator : designate the user as the administrator of the application.
E-mail notifications : activate or de-activate automatic e-mail notifications for this user
Locked : de-activates the user’s account
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s02.html b/redmine/public/manual/en/ch01s02.html
new file mode 100644
index 00000000..06ba7567
--- /dev/null
+++ b/redmine/public/manual/en/ch01s02.html
@@ -0,0 +1,3 @@
+
+
+ 2. Roles and PermissionsredMine home
Roles organize the permissions of various members of a project. Each member of a project has a one Role in a project. A user can have different roles in different projects.
On the new or edit Role screen, check off the actions authorized for the Role.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s03.html b/redmine/public/manual/en/ch01s03.html
new file mode 100644
index 00000000..9253ce10
--- /dev/null
+++ b/redmine/public/manual/en/ch01s03.html
@@ -0,0 +1,3 @@
+
+
+ 3. TrackersredMine home
Trackers allow the sorting of Issues and can define specific workflows.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s04.html b/redmine/public/manual/en/ch01s04.html
new file mode 100644
index 00000000..425e084f
--- /dev/null
+++ b/redmine/public/manual/en/ch01s04.html
@@ -0,0 +1,3 @@
+
+
+ 4. Customized fieldsredMine home
Customized fields allow you to add additional information in Projects, Issues or Users. A customized field can be of one the following types:
Integer : positive or negative number
String : a string of characters - one single line of input.
Text : a string of characters with multiple lines of input. Differs from String Format by providing multiple lines of input instead of a single line.
Date : date
Boolean : true or false (check if necessary)
List : value to select from a predefined list (aka: scroll list or select box)
Validation elements can be defined:
Required : A required field must have input in the forms
For all the projects : field automatically associated to all of the projects
Min - max length : minimum and maximum length for the input fields (0 means that there is no restriction)
Regular Expression : regular expressions may provide validation of the input value
Examples:
^\[A-Z]{4}\d+$ : 4 capital letters followed by one or several digits
^[^0-9]*$ : characters only - no digits
Possible values : possible values for the fields of "List" type. Values are separated by the character |
4.1. Fields for Projects
Required : required field
4.2. Fields for Issues
For all projects : field automatically associated to all project Issues
If this option is not activated, each project could choose whether or not to use the field for its Issues (please see the project configuration).
4.3. Field for Users
Required : required field
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s05.html b/redmine/public/manual/en/ch01s05.html
new file mode 100644
index 00000000..75a4dd30
--- /dev/null
+++ b/redmine/public/manual/en/ch01s05.html
@@ -0,0 +1,3 @@
+
+
+ 5. Issue statusredMine home
These screens allow you to define the different possible Issue statuses.
Closed : indicates Issue is considered as closed
Default : status applied by default to new Issue requests (only one status can be Default status)
Color : HTML color code (6 characters) representing the displayed status
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s06.html b/redmine/public/manual/en/ch01s06.html
new file mode 100644
index 00000000..e7d688f3
--- /dev/null
+++ b/redmine/public/manual/en/ch01s06.html
@@ -0,0 +1,3 @@
+
+
+ 6. WorkflowredMine home
The workflow allows to define changes the various project members are allowed to make on the Issues, according to their type.
Select the role and the tracker for which you want to modify the workflow, then click Edit. The screen allows you then to modify the authorized change, for the chosen role and tracker. The Current Status options indicate the initial request status. The "New Statuses allowed" columns stand for the authorized status to apply.
Note: In order for a particular Role to change an Issue status, the authorization must be given to it explicitly, regardless of the workflow configuration.
In the above example, Bug type Issue requests with a New status could be given an Assigned or Resolved status by the Developer role. Those with an Assigned status could get a Resolved status. The status of all the other Bug type requests cannot be modified by the Developer.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s07.html b/redmine/public/manual/en/ch01s07.html
new file mode 100644
index 00000000..7b95d8a6
--- /dev/null
+++ b/redmine/public/manual/en/ch01s07.html
@@ -0,0 +1,3 @@
+
+
+ 7. EnumerationsredMine home
The value lists used by the application can be customized (for example, setting Issue priorities). This screen allows you to define the possible values for each of the following lists:
Issue Priorities
Document Categories
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s08.html b/redmine/public/manual/en/ch01s08.html
new file mode 100644
index 00000000..3a2ecf28
--- /dev/null
+++ b/redmine/public/manual/en/ch01s08.html
@@ -0,0 +1,3 @@
+
+
+ 8. E-mail notificationsredMine home
This screen allows you to select the actions that will generate an e-mail notification for project members.
Note: E-mail sending must be activated in the application configuration if you want to make any notifications.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s09.html b/redmine/public/manual/en/ch01s09.html
new file mode 100644
index 00000000..599c6017
--- /dev/null
+++ b/redmine/public/manual/en/ch01s09.html
@@ -0,0 +1,3 @@
+
+
+ 9. AuthenticationredMine home
By default, redMine refers to its own database to authenticate users, by a specific password.
If you already have one or several external user references (like LDAP), you can make them known in order to be used for authentication on redMine. This allows users to access redMine with their usual user names and passwords.
For each known reference, you can specify if the accounts can be created on the fly on redMine. If needed, the user accounts will be created automatically during the user’s signing in (without any specific rights on the projects), according to information available in the reference. Otherwise, the administrator must have previously created the user account on redMine.
9.1. LDAP statement
Name : reference display name
Host : LDAP server host name
Port : connection port to the LDAP server
Account : DN of the connection account to LDAP (please leave it blank if the directory authorizes anonymous read access)
Password : password of the connection account
Base DN : Basic DN used for user search in the directory
LDAP screen : User search screen in the directory (optional)
LDAP features :
Identifier : LDAP feature name used as user identifier (e.g.: uid)
First name : LDAP feature name including the user’s first name (ex: givenName)
Last name : LDAP feature name including the user’s last name (ex: familyName)
E-mail : LDAP feature name including the user’s e-mail address (ex: mail)
The features" First name ", " Last name " and " E-mail " are not used except when the accounts are created on the fly.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch01s10.html b/redmine/public/manual/en/ch01s10.html
new file mode 100644
index 00000000..5cdb85b9
--- /dev/null
+++ b/redmine/public/manual/en/ch01s10.html
@@ -0,0 +1,3 @@
+
+
+ 10. InformationredMine home
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02.html b/redmine/public/manual/en/ch02.html
new file mode 100644
index 00000000..b97b78d9
--- /dev/null
+++ b/redmine/public/manual/en/ch02.html
@@ -0,0 +1,3 @@
+
+
+ Chapter 2. ProjectsredMine home
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s01.html b/redmine/public/manual/en/ch02s01.html
new file mode 100644
index 00000000..63cdde63
--- /dev/null
+++ b/redmine/public/manual/en/ch02s01.html
@@ -0,0 +1,3 @@
+
+
+ 1. Project previewredMine home
The preview presents the general project information, its main members, the latest announcements, as well as an synthesis of Issue requests open by tracker.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s02.html b/redmine/public/manual/en/ch02s02.html
new file mode 100644
index 00000000..4354ce4c
--- /dev/null
+++ b/redmine/public/manual/en/ch02s02.html
@@ -0,0 +1,3 @@
+
+
+ 2. Issue managementredMine home
By default, the entire list of the project open Issues are displayed. Various screens allow you to select the Issues to be displayed. If the project has sub-projects, you have the possibility to display the sub-project's Issues as well (not displayed by default).
Once applied, a screen is valid during the entire session. You can re-define it or delete it by clicking Cancel.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s03.html b/redmine/public/manual/en/ch02s03.html
new file mode 100644
index 00000000..351e1c91
--- /dev/null
+++ b/redmine/public/manual/en/ch02s03.html
@@ -0,0 +1,3 @@
+
+
+ 3. ReportsredMine home
This screen presents the number of Issues and Issue status synthesis according to various criteria (tracker, priority, category). Direct links allow for access to the detailed Issue list for each criterion.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s04.html b/redmine/public/manual/en/ch02s04.html
new file mode 100644
index 00000000..14da5dc7
--- /dev/null
+++ b/redmine/public/manual/en/ch02s04.html
@@ -0,0 +1,3 @@
+
+
+ 4. Change logredMine home
This page presents the entire list of the resolved Issues for each version of the project. Certain types of Issues can be excluded from this display.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s05.html b/redmine/public/manual/en/ch02s05.html
new file mode 100644
index 00000000..3a8334df
--- /dev/null
+++ b/redmine/public/manual/en/ch02s05.html
@@ -0,0 +1,3 @@
+
+
+ 5. NewsredMine home
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s06.html b/redmine/public/manual/en/ch02s06.html
new file mode 100644
index 00000000..71ced340
--- /dev/null
+++ b/redmine/public/manual/en/ch02s06.html
@@ -0,0 +1,3 @@
+
+
+ 6. DocumentsredMine home
Documents are grouped by categories (see Value Lists). A document can contain several files (for example: revisions or successive versions).
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s07.html b/redmine/public/manual/en/ch02s07.html
new file mode 100644
index 00000000..b7eacb6a
--- /dev/null
+++ b/redmine/public/manual/en/ch02s07.html
@@ -0,0 +1,3 @@
+
+
+ 7. FilesredMine home
This module allows you to display various folders (sources, binaires, ...) for each version of the application.
\ No newline at end of file
diff --git a/redmine/public/manual/en/ch02s08.html b/redmine/public/manual/en/ch02s08.html
new file mode 100644
index 00000000..f9d19e8c
--- /dev/null
+++ b/redmine/public/manual/en/ch02s08.html
@@ -0,0 +1,3 @@
+
+
+ 8. SettingsredMine home
Public : if it’s a public project, it can be viewed (request consultation, documents consultation, ...) for all the users, including those who are not project members. If it’s not a public project, only the project members have access to it, according to their role.
Customized fields : Select the customized fields that you want to use. Only the administrator can define new customized fields.
8.2. Members
This screen allows you to define the project members as well as their corresponding roles. A user can have only one role in a given project. The role of a member determines the permissions they have in a project.
8.3. Versions
Versions allow you to follow the changes made during all the project. For instance, at the close of an Issue, you can indicate which version takes it into account. You can display the various versions of the application (see Files).
8.4. Request categories
Issue categories allow you to organize Issues. Categories can correspond to different project modules.
\ No newline at end of file
diff --git a/redmine/public/manual/en/resources/issues_list.png b/redmine/public/manual/en/resources/issues_list.png
new file mode 100644
index 00000000..47eab0fc
Binary files /dev/null and b/redmine/public/manual/en/resources/issues_list.png differ
diff --git a/redmine/public/manual/en/resources/users_list.png b/redmine/public/manual/en/resources/users_list.png
new file mode 100644
index 00000000..0c9ef86e
Binary files /dev/null and b/redmine/public/manual/en/resources/users_list.png differ
diff --git a/redmine/public/manual/en/resources/workflow.png b/redmine/public/manual/en/resources/workflow.png
new file mode 100644
index 00000000..04e79d61
Binary files /dev/null and b/redmine/public/manual/en/resources/workflow.png differ
