Redmine

Configuration¶

Redmine settings are defined in a file named .

If you need to override default application settings, simply copy to and edit the new file; the file is well commented by itself, so you should have a look at it.

These settings may be defined per Rails environment (//).

: don’t forget to restart the application after any change.

SCM settings

• override default commands names if the SCM binaries present in the variable doesn’t use the standard name (Windows .bat/.cmd names won’t work)
• specify the full path to the binary

Examples (with Subversion):

Command name override:

Absolute path:

Attachment storage settings

You can set a path where Redmine attachments will be stored which is different from the default ‘files’ directory of your Redmine instance using the setting.

Examples:

Ссылки на объекты Redmine¶

Redmine позволяет встраивать в тексты ссылка на различные ресурсы (задачи, wiki-страницы, ревизии…).

Чтобы предотвратить преобразование redmine-разметки в ссылку поставьте перед ней восклицательный знак.

Wiki-страницы

Ссылка отображается красной, если страницы не существует: Nonexistent page.

]: Guide — ссылка на страницу.

]: User manual — ссылка с произвольным текстом.

]: — ссылка на определенный заголовок страницы.После символа # в названии заголовка ставятся дефисы вместо пробелов.

] — ссылка на wiki-страницу из другого проекта.

] — ссылка на главную страницу Wiki другого проекта.

Вложения

attachment:i0003.gif: i0003.gif — ссылка на файл, прикрепленный к данной странице; если название файла содержит небуквенные символы, следует взять его в двойные кавычки.

Важно: ссылки на прикрепленные файлы действуют только на той странице, к которой они прикреплены

Документы

document#17 — ссылка на документ по идентификатору.

document:somedocument — ссылка на документ по названию.

document:»Some document» — название документа заключается в двойные кавычки, если в нем есть пробелы.

document:some_project:»Some document» — ссылка по названию на документ в другом проекте.

Проекты

project#4 или project:someid — ссылка на проект по числовому или символьному идентификатору.

project:someproject — ссылка на проект по названию.

project:»Some project» — название заключается в двойные кавычки, если в нем есть пробелы.

#3177: #3177 — ссылка перечеркнута, если задача закрыта.

#3177-9: — ссылка на комментарий к задаче.

Версии

version#3 — ссылка на версию по идентификатору.

version:1.0.0 — ссылка на версию по названию.

version:»1.0 beta 2″ — название заключается в двойные кавычки, если в нем есть пробелы.

Изменения

В зависимости от типа хэша изменений, используемого вашим репозитарием:

r758 или commit:c6f4d0fd: r758 — редакция

svn1|r758 или commit:hg|c6f4d0fd: ссылка на редакцию в определенном репозитарии

sandbox:r758 или sandbox:commit:c6f4d0fd: ссылка на редакцию в другом проекте

Файлы репозитория

source:some/file — ссылка на файл репозитория.

source:some/file@52 — ссылка на редакцию файла репозитория.

source:some/file#L120 — ссылка на строку файла репозитория.

source:some/file@52#L120 — комбинация разметки.

source:repo_identifier|some/file — ссылка на репозиторий не по умолчанию.

source:»some file@52#L120″ — двойные кавычки используются, если в URL присутствуют пробелы.

export:some/file — ссылка на скачивание файла.

forum#2: ссылка на форум по идентификатору.

P(. forum:Discussion: ссылка на форум по названию.

P(. forum:»Help and more»: двойные кавычки используются, если в названии есть пробелы.

message#1218: ссылка на сообщение по идентификатору.

Новости

news#1: ссылка на новость по идентификатору.

news:Greetings: ссылка на новость по названию.

news:»eCookbook first release !»: двойные кавычки используются, если в названии есть пробелы.

Notes on Windows installation¶

There is an prebuilt installer of Ruby MRI available from http://rubyinstaller.org.After installing it, select Start Command Prompt with Ruby in the start menu.

When running command as described in this guide, you have to set the environment variable using a separate command.

I.e. commands with the following syntaxes:

RAILS_ENV=production <any commmand>

<any commmand> RAILS_ENV=production

have to be turned into 2 subsequent commands:

set RAILS_ENV=production
<any commmand>

You may need to manually install the mysql gem using the following command:

gem install mysql

And in some case it is required to copy the libmysql.dll file in your ruby/bin directory.Not all libmysql.dll are ok this seem to works http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll.

Important note for Win7 and laterOn Win7 and later, is commented out in the hosts file and IPV6 is the default. As the mysql2 gem does no support IPV6 addresses, a connection can’t be established and you get the error «».You can confirm this by pinging , if ping targets «::1:» IPV6 is being used.

Replace with in database.yml.

5http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why

6http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx

7https://github.com/brianmario/mysql2/issues/279

Prerequisites: Apache, mod-passenger, and MySQL¶

There are several support packages that we will install first. The apache installation is pretty simple if you just follow the prompts and accept the defaults.

$ sudo apt-get install apache2 libapache2-mod-passenger

Installing mysql takes just a little more, so the details are spelled out.

$ sudo apt-get install mysql-server mysql-client 

The installation process for mysql is going to prompt you for a password for the «root» access for the database server, then ask you to confirm the password in a follow-up screen. This sets the database adminstration password.

Package configuration                                                           

  ┌────────────────────┤ Configuring mysql-server-5.5 ├─────────────────────┐   
  │ While not mandatory, it is highly recommended that you set a password   │   
  │ for the MySQL administrative "root" user.                               │   
  │                                                                         │   
  │ If this field is left blank, the password will not be changed.          │   
  │                                                                         │   
  │ New password for the MySQL "root" user:                                 │   
  │                                                                         │   
  │ _______________________________________________________________________ │   
  │                                                                         │   
  │                                 <Ok>                                    │   
  │                                                                         │   
  └─────────────────────────────────────────────────────────────────────────┘   

  ┌────┤ Configuring mysql-server-5.5 ├──────────┐
  │                                              │
  │ Repeat password for the MySQL "root" user.   │
  │                                              │
  │                                              │
  │ ____________________________________________ │
  │                                              │
  │                   <Ok>                       │
  │                                              │
  └──────────────────────────────────────────────┘

Prerequisite: check your ubuntu version against intended Redmine version¶

Before using or studying this guide you should check which Redmine version you are going for. Be aware that only latest stable releases will be fully compatible with current releases of plugins.To check redmine versions versus your ubuntu version have a look at http://www.ubuntuupdates.org/pm/redmine

Generally you could also consider only installing ruby from ubuntu-repos and then heading for a release of redmine from redmine’s download page: http://www.redmine.org/projects/redmine/wiki/Download (this is the more common way of installing redmine on ubuntu). In this case this guide is not suited for you and you should check for an alternate guide. Google provides lots of resources for this alternate installation procedure.

If you are sure that you want to install from ubuntu-repositories, keep on reading:

Информация¶

На этом экране вы можете установить основные (наиболее важные) настройки для выбранного проекта.

Общие параметры

Имя: отображаемое название проекта (должно быть уникальным).

Родительский проект: позволяет вам определить проект, родительский к создаваемому. Проекты могут иметь неограниченную вложенность.

Описание: описание, которое появляется в обзоре проекта.

Уникальный идентификатор: используется приложением для различных нужд (например, в URL). Он должен быть уникальным и не может состоять только из цифр. После создания проекта этот идентификатор не может быть изменен.

Стартовая страница: ссылка на стартовую страницу, которая появляется в обзоре проекта.

Общедоступный: если отмечено, то проект может быть просмотрен всеми пользователями, включая тех, кто не является членом проекта. Если не отмечено, то только пользователи проекта в соответствии с их ролями имеют к нему доступ.

Если есть какие-либо сконфигурированные администратором , то они будут отображены после описанной выше настройки «Общедоступный».

Трекеры

Redmine позволяет определить, какие из (а соответственно, и их ) вы сможете использовать в рамках этого конкретного проекта.

Трекеры: выберите трекеры, которые вы хотите использовать для вопросов по проекту. Только администратор может определить новые трекеры.

Настраиваемые поля

Настраиваемые поля: выберите настраиваемые поля для задач, которые вы хотите использовать для задач этого проекта. Только администратор может определить новые настраиваемые поля.

Обратите внимание, что настроить (например, снять пометку) можно только некоторые из этих настраиваемых полей, — те настраиваемые поля для задач, которые не определены как глобальные настраиваемые поля (что может быть сделано администратором путём установки флажка «Для всех проектов» в окне создания/редактирования настраиваемого поля)

Требования¶

Операционная система

Redmine должен работать на Unix, Linux, Mac, Mac Server и Windows поскольку Ruby доступен для этих платформ. Конкретные инструкции доступны здесь.

Ruby интерпретатор

Соответствие версий Ruby и версий Redmine:

Версия Redmine	Поддерживаемая версия Ruby	Необходимая версия Rails
текущий trunk	ruby 1.9.3, 2.0.0, 2.1, 2.2	Rails 4.2
3.0	ruby 1.9.3, 2.0.0, 2.1, 2.2	Rails 4.2
2.6	ruby 1.8.7, 1.9.2, 1.9.3, 2.0.0, 2.1, 2.2, jruby-1.7.6	Rails 3.2

База данных

• MySQL 5.0 и выше (рекомендуется)

• PostgresSQL 8.2 или выше
  • убедитесь, что тип данных установлен в ISO (настройка по-умолчанию для Postgres). Вы можете установить ее используя:
  • некоторые ошибки в PostgreSQL 8.4.0 и 8.4.1 вызывают ошибки в Redmine(#4259, #4314), они исправлены в PostgreSQL 8.4.2

• Microsoft SQL Server *новое*

  поддержка запланирована для версии 2.3.0 (но она уже доступна в trunk для ранних версий)

SQLite 3 (не для многопользовательского использования!)

Не обязательные компоненты

• Бинарники системы управления исходным кодом (SCM) (например svn), для просмотра хранилища(должны быть доступны в PATH). Прочитайтехранилища Redmine для получения информации о совместимости и требованиях.
• ImageMagick (чтобы включить возможность экспорта диаграммы Ганта в png изображение)
• Ruby OpenID Library (чтобы активировать поддержку OpenID). Требуется версия 2 или выше.

Authentication¶

Authentication required

If this option is checked, no page of the application is accessible to anonymous users. Users must sign to access the application. Default: No

Самостоятельная регистрация

Данная настройка позволяет вам включить/отключить самостоятельную регистрацию для новых пользователей:

• disabled: users are not allowed to register
• account activation by email: new users receive an email containing a link used to activate their accounts (users must provide a valid email address).
• manual account activation (default): new users’ accounts are created but need administrator approval. Administrators receive an email informing them that an account is pending their approval.
• automatic account activation: new users can log in as soon as they have registered.

Let’s the admin decide on the minimum length of the chosen passwords.

Default: 4

Allow OpenID login and registration

Provides the admin a way to disable OpenID logins and registrations.Note that the setting is immutable as long as the dependency for the feature (an installed copy of the gem) is not met. You can simply install it using .

Adding https support¶

Create Apache virtual host

This is assuming you want to connect directly using the server name. Create a file named for example , containing:

<VirtualHost *:443>
  ServerName my-server-name@my-domain.com
  ServerAdmin my-admin-name@my-domain.com
  ErrorLog "logs/redmine_error_log" 

  SSLEngine on
  SSLCertificateFile /etc/pki/tls/certs/ca.crt
  SSLCertificateKeyFile /etc/pki/tls/private/ca.key

  DocumentRoot /var/www/redmine/public

  <Directory /var/www/redmine/public>
    AllowOverride all
    Options -MultiViews
  </Directory>

</VirtualHost>

Create .htaccess with rewrite rules to dispatch.cgi

Note that you need to have created the certificates (plenty of resources on the web on how to do that)

Add the following in :

# General Apache options
<IfModule cgi_module>
    AddHandler cgi-script .cgi
</IfModule>
<IfModule mod_fastcgi.c>
    AddHandler fastcgi-script .fcgi
</IfModule>
<IfModule mod_fcgid.c>
    AddHandler fcgid-script .fcgi
</IfModule>
Options +FollowSymLinks +ExecCGI

# If you don't want Rails to look in certain directories,
# use the following rewrite rules so that Apache won't rewrite certain requests
#
# Example:
#   RewriteCond %{REQUEST_URI} ^/notrails.*
#   RewriteRule .* - 

# Redirect all requests not available on the filesystem to Rails
# By default the cgi dispatcher is used which is very slow
#
# For better performance replace the dispatcher with the fastcgi one
#
# Example:
#   RewriteRule ^(.*)$ dispatch.fcgi 
RewriteEngine On

# If your Rails application is accessed via an Alias directive,
# then you MUST also set the RewriteBase in this htaccess file.
#
# Example:
#   Alias /myrailsapp /path/to/myrailsapp/public
#   RewriteBase /myrailsapp

RewriteRule ^$ index.html 
RewriteRule ^(+)$ $1.html 
RewriteCond %{REQUEST_FILENAME} !-f
<IfModule cgi_module>
    RewriteRule ^(.*)$ dispatch.cgi 
</IfModule>
<IfModule mod_fastcgi.c>
    RewriteRule ^(.*)$ dispatch.fcgi 
</IfModule>
<IfModule mod_fcgid.c>
    RewriteRule ^(.*)$ dispatch.fcgi 
</IfModule>

# In case Rails experiences terminal errors
# Instead of displaying this message you can supply a file here which will be rendered instead
#
# Example:
ErrorDocument 500 /500.html

Create the dispatch.cgi file

Finally, you need a script:

#!/usr/local/bin/ruby                                                                                                                                                                                          

require File.dirname(__FILE__) + '/../config/boot'
require File.dirname(__FILE__) + '/../config/environment'

class Rack::PathInfoRewriter
  def initialize(app)
    @app = app
  end

  def call(env)
    env.delete('SCRIPT_NAME')
    parts = env.split('?')
    env = parts
    env = parts.to_s
    @app.call(env)
  end
end

Rack::Handler::CGI.run Rack::PathInfoRewriter.new(RedmineApp::Application)

Adjusting the SELinux policy

You also need to make sure that Apache is allowed to execute all that part:

% cd /var/www/redmine/public
% sudo chown -R apache:apache .
% sudo chmod +x dispatch.cgi

Finally, it’s necessary to create an SELinux policy allowing that CGI script to run, otherwise you will get an internal server error:

% sudo semanage boolean -m --on httpd_enable_cgi
% sudo semanage fcontext -a -t httpd_sys_script_exec_t /var/www/redmine/public
% sudo restorecon /var/www/redmine/public
% sudo setsebool -P httpd_can_network_connect 1
% sudo setsebool -P httpd_can_network_connect_db 1
% ausearch -c 'dispatch.cgi' --raw | audit2allow -M my-dispatchcgi
% semodule -i my-dispatchcgi.pp

Общая информация¶

Redmine поддерживает интеграцию с различными системами контроля версий «из коробки»:

SCM	Поддерживаемые версии	Комментарии
Subversion	1.3 & 1.4 & 1.5 & 1.6	Необходима 1.3 или выше. Не поддерживает Ruby Bindings для Subversion
CVS	1.12.12	Необходима 1.12, не работает с CVSNT
Mercurial	0.9.3
Bazaar	1.0.0.candidate.1 & 2.0.4
Darcs	1.0.7
Git	1.5.4.2

: соответствующие пакеты должны быть установлены на той же машине, что и Redmine.

К примеру, если вы хотите получить доступ к репозиториям Subversion в Redmine, вы должны установить пакет subversion на машине с Redmine.

: соответствующие пакеты должны быть доступны Redmine :

• они доступны напрямую, в переменной окружения :
• вы можете определить полный путь к пакетам в Redmine

Наконец, удостоверьтесь в том, что выбрали необходимую SCM в

Configuring Apache¶

You need to modify two files for apache. The first is /etc/apache2/mods-available/passenger.conf which needs the text PassengerDefaultUser www-data added as seen below. Do not try to replace whole file content!

<IfModule mod_passenger.c>
  PassengerDefaultUser www-data
  PassengerRoot /usr
  PassengerRuby /usr/bin/ruby
</IfModule>

Now create a symlink to connect Redmine into the web document space:

$ sudo ln -s /usr/share/redmine/public /var/www/html/redmine

And modify /etc/apache2/sites-available/000-default.conf (before apache 2.4 /etc/apache2/sites-available/default) to insert the following with the other <Directory> sections so that apache knows to follow the symlink into Rails:

<Directory /var/www/html/redmine>
    RailsBaseURI /redmine
    PassengerResolveSymlinksInDocumentRoot on
</Directory>

Create and set the ownership of a Gemfile.lock file so that apache’s www-data user can access it:

$ sudo touch /usr/share/redmine/Gemfile.lock
$ sudo chown www-data:www-data /usr/share/redmine/Gemfile.lock

Now restart apache:

$ sudo service apache2 restart

You should now be able to access redmine from the local host

$ firefox http://127.0.0.1/redmine

In the upper right corner of the browser window you should see the «Sign in» link. Click that and enter «admin» at both the Login: and Password: prompts. Note: this is not the password you set during the installation process. Click the Login button.

I recommend that the next thing you do is to click on My account in the upper right corner and change that password. In the page that is displayed there should be a Change password link in the upper right of the white area of the page. Click to change the password.

Почта. Отправка уведомлений на почту в Redmine

Создадим конфиг:

sudo su - redmine
cd redmine/config
cp ./configuration.yml.example ./configuration.yml

Добавим в конфиг настройки:

nano ./configuration.yml

В конце файла добавляем секцию production со своим логином и паролем для gmail:

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      enable_starttls_auto: true
      address: "smtp.gmail.com" 
      port: '587'
      domain: "smtp.gmail.com" 
      authentication: :plain
      user_name: "your_email@gmail.com" 
      password: "your_password"

Разлогиниваемся из под пользователя redmine и перезапускаем apache2:

exit
sudo service apache2 restart

Проверить работоспособность почты можно на вкладке: http://localhost/redmine/settings?tab=notifications

На этой вкладке внизу есть ссылка для тестовой отправки емейла.

Если вы зашли на эту вкладку или после настроек сайт перестал работать, скорей всего вы неправильно отформатировали конфиг, отступы играют роль!

P.S.: теперь у вас есть свой инструмент для управления проектами.

Удачи)

Desktop clients¶

• RMClient for Redmine: RMClient is a brand new reliable timer for recording the work hours in the Redmine project management system. You can track the time you spend on each project, easily filter, search and edit specific tasks, change issue status, as well as assign it to other users. The app notifies you about new tasks. You can connect to many Redmine server and change connection in one click. Works with Redmine 1.3.x—4.x. Supports all major OS — Windows 7 and later, MacOS 10.10 and later, Ubuntu 12.04 and later, Fedora 21, Debian 8. All desktop apps are native for OS. Also RMClient supports Jira.
• Redmine Client: Allows creating issues and logging time spent on them from the desktop. Tested just on Windows and Linux but should work on any platform supported by Mono. Also includes the library usable by other tools aiming to interact with Redmine.
• Redmine Client: A time logging software, integrated in desktop (windows, mac), enabling to log time in Redmine by a single click. Also enables to navigate through issues with direct link for standard web access to issue, projects, versions.
• Redmine Desktop Client: Allows creating/editing issues and logging time spent on them from the desktop. It is a port of the original Redmine Client to use the REST API of Redmine 1.1 and up.
• RedTimer Redmine Time Tracker: An easy-to-use platform-independent time tracker which allows the user to track time while working on an issue.
• arcli: A CLI tool for executing simple actions such as tracking time, listing issues and searching.

Repositories¶

Autofetch commits

If this option is activated, the application automatically retrieves the new revisions when a user consults the repository.

Default: Yes

You can disable this option and automate the call to Repository#fetch_changesets using cron to regularly retrieve the revisions for all of the repositories in the background.Example:

ruby script/runner "Repository.fetch_changesets" -e production

You can also call this task from your repository in a post-commit or post-receive hook, so that changesets are fetched after each commit.Here is a tutorial for doing so with git: http://finalcog.com/remine-git-post-receive

Enabled SCM

Here you can (de)select the SCM-systems Redmine should «provide» to the individual projects. This setting is useful if you only support several SCM-systems (e.g. only Git or only SVN).

Repositories encodings

This option lets you specify preferred encodings for repository files (multiple values allowed, comma separated). These encodings are used to convert files content and diff to UTF-8 so that they’re properly displayed in the browser.When entering multiple encodings, the first valid encoding regarding the file content is used.

For French users, this option can be for example set to:

For Japanese users:

Referencing issues in commit messages

When fetched from the repositories, commit messages are scanned for referenced or fixed issue IDs.These options lets you define keywords that can be used in commit message to reference or fix issues automatically, and the status to apply to fixed issues.

Default keywords are:

• for referencing issues: refs, references, IssueID
• for fixing issues: fixes, closes

There’s no default status defined for fixed issue. You’ll have to specify it if you want to enable auto closure of issues.If you want to reference issues without using keywords, enter a single star: * in the Referencing keywords (Administration/Repository) setting. In this case, any issue ID found in the message will be linked to the changeset.

Example of a working commit message using default keywords:

This message would reference issues 1 and 2 and automatically fix issue 3.After a keyword issue IDs can be separated with a space, a comma or &.

Добавление существующего репозитория к проекту¶

В настройках проекта убедитесь, что модуль ‘Репозиторий’ включен и откройте вкладку ‘Репозиторий’.Выберите SCM, соответствующую вашему репозиторию и введите адрес или URL репозитория.

Важно: Когда вы впервый раз открываете вкладку ‘Хранилище’, Redmine получает описание всех существующих в репозитории фиксаций (коммитов) и сохраняет их в базе данных.Это происходит один раз для каждого репозитория, но может занять длительное время и вызвать time-out, если в вашем репозитории большое количество фиксаций (коммитов). Для того, чтобы этого избежать, сделайте это offline.После добавления репозитория проекту, выполните следующую команду:

Для того, чтобы этого избежать, сделайте это offline.После добавления репозитория проекту, выполните следующую команду:

$ ruby script/runner "Repository.fetch_changesets" -e production

Все фиксации (коммиты) будут извлечены в базу данных Redmine.

Начиная с версии 0.9.x, вы также можете перейти по URL с помощью ключа WS и выполнится:

http://redmine.example.com/sys/fetch_changesets?key=<ключ WS> (=> в бд извлекутся фиксации всех активных проектов)
http://redmine.example.com/sys/fetch_changesets?key=<ключ WS>&id=foo (=> в бд извлекутся только фиксации проекта foo)

Не забудьте аутентификацию по ключу , как описано в .

См. пример в HowTo_setup_automatic_refresh_of_repositories_in_Redmine_on_commit.

Subversion репозиторий

Поддерживаются все стандартные протоколы ( , , …), просто укажите URL репозитория.

Например:

http://имя_машины/путь/к/репозиторию

Укажите имя пользователя и пароль, если репозиторий требует авторизации.

Примечание: если вы хотите получать доступ к репозиторию, используя , необходимо настроить svn+ssh в не-интерактивный режим.Для этого необходимо настроить public/private пару ключей для ssh аутентификации.

Макросы¶

Список доступных макросов и их описание (по-английски) вызывается следующим макросом:

{{macro_list}}

Отображает блок «содержание» страницы, который формируется автоматически на основе выставленных в тексте :

{{TOC}}

{{>TOC}} // блок справа

Дочерние страницы

Выводит список ссылок на все (англ.) для страницы:

{{child_pages}}

Выводит список дочерних страниц для любой страницы:

{{child_pages(RedmineIssues)}}

Пример:

• RedmineIssueList
  • RedmineIssueChangelog
  • RedmineIssueSummary
• RedmineRoadmap

  RedmineVersion

Начинает список со ссылки на страницу:

{{child_pages(RedmineIssues, parent=1)}}

Пример:

• RedmineIssues
  • RedmineIssueList
    • RedmineIssueChangelog
    • RedmineIssueSummary
  • RedmineRoadmap

    RedmineVersion

Выводит дочерние страницы заданной глубины вложенности:

{{child_pages(RedmineIssues, depth=2)}}

• RedmineIssueList
  • RedmineIssueChangelog
  • RedmineIssueSummary
• RedmineRoadmap

  RedmineVersion

{{child_pages(RedmineIssues, depth=1, parent=1)}}

• RedmineIssues
  • RedmineIssueList
  • RedmineRoadmap

Включение текста

Выводит содержимое указанной страницы:

{{include(PMO)}}

Пример (для удобства включение обрамлено горизонтальными разделителями «—» )

PMO

Project Management Offices need to provision and track workloads between competing projects. Redmine is a great project collaboration tool for software teams.

• Workload (weekly timesheet and future assignments per developper with summary information)
• Taskjuggler (for scheduling future tasks leveredged by a first-class scheduling program)

Redmine 0.9 also takes better into account task dependencies. The Taskjuggler round-trip extension and plugin is user for controling developper overload. Workload eases planning of future tasks in man-days.

These plugins are currently under beta development and participation is very much welcome !

Если включаемая страница не найдена или у текущего пользователя нет доступа на её просмотр, будет выведено сообщение об ошибке:

Error executing the include macro (Page not found)

Предпросмотр изображения

Выводит блок шириной 100 px для предварительного просмотра прикрепленного изображения:

{{thumbnail(scm_diff.png)}}

Можно задать ширину блока и всплывающую подсказку:

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

Display¶

Theme

default

• alternate, which mainly provides issue list colorization based on issues priority.
• classic, which is derived from the Redmine 0.5.1 design and brings a classic look.

Screenshot of the alternate theme:

Themes are located in . You can read more about Themes.

Date format

Lets you choose how dates are displayed:

• Based on user’s language: dates will be displayed specifically for each user, according to the format defined for its language
• Other formats: dates will always be displayed using the specified format

Default: Based on user’s language

Time format

Lets you choose how times are displayed:

• Based on user’s language: times will be displayed specifically for each user, according to the format defined for its language
• Other formats: times will always be displayed using the specified format

Default: Based on user’s language

Users display format

Lets you choose how usernames are displayed. The following combinations are provided:

• Firstname
• Firstname Surname
• Surname Firstname
• Surname, Firstname
• Username

Основные настройки¶

Название приложения

Название, которое отображается в заголовке приложения. Это ссылка под полоской с « Домашняя страница/Моя страница/Проекты/Помощь», которая отображается, когда вы вошли в систему.

Количество записей на страницу

Здесь вы можете установить фиксированные значения, которые пользователь может выбрать для отображаемого количества объектов (задач, фиксаций и т.д.) на страницу.

Стандартные значения: 25, 50, 100

Имя компьютера

Имя хоста и путь к серверу Redmine. Это имя используется для записи URL в письма, отправленные пользователям. Например, имя хоста текущей установки Redmine является redmine.org.

Протокол

Протокол используется для генерации ссылки в уведомлениях по электронной почте. По умолчанию: http

Ссылки в почтовых отправлениях «динамические», но невозможно определить, что вы используете небезопасный web-сервер (http) или безопасный (https -> http поверх SSL).

Кешировать форматированный текст

Процесс преобразования форматированного исходного текста в HTML происходит каждый раз, когда текст передается в браузер (например, описание задачи, вики-страницы…). Этот процесс может быть медленным на больших текстах.

Данная настройка позволяет включить кэширование преобразованного текста. Кэшированный текст хранится в хранилище кэша, которое может быть определено в настройках . По умолчанию, хранилище кэша это MemoryStore.

Если вам необходимо включить кэширование, то настоятельно рекомендуется, чтобы вы использовали другое хранилище кэша, такое как MemCacheStore или FileStore если память ограничена.

Вы можете больше узнать о хранилище кэша в руководстве по Rails:

Возможные проблемы¶

Rack n.n.n cannot be loaded because Rack n.n.n is already activated

При использовании Rails 2.3.5 можно получить следующее сообщение Rack 1.0.1 cannot be loaded because Rack 1.0 is already activated.Для решения необходимо изменить файл action_controller в папке приложения по следующему пути vendor/rails/actionpack/lib/action_controller.rbНайти строки 34 и 35, закомитить их и добавить строку чтобы выглядело так

#gem 'rack', '~> 1.0.1'
#require 'rack'
load "/usr/lib/ruby/gems/1.8/gems/rack-1.1.0/lib/rack.rb" 

SVN репозиторий не открывается

в логах мини веб-сервера thin (/var/log/thin/thin.0.logh) пишется что-нить подобное:

svn: OPTIONS of 'https://Сервер/svn/проект': Server certificate verification failed: issuer is not trusted (https://Сервер)

Лекарство: В файле /usr/share/redmine/lib/redmine/scm/adapters/subversion_adapter.rbнайти строку

str << " --no-auth-cache --non-interactive" 

и добавить ключ, включающий поддержку неизвестных SSL сертификатов:

str << " --trust-server-cert --no-auth-cache --non-interactive" 

Issue tracking¶

Allow cross-project subtasks

Define some limits for subtasking. Definitions used are the same as version sharing, documented in . Default: With project tree

• : a parent task can only have subtasks in the same project.
• : a parent task can have subtasks in any other project.
• : a parent task can have subtasks in the same project, ancestor projects and all their descendants (e.g. also «sibling projects», «cousin projects», etc.).
• : a parent task can have subtasks in the same project, subprojects, or ancestor projects.
• : a parent task can only have subtasks in the same project or subprojects (not in parent projects or unrelated projects).

Display subprojects issues on main projects by default

If set to true, subprojects issues will be displayed by default on the issue list, calendar and gantt of the main projects (Since r1198). Default: Yes

Calculate the issue done ratio

Defines how the Issue Done Percentage is set.

• Use the issue field (default): Users can manually set % done.
• Use the issue status: Each issue status can be assigned a percentage. This enables the and the .

Default columns displayed on the issue list

This setting lets you define which columns are displayed on the issue lists by default.Only custom fields that are marked as ‘For all projects’ can be selected here.