readmine的用户手册.docx
《readmine的用户手册.docx》由会员分享，可在线阅读，更多相关《readmine的用户手册.docx（43页珍藏版）》请在冰豆网上搜索。
readmine的用户手册
Redmine用户手册
作者:
北京群英汇信息技术有限公司
网址:
版本:
日期:
2010-08-1311:
18:
52
版权信息:
1 说明
2 用户账号
o 我的账号
o 忘记密码
o 注册
o 我的工作台
3 登录
4 注册
5 项目概述
6 项目活动
7 问题跟踪
o 问题列表
o 路线图
版本概述
o 日历
o 甘特图
8 实时跟踪
9 新闻
10 文档
11 文件
12 讨论区
13 Wikis
14 Redminewiki的文本格式
o 链接
Redmine链接
wiki链接
链接到其他资源
转意字符
外部链接
o 文本格式
字体样式
内嵌图片
标题
段落
块引用
无序列表
有序列表
表格
内容列表
宏（Macros）
15 版本库
o 版本库统计
16 项目配置
17 Redmine与其他工具整合
o Redmine与TestLink的整合
o Redmine与TortoiseSVN的整合
o Redmine与Mylyn的整合
通用的Web仓库链接器（WebRepositoryconnector）
配置步骤
.1 创建一个任务仓库（TaskRepository）
.2 创建一个查询
Redmine专用的Redmine-MylynConnector
插件的依赖关系:
客户端安装
服务器端安装
配置步骤
.1 在Eclipse中添加任务仓库
.2 为刚创建的任务仓库添加查询
1 说明
关于手册中方框标记部分的说明
Note 是需要注意的部分。
Hint 是群英汇为Redmine扩展的部分。
2 用户账号
我的账号
我的账号截图
信息
该区域用于修改用户的姓名、邮件地址和语言设置。
邮件通知
邮件通知的下拉框选项有：
o只收取我跟踪或参与的项目的通知
o收取我的项目的所有通知
你可以根据自己的需要选择不同的邮件通知策略
同时，你也可以选种下拉框下面的那个复选框（不要发送对我自己提交的修改的通知），这样就可以避免接收到你自己活动的邮件通知。
首选项
o隐藏我的邮件地址
如果选中，那么在显示你个人信息的页面将不会显示你的邮件地址。
o时区
用于设置你所在的时区，以便更好显示你的活动时间。
o显示注释
用于设置注释显示的顺序。
按时间顺序
此时问题（issues）的历史记录按照时间顺序显示，即先提交的comments显示在前面，具体可参见下面的截图。
按时间顺序（倒序）
此时问题（issues）的历史记录按照时间顺序倒序显示，即先提交的comments显示在后面，具体可参见下面的截图。
按时间顺序
按时间顺序（倒序）
忘记密码
如果你忘记了密码,可用点击登录界面上的"忘记密码"链接,然后填入你的邮箱地址,点击提交。
随后你将收到一封邮件,点击该邮件里的那个超链接,你将跳到一个修改用户密码的界面,输入新密码以及确认密码。
这样,你就可以用刚才新建的密码登录系统了。
Note
管理员可以禁用该功能
如果你的账号使用了外部认证（如LDAP）,同样不能使用该功能。
因为外部认证的密码存储在LDAP中,Redmine不能修改LDAP里的信息。
注册
点击主页右上角的"注册"链接,用户可以自己注册。
填写好表单提交后你将收到一封激活账号的邮件,通过邮件里的链接,可以激活你刚注册的账号。
Note
该功能需要管理员开启"允许自注册"功能,并选择通过邮件激活账号
我的工作台
点击主页左上角的"我的工作台"链接，页面将跳转的当前用户的工作台。
我的工作台截图
该页面用于显示你所参与的项目的各种信息块。
默认情况下只有下面两个模块启用：
指派给我的问题
提供一个跨项目的指派给当前用户的问题列表，显示问题的ID，项目，跟踪标签类型和主题。
已报告的问题
提供一个跨项目的由当前用户报告的问题列表，显示问题的ID，项目，跟踪标签类型和主题。
Hint
群英汇为我的工作台添加了 任务日程安排 模块，同时修改了默认的布局：
上面：
任务日程安排
左边：
跟踪的问题
右边：
已报告的问题
当指派给你的问题太多时， 指派给我的问题 区域中的问题显得杂乱无章，从而令你不知从哪一个问题先下手。
此时的你或许会想起了Mylyn（主要用于管理你的任务，设置日程安排）：
如果Redmine有Mylyn的功能，那么我的工作就井井有条了。
群英汇为Redmine添加的Mylyn日程安排功能，正是在这种呼声中诞生的。
该功能主要借鉴于Mylyn，因此如果你使用过Mylyn，那么你将会很熟悉该功能。
功能介绍：
该模块会显示从当前日期开始一周的每一天以及本周（从本周一到本周日）、下周（从下周一到下周日）、下下周（从下下周一到下下周日）、未来（下下周以后）和None（没有设置计划日期的任务将显示在该组）这些组。
如果该组没有安排任务，则不会显示。
当前日期（今天）那一组不仅仅只显示规划到今天的任务，而且还会显示那些已经超过完成日期而未完成的任务（并用红色圆圈叹号图标标识）,以及那些已经超过计划日期而未完成任务（并用黄色三角叹号图标标识）
同时对于那些计划日期设置在完成日期之后的任务，在分组时以完成日期为标准。
操作说明：
在 None 组中选择某一问题或者多个问题（注意多个问题要在同一个项目，否则将会操作失败。
因为Redmine目前还不支持跨项目批量修改问题），点击鼠标右键，在弹出菜单中选择 计划日期 选项，进而在二级菜单中设置计划日期。
如果设置成功，系统提示 更新成功 ，而且点击所设置的计划日期组，会发现该组多了一个任务，如下图红色方框圈中的内容。
同时，在项目的问题列表页面，如果该问题指派给你，那么当你点击鼠标右键时，在弹出菜单中会多出设置 计划日期 的选项。
否则不会显示该选项。
每一个用户可以通过点击"个性化定制本页"的链接，进入我的工作台设置界面。
在 我的工作台模块 下拉框中选择想要添加的模块，然后点击右侧的 新增 链接，完成模块添加。
同时在该页面可以通过拖拽，改变各个模块的布局。
最后别忘了点击右侧的 返回 链接退出自定义模式，Redmine将自动保存当前的布局。
下拉框中可选的模块有：
日历
提供一个跨项目的每周日历概述
文档
提供一个跨项目的最近文档概述
最近的新闻
提供一个跨项目的最近新闻概述
耗时
提供一个跨项目的关于当前用户最近7天工时的概述
跟踪的问题
提供一个跨项目的由当前用户跟踪的问题列表
3 登录
点击主页右上角的"登录"链接
可跳到登录页面
输入登录名和密码,点击登录按钮,即可进入系统。
Hint
单点登录功能
群英汇给Redmine添加了单点登录的功能:
该功能主要是省去了多个应用重复输入登录信息的麻烦,免去了员工记忆多个账号的烦恼。
加上单点登录功能之后,在一个应用中登录之后,不用再次输入登录名和密码就可以访问其他应用程序了（前提是你的所有应用都支持单点登录）。
这样在一定程度上减少了密码的暴露几率,提高了账号的安全性。
4 注册
Hint
群英汇集中管理平台，使用统一的用户注册平台
群英汇的集中管理平台，包含用户注册和帐号管理功能，和集中管理平台整合的应用需关闭用户注册功能。
即群英汇部署的Redmine，用户注册将跳转到集中管理平台。
如果管理员开启用户自注册，则允许用户在集中管理平台进行自注册，否则需要由管理员统一创建用户帐号。
下面是Redmine内置的用户注册界面，该操作需要管理员开启"允许用户注册"的功能。
注册截图
注册用户需要填写的字段包括:
登录名,密码,名字,姓氏和邮箱,以及可选的用户语言字段。
注册流程
根据管理员的设置,用户的账号由以下几种激活方式:
通过邮件认证激活账号
用户注册后,将收到一封激活账号的邮件,通过点击邮件里的链接,就可以激活刚注册的邮件。
手动激活账号
用户注册后,需要等待管理员手动激活刚注册的账号。
自动激活账号
用户注册后,直接可以用刚才注册的账号登录系统。
5 项目概述
项目概述截图
该页面提供一个关于该项目的总体概述
左上角的问题跟踪区域列出了目前项中每一种问题跟踪标签的打开数量以及总共数量
在成员区域列出该项目组的所有成员
在最新新闻区域列出了项目的最新新闻
6 项目活动
项目活动截图
该页面列出了该项目所有活动的历史记录,这些活动包括:
问题
变更
新闻
文档
文件
Wiki编辑记录
帖子
耗时
该页面的右边栏允许你选择具体显示哪类活动
如果你想要同时显示子项目的活动,那么你需要选种"子项目"复选框。
Hint
修改查看项目活动的基准时间
Redmine将当天的日期作为显示项目活动的基准时间,当你点击"活动"选项卡时,它会显示前30天到当天的活动。
这样会出现一个问题:
当项目连续30天没有活动时,项目活动首页会出现空白页。
群英汇的修改:
将最后一次活动时间作为基准时间,这样就避免了上述问题的发生。
7 问题跟踪
问题是Redmine的核心业务。
一个问题绑定到一个项目,由某一用户创建,可以关联到某一版本,等等。
查看某一问题
在问题列表页面点击某一问题的链接,可以查看该问题的具体描述。
子任务
该功能在版本引入。
可以将一个问题拆分为若干个子问题。
在使用redmine的过程中，可能有的用户会抱怨，只能将问题指派给一个项目成员，而不能指派给多个项目成员共同完成。
出现这种问题，从某种程度上来说，应该是你划分问题/任务过于粗糙（粒度过大），因此子任务功能就是为用户提供拆分问题/任务的操作，从另一方面解决了将一个问题/任务指派给多人。
首先需要在 角色和权限 设置中为某些角色开启 管理子任务 功能，这样该角色的用户才有创建子任务的权力。
操作步骤：
o点击某一问题，进入问题查看页面。
然后点击子任务区域的 新增 链接，进入新建子任务页面。
o父任务字段的值系统自动获得，其他字段像创建问题一样输入，最后点击保存。
输入问题的描述信息
成功创建子任务
相关的问题
允许开发者将某一问题与其他问题建立关联,从而起到了删除重复问题,简化工作流的作用。
当前版本允许建立的关联类型有:
o关联到
o重复
如果问题B重复于A，那么关闭A将自动关闭B。
o阻挡
如果问题B阻挡A，A无法关闭，除非B已经关闭。
o优先于
如果A优先于B，那么将B的起始日期自动设置为A的截至日期+延迟天数+1。
o跟随于
问题B跟随于A（例如A截至于21/04，B开始于22/04），这时如果将A的截至日期延迟2天，那么B的起始和截至日期将自动推迟2天。
点击问题显示页面相关问题区域的"新增"链接,可根据具体的情况建立不同类型的问题关联。
管理员可以定义添加和修改问题关联的权限
跟踪者
点击问题显示页面跟踪者区域的"新增"链接,在下拉列表里选择跟踪者
管理员可以定义添加和删除跟踪者的权限
相关修订
当提交代码时在提交注释中引用某一问题,那么稍后将会在该问题的显示页面中出现对于该次提交的描述信息。
相关修订截图
具体那些使用那些关键字,可以咨询你们的管理员,看他是如何配置的。
新建问题
要创建新的问题,你需要有新建问题的权限
创建问题时,最重要的字段是跟踪标签字段,它决定了问题的类型。
默认情况下,Redmine有三种跟踪标签:
o缺陷
o功能
o支持
更新已经存在的问题
要更新问题的属性,你需要有编辑问题的权限。
问题列表
概述
点击"问题"选项卡,默认你将看到该项目中所有处于打开状态的问题。
过滤器的应用
默认情况下,问题列表显示了所有处于打开状态的问题。
你可以添加过滤器,点击"应用"链接刷新问题列表,点击"清除"链接删除设置的滤器。
你可以通过点击那个小"+"号按钮,为过滤器字段选择多个值。
这时会出现一个选择列表,按住"ctrl"后,可选择多个值。
自定义查询
当刷新页面后,刚设置的过滤器就会消失,你可以通过点击"保存"链接保存你设置的过滤器,从而建立自定义查询。
在新建自定义查询的界面输入自定义查询的名称,以及过滤器和其他属性的设置。
点击保存之后,新建的自定义查询将会出现在问题列表界面的右边栏中。
快捷菜单
在问题列表的某一个问题上,点击鼠标右键,将弹出一个快捷菜单,用于便捷编辑问题。
快捷菜单包含的选项有:
o编辑
o状态
o跟踪标签
o优先级
o目标版本
o指派给
o完成度
o登记工时
o跟踪者
o副本
o复制
o移动
o删除
批量编辑问题
在问题列表界面,你可以通过选择多个复选框,也可以按住"ctrl"键的同时选择多个问题,然后点击右键,同样会弹出一个快捷菜单,可以对选中的多个问题同时编辑。
你也可以点击复选框上面的那个"对号"图标,全选问题或则撤销全选。
边栏
问题列表的右侧边栏提供了几种不同的功能链接:
o问题区域
查看所有问题
该链接用于从自定义查询页面跳回问题列表页面
摘要
从项目级别上查看问题的概述
日历
日历上显示问题以及目标版本,用于把握项目的进度。
甘特图
显示问题与时间的的二维图表,从而清晰地展现了项目的进度与当前的主要任务。
o自定义查询区域（如果你建立了自定义查询）
该区域列出了所有自定义查询的链接
路线图
路线图提供了一个更高级别的基于项目版本的对于整个问题跟踪系统的概述,它可以帮助制定项目计划,管理项目开发。
概述
点击"路线图"选项卡,你就可以查看当前项目的进展状态:
o版本名称
o版本的完成日期
o进度条
根据问题状态所占的百分比（即问题的完成度）,统计出目标版本的完成度。
o目标版本相关连的问题列表
管理路线图
如果你的权限合适,你可以为版本添加一个wiki页面（参考 项目版本）,用于描述当前版本的一些主要事件。
边栏
路线图页面的右边栏为你提供了以下功能:
o可以根据需要,选择路线图上显示哪些跟踪标签。
o可以根据需要,选择是否显示已经完成的版本
o所有版本的链接
版本概述
版本概述提供了一个详细的关于当前版本的状态描述。
包括:
版本名称
版本完成时间
版本的进度条
wiki（如果管理员配置了wiki页面）
相关的问题列表
时间跟踪区域
o预期时间
o耗时
分组显示区域
可供分组显示问题的选项有:
o类别
o跟踪标签
o优先级
o作者
o指派给
日历
概述
在问题列表页面,点击右边栏的"日历"链接,即可进入日历界面。
日历提供了一个按月份显示的项目预览。
在这里你可以看到一个任务状态的起止日期。
过滤器
像Redmine提供的其他视图一样,你可以通过设置过滤器从而决定日历图上显示的内容。
过滤器的用法可以参见 过滤器
甘特图
在问题列表页面,点击右边栏的"甘特图"链接,即可进入甘特图界面。
甘特图显示问题的起止日期以及版本的截至日期
甘特图截图
8 实时跟踪
实时跟踪允许你跟踪解决某一具体问题所花费的时间。
通过填写预期时间,项目经理可以根据你的进度更好地制定项目计划。
同时实时跟踪与项目成员建立了关联,从而有效的度量了每个成员的工作情况。
给问题登记工时
通过点击问题浏览页面上"登记工时"的链接,可以给该问题登记工时。
预计耗时字段可填入的时间格式如下:
o整数格式的小时和分钟:
1,1h,1hour,2hours,30m,30min,1h30,1h30m,1:
30
o小数格式的小时:
1,5（等于1h30）
你也可以在更新问题时填入工时
项目级别的登记工时
如果登记工时时问题字段为空,那么该工时就属于整个项目的工时。
9 新闻
在"新闻"选项卡下,你可以发布关于项目的新闻条目,甚至任何你喜欢的新闻条目。
新闻条目包含的字段有:
标题
概述
概述将和标题一起被显示在项目概述页面的 最近新闻 部分,而详细信息只有点击了该新闻条目时才能看到。
详细信息
如果你有创建新闻的权限,那么你就可以添加/编辑/删除新闻。
10 文档
在这里可以书写不同类型的文档,默认有两种文档类型:
用户文档
技术文档
管理员可以添加文档类型
11 文件
在这里可以上传项目需要用到的其他资源,如图片,视频等等。
12 讨论区
讨论区给项目成员之间提供一个交流的平台。
管理员根据需要可以创建不同类别的讨论区。
讨论区列表页面显示的内容:
o话题的总数
o留言的总数
o最后留言的链接
发起一个话题
点击右上角的"新贴"链接,进入新建贴子的页面,输入主题和内容,点击创建按钮,一个新的话题就发起了。
话题有两个可选选项:
o置顶（sticky）:
如果选中,表示该话题将会在讨论区列表置顶,并加粗显示
o锁定（locked）:
如果选中,表示该贴不允许用户跟贴
13 Wikis
创建一个新的Wiki页面
在任何一个wiki页面，仅仅需要添加一个你想要创建的新页面的链接。
[[MyNewPage]]
保存当前页面，点击刚添加的链接，恭喜：
你已经成功创建了一个名为"MyNewWikiPage"的新页面。
保护wiki页面
如果你拥有保护wiki页面的权限，你可以点击"锁定"链接保护该Wiki页面。
已经锁定的wiki页面只允许拥有保护wiki页面权限的用户编辑。
拥有此权限的用户同样可以为该页面解锁。
Wiki页面的历史
Redmine保存每一次wiki页面的改动历史。
通过点击"历史"链接你可以浏览这些变更。
点击变更的序列号可查看某一个具体版本的页面信息。
你可以通过点击"回退到这个版本"的链接回退该页面到先前的版本。
14 Redminewiki的文本格式
Redmine默认使用Textile作为wiki的文本格式过滤器,当然你也可以下载其他文本格式过滤器插件（Markdown,reST等）。
以下介绍的语法都是基于Textile 。
链接
Redmine链接
Redmine允许在任何wiki文本格式里引用问题，变更集和wiki页面的超链接。
链接到问题:
#124（显示为#124,如果此问题已经关闭则显示删除线）。
链接到变更集:
r758（显示为r758）。
使用非数字的哈希值链接到变更集:
commit:
c6f4d0fd（显示c6f4d0fd）。
wiki链接
[[Guide]]显示一个链接到"Guide"的链接:
Guide
[[Guide|Usemanual]]显示指向同一页面的链接，链接显示的文本是:
Usemanual
[[Guide#Use-guide|Useguide]]显示指向同一页面头的链接，链接显示的文本是:
Useguide
可以加入指向其它项目wiki页面的链接
[[sandbox:
somepage]]显示一个指向Sandbox项目名称为"Somepage"的wiki页面的链接。
[[sandbox:
]]显示一个指向Sandbox项目Wiki主页面的链接。
如果Wiki页面不存在，则连接将显示为红色。
链接到其他资源
文档
odocument#17（链接到ID为17的文档）
odocument:
Geetings（链接到标题为"Geetings"的文档）
odocument:
"Somedocument"（当文档标题含有空格时需要使用双引号）
版本
ovesion#3（链接到ID为3的版本）
ovesion:
（链接到名称为""的版本）
ovesion:
"beta2"（当版本名称含有空格时需要使用双引号）
附件
oattachment:
（链接到当前页面名称为的附件）
o到目前为止,只能引用当前页面的附件（如果您在编辑问题，则只能引用此问题的附件）
版本库
osouce:
some/file链接到项目版本库的/some/file文件
osouce:
some/file@52链接到项目版本库/some/file文件的第52版本
osouce:
some/file#L120链接到项目版本库/some/file文件的第120行
osouce:
some/file@52#L120链接到项目版本库/some/file文件的第52版本的第120行
osouce:
"some file@52#L120"如果URL中有空格，需要使用双引号来。
链接到项目版本库somefile文件的第52版本的第120行
oexpot:
some/file强制显示该文件的下载链接
转意字符
如果您不希望Redmine将上述标记解释为链接，可以在它们前面添加一个感叹号：
!
外部链接
HTTPURLs和邮件地址将自动转换为可点击的链接
如果你想指定链接显示的文本,你可以使用标准的textile语法。
"群英汇"
文本格式
对于标题、粗体、表格、列表,Redmine支持Textile语法。
参考 上对使用这些特征的详细信息。
下面列出一些例子:
字体样式
*bold*加粗
_italic_斜体
*_bolditalic_*加粗并斜体
+underline+下划线
-strike-through-删除线
内嵌图片
!
image_url!
显示地址为image_url的图片（textile语法）
!
>image_url!
图片右悬浮
!
{width:
300px}image_url!
设置图片的显示宽度
如果你的wiki页面有图片附件,你可以使用文件名:
!
!
显示它。
标题
h1.一级标题
h2.二级标题
h3.三级标题
段落
p>.右对齐
p=.居中
块引用
段落以bq.开始
无序列表
*Item1
*It
升级会员 