====== Redmine主要功能说明 ======

  * 项目任务管理
    * 登记功能需求、bug等项目任务
    * 跟进任务状态（是否进行中，是否已完成）
    * 任务讨论
  * 项目文档共享，例如接口文档等
  * 项目知识库，已经形成定论的，希望留存的所有信息

====== 安装 ======

参考[[http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Ubuntu_step_by_step|HowTo Install Redmine on Ubuntu step by step]]

====== 新手入门 ======

打开登录页面输入用户名密码登录系统

{{redmine_login.png?400|}}

登录成功后，可能提示403错误，一般是由于默认的首页没有权限查看，点击右上角的【选择一个项目】按钮选择自己的项目或者点击左上角的【项目】菜单查看所有项目

{{redmine_home_403.png?400|}}

===== 切换项目 =====

切换项目有两种方法，一是点击右上角的【选择一个项目】，二是点击页面上方的【项目】菜单进入项目列表后，再选择项目

===== 录入问题 =====

切换项目后，选择【新建问题】标签页，输入内容即可。输入内容主要说明如下（新建后所有内容依然可以修改）：

  * 跟踪：问题种类，一般情况下，新的功能对应的类别是【功能】，系统bug对应的类别是【问题】，系统有不好用的功能，需要改进的是【改进】，其他分类一般不需要。
  * 主题：对问题的一句话描述，一般【功能】对应的是描述建议是“增加XXX功能”或者“XXX页面，增加XXX功能”，【问题】对应的描述建议是“XXX页面，XXX功能应该是XXX，而不是XXX”，【改进】对应的描述建议是“完善XXX，增加表格高度”。
  * 描述：当主题内容不够说明问题的情况下，通过描述进行补充说明。
  * 状态：新建问题默认是new状态，不需要调整
  * 优先级：待解决问题的紧急程度，最紧急的选择【立刻】，其次是【紧急】、【高】、【普通】和【低】
  * 文件：如果有图片或者文件内容用于补充说明问题时，可以上传文件
  * 创建：点击后完成问题新建，并调转到新建的问题详情页面
  * 创建并继续：如果是在测试，那么可能会发现并新建很多问题，那么点击该按钮，在新建一个问题后，依然返回新建问题页面

{{redmine_new_issue.png?400|}}

===== 处理问题 =====

在【问题】标签页，可以处理已经新建的问题，包括编辑、更改状态等功能，点击列表的标题列可以排序。点击列表中某一行的主题链接，可以查看问题详情。

鼠标右键点击列表中某一行的空白处（一定要是点击某一行的空白处）可以弹出菜单，弹出菜单常用功能如下：

  * 编辑：点击编辑功能，调转到问题编辑页面
  * 状态：修改问题状态，问题状态包括以下几种类型：
  * New：问题已经新建，但是还没有任何人在处理
  * In Progress: 问题正在解决中
  * Resolved：开发人员认为问题已经解决
  * Closed：新建问题的人确认问题已经解决
  * 跟踪：修改跟踪类型
  * 优先级：修改优先级

{{redmine_issues.png?400|}}

====== 使用小技巧 ======

===== 已有功能清单，如何快速录入到redmine =====

  * 将功能清单的任务列复制到新的excel文件中，excel文件保存为csv格式
  * 打开redmine，在【问题】标签页右侧选择【导入】功能
  * 选择csv文件，然后按步骤操作就能快速将所有任务录入到redmine中了

====== Redmine发送邮件配置 ======

  * 通过find命令找到configuration.yml文件：''%%find / -iname "*configuration.yml*"%%''，如果找到的是configuration.yml.example，进入路径复制该文件为configuration.yml即可
  * 编辑configuration.yml文件：''%%vim <path>/configuration.yml%%''，在email_delivery下面添加如下内容（以腾讯企业邮为例）：

<code>
    delivery_method: :smtp
    smtp_settings:
      ssl: true
      address: "smtp.exmail.qq.com"
      port: 465
      domain: "smtp.exmail.qq.com" # 'your.domain.com' for GoogleApps
      authentication: :plain
      user_name: "<user_name>"
      password: "<password>"
</code>