readmine的用户手册.docx

1、readmine的用户手册Redmine 用户手册作者:北京群英汇信息技术有限公司网址:版本:日期:2010-08-13 11:18:52版权信息: 1说明 2用户账号o 我的账号o 忘记密码o 注册o 我的工作台 3登录 4注册 5项目概述 6项目活动 7问题跟踪o 问题列表o 路线图 版本概述o 日历o 甘特图 8实时跟踪 9新闻 10文档 11文件 12讨论区 13Wikis 14Redmine wiki的文本格式o 链接 Redmine链接 wiki链接 链接到其他资源 转意字符 外部链接o 文本格式 字体样式 内嵌图片 标题 段落 块引用 无序列表 有序列表 表格 内容列表 宏(Ma

2、cros) 15版本库o 版本库统计 16项目配置 17Redmine与其他工具整合o Redmine与TestLink的整合o Redmine与TortoiseSVN的整合o Redmine与Mylyn的整合 通用的Web仓库链接器(Web Repository connector) 配置步骤 .1创建一个任务仓库(Task Repository) .2创建一个查询 Redmine专用的 Redmine-Mylyn Connector 插件的依赖关系: 客户端安装 服务器端安装 配置步骤 .1在Eclipse中添加任务仓库 .2为刚创建的任务仓库添加查询1说明关于手册中方框标记部分的说明 N

3、ote是需要注意的部分。 Hint是群英汇为Redmine扩展的部分。2用户账号我的账号我的账号截图 信息该区域用于修改用户的姓名、邮件地址和语言设置。 邮件通知邮件通知的下拉框选项有：o 只收取我跟踪或参与的项目的通知o 收取我的项目的所有通知你可以根据自己的需要选择不同的邮件通知策略同时，你也可以选种下拉框下面的那个复选框（不要发送对我自己提交的修改的通知），这样就可以避免接收到你自己活动的邮件通知。 首选项o 隐藏我的邮件地址如果选中，那么在显示你个人信息的页面将不会显示你的邮件地址。o 时区用于设置你所在的时区，以便更好显示你的活动时间。o 显示注释用于设置注释显示的顺序。 按时间顺序

4、此时问题(issues)的历史记录按照时间顺序显示，即先提交的comments显示在前面，具体可参见下面的截图。 按时间顺序（倒序）此时问题(issues)的历史记录按照时间顺序倒序显示，即先提交的comments显示在后面，具体可参见下面的截图。按时间顺序按时间顺序（倒序）忘记密码如果你忘记了密码,可用点击登录界面上的忘记密码链接, 然后填入你的邮箱地址, 点击提交。 随后你将收到一封邮件, 点击该邮件里的那个超链接, 你将跳到一个修改用户密码的界面, 输入新密码以及确认密码。 这样, 你就可以用刚才新建的密码登录系统了。Note 管理员可以禁用该功能 如果你的账号使用了外部认证(如LDAP

5、),同样不能使用该功能。 因为外部认证的密码存储在LDAP中, Redmine不能修改LDAP里的信息。注册点击主页右上角的注册链接, 用户可以自己注册。 填写好表单提交后你将收到一封激活账号的邮件, 通过邮件里的链接, 可以激活你刚注册的账号。Note 该功能需要管理员开启允许自注册功能, 并选择通过邮件激活账号我的工作台点击主页左上角的我的工作台链接，页面将跳转的当前用户的工作台。我的工作台截图该页面用于显示你所参与的项目的各种信息块。 默认情况下只有下面两个模块启用： 指派给我的问题提供一个跨项目的指派给当前用户的问题列表，显示问题的ID，项目，跟踪标签类型和主题。 已报告的问题提供一个

6、跨项目的由当前用户报告的问题列表，显示问题的ID，项目，跟踪标签类型和主题。Hint群英汇为我的工作台添加了任务日程安排模块，同时修改了默认的布局： 上面：任务日程安排 左边：跟踪的问题 右边：已报告的问题当指派给你的问题太多时，指派给我的问题区域中的问题显得杂乱无章，从而令你不知从哪一个问题先下手。此时的你或许会想起了Mylyn（主要用于管理你的任务，设置日程安排）：如果Redmine有Mylyn的功能，那么我的工作就井井有条了。群英汇为Redmine添加的Mylyn日程安排功能，正是在这种呼声中诞生的。该功能主要借鉴于Mylyn，因此如果你使用过Mylyn，那么你将会很熟悉该功能。功能介绍

7、： 该模块会显示从当前日期开始一周的每一天以及本周(从本周一到本周日)、下周(从下周一到下周日)、下下周(从下下周一到下下周日)、未来（下下周以后）和None(没有设置计划日期的任务将显示在该组)这些组。 如果该组没有安排任务，则不会显示。 当前日期（今天）那一组不仅仅只显示规划到今天的任务，而且还会显示那些已经超过完成日期而未完成的任务（并用红色圆圈叹号图标标识）, 以及那些已经超过计划日期而未完成任务（并用黄色三角叹号图标标识） 同时对于那些计划日期设置在完成日期之后的任务，在分组时以完成日期为标准。操作说明：在None组中选择某一问题或者多个问题（注意多个问题要在同一个项目，否则将会操作

8、失败。因为Redmine目前还不支持跨项目批量修改问题），点击鼠标右键，在弹出菜单中选择计划日期选项，进而在二级菜单中设置计划日期。如果设置成功，系统提示更新成功，而且点击所设置的计划日期组，会发现该组多了一个任务，如下图红色方框圈中的内容。同时，在项目的问题列表页面，如果该问题指派给你，那么当你点击鼠标右键时，在弹出菜单中会多出设置计划日期的选项。否则不会显示该选项。每一个用户可以通过点击个性化定制本页的链接，进入我的工作台设置界面。在我的工作台模块下拉框中选择想要添加的模块，然后点击右侧的新增链接，完成模块添加。同时在该页面可以通过拖拽，改变各个模块的布局。最后别忘了点击右侧的返回链接退出

9、自定义模式，Redmine将自动保存当前的布局。下拉框中可选的模块有： 日历提供一个跨项目的每周日历概述 文档提供一个跨项目的最近文档概述 最近的新闻提供一个跨项目的最近新闻概述 耗时提供一个跨项目的关于当前用户最近7天工时的概述 跟踪的问题提供一个跨项目的由当前用户跟踪的问题列表3登录点击主页右上角的登录链接可跳到登录页面输入登录名和密码, 点击登录按钮, 即可进入系统。Hint单点登录功能群英汇给Redmine添加了单点登录的功能: 该功能主要是省去了多个应用重复输入登录信息的麻烦, 免去了员工记忆多个账号的烦恼。 加上单点登录功能之后, 在一个应用中登录之后, 不用再次输入登录名和密码就

10、可以访问其他应用程序了 (前提是你的所有应用都支持单点登录)。这样在一定程度上减少了密码的暴露几率, 提高了账号的安全性。4注册Hint群英汇集中管理平台，使用统一的用户注册平台群英汇的集中管理平台，包含用户注册和帐号管理功能，和集中管理平台整合的应用需关闭用户注册功能。即群英汇部署的 Redmine，用户注册将跳转到集中管理平台。如果管理员开启用户自注册， 则允许用户在集中管理平台进行自注册，否则需要由管理员统一创建用户帐号。下面是 Redmine 内置的用户注册界面，该操作需要管理员开启允许用户注册的功能。注册截图注册用户需要填写的字段包括: 登录名, 密码, 名字, 姓氏和邮箱, 以及可

11、选的用户语言字段。注册流程根据管理员的设置, 用户的账号由以下几种激活方式: 通过邮件认证激活账号用户注册后, 将收到一封激活账号的邮件, 通过点击邮件里的链接, 就可以激活刚注册的邮件。 手动激活账号用户注册后, 需要等待管理员手动激活刚注册的账号。 自动激活账号用户注册后, 直接可以用刚才注册的账号登录系统。5项目概述项目概述截图该页面提供一个关于该项目的总体概述 左上角的问题跟踪区域列出了目前项中每一种问题跟踪标签的打开数量以及总共数量 在成员区域列出该项目组的所有成员 在最新新闻区域列出了项目的最新新闻6项目活动项目活动截图该页面列出了该项目所有活动的历史记录, 这些活动包括: 问题

12、变更 新闻 文档 文件 Wiki编辑记录 帖子 耗时该页面的右边栏允许你选择具体显示哪类活动如果你想要同时显示子项目的活动, 那么你需要选种子项目复选框。Hint修改查看项目活动的基准时间Redmine 将当天的日期作为显示项目活动的基准时间, 当你点击活动选项卡时, 它会显示前30天到当天的活动。这样会出现一个问题: 当项目连续30天没有活动时, 项目活动首页会出现空白页。群英汇的修改: 将最后一次活动时间作为基准时间, 这样就避免了上述问题的发生。7问题跟踪问题是Redmine的核心业务。 一个问题绑定到一个项目, 由某一用户创建, 可以关联到某一版本, 等等。 查看某一问题在问题列表页面

13、点击某一问题的链接, 可以查看该问题的具体描述。 子任务该功能在版本引入。可以将一个问题拆分为若干个子问题。在使用redmine的过程中，可能有的用户会抱怨，只能将问题指派给一个项目成员，而不能指派给多个项目成员共同完成。出现这种问题，从某种程度上来说，应该是你划分问题/任务过于粗糙（粒度过大），因此子任务功能就是为用户提供拆分问题/任务的操作，从另一方面解决了将一个问题/任务指派给多人。首先需要在角色和权限设置中为某些角色开启管理子任务功能，这样该角色的用户才有创建子任务的权力。操作步骤：o 点击某一问题，进入问题查看页面。然后点击子任务区域的新增链接，进入新建子任务页面。o 父任务字段的值

14、系统自动获得，其他字段像创建问题一样输入，最后点击保存。输入问题的描述信息成功创建子任务 相关的问题允许开发者将某一问题与其他问题建立关联, 从而起到了删除重复问题, 简化工作流的作用。 当前版本允许建立的关联类型有: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天。点击问题显示页面相关问题区域的新增链接,

15、可根据具体的情况建立不同类型的问题关联。管理员可以定义添加和修改问题关联的权限 跟踪者点击问题显示页面跟踪者区域的新增链接, 在下拉列表里选择跟踪者管理员可以定义添加和删除跟踪者的权限 相关修订当提交代码时在提交注释中引用某一问题, 那么稍后将会在该问题的显示页面中出现对于该次提交的描述信息。相关修订截图具体那些使用那些关键字, 可以咨询你们的管理员, 看他是如何配置的。 新建问题要创建新的问题, 你需要有新建问题的权限创建问题时, 最重要的字段是跟踪标签字段, 它决定了问题的类型。默认情况下, Redmine有三种跟踪标签:o 缺陷o 功能o 支持 更新已经存在的问题要更新问题的属性, 你需

16、要有编辑问题的权限。问题列表 概述点击问题选项卡, 默认你将看到该项目中所有处于打开状态的问题。 过滤器的应用默认情况下, 问题列表显示了所有处于打开状态的问题。 你可以添加过滤器, 点击应用链接刷新问题列表, 点击清除链接删除设置的滤器。你可以通过点击那个小+号按钮, 为过滤器字段选择多个值。 这时会出现一个选择列表, 按住ctrl后, 可选择多个值。 自定义查询当刷新页面后, 刚设置的过滤器就会消失, 你可以通过点击保存链接保存你设置的过滤器, 从而建立自定义查询。在新建自定义查询的界面输入自定义查询的名称, 以及过滤器和其他属性的设置。点击保存之后, 新建的自定义查询将会出现在问题列表界

17、面的右边栏中。 快捷菜单在问题列表的某一个问题上, 点击鼠标右键, 将弹出一个快捷菜单, 用于便捷编辑问题。快捷菜单包含的选项有:o 编辑o 状态o 跟踪标签o 优先级o 目标版本o 指派给o 完成度o 登记工时o 跟踪者o 副本o 复制o 移动o 删除 批量编辑问题在问题列表界面, 你可以通过选择多个复选框, 也可以按住ctrl键的同时选择多个问题, 然后点击右键, 同样会弹出一个快捷菜单, 可以对选中的多个问题同时编辑。 你也可以点击复选框上面的那个对号图标, 全选问题或则撤销全选。 边栏问题列表的右侧边栏提供了几种不同的功能链接:o 问题区域 查看所有问题该链接用于从自定义查询页面跳回问

18、题列表页面 摘要从项目级别上查看问题的概述 日历日历上显示问题以及目标版本, 用于把握项目的进度。 甘特图显示问题与时间的的二维图表, 从而清晰地展现了项目的进度与当前的主要任务。o 自定义查询区域 (如果你建立了自定义查询)该区域列出了所有自定义查询的链接路线图路线图提供了一个更高级别的基于项目版本的对于整个问题跟踪系统的概述, 它可以帮助制定项目计划, 管理项目开发。 概述点击路线图选项卡, 你就可以查看当前项目的进展状态:o 版本名称o 版本的完成日期o 进度条根据问题状态所占的百分比(即问题的完成度), 统计出目标版本的完成度。o 目标版本相关连的问题列表 管理路线图如果你的权限合适,

19、 你可以为版本添加一个wiki页面(参考项目版本), 用于描述当前版本的一些主要事件。 边栏路线图页面的右边栏为你提供了以下功能:o 可以根据需要, 选择路线图上显示哪些跟踪标签。o 可以根据需要, 选择是否显示已经完成的版本o 所有版本的链接版本概述版本概述提供了一个详细的关于当前版本的状态描述。 包括: 版本名称 版本完成时间 版本的进度条 wiki(如果管理员配置了wiki页面) 相关的问题列表 时间跟踪区域o 预期时间o 耗时 分组显示区域可供分组显示问题的选项有:o 类别o 跟踪标签o 优先级o 作者o 指派给日历 概述在问题列表页面, 点击右边栏的日历链接, 即可进入日历界面。日历

20、提供了一个按月份显示的项目预览。 在这里你可以看到一个任务状态的起止日期。 过滤器像Redmine提供的其他视图一样, 你可以通过设置过滤器从而决定日历图上显示的内容。过滤器的用法可以参见过滤器甘特图在问题列表页面, 点击右边栏的甘特图链接, 即可进入甘特图界面。甘特图显示问题的起止日期以及版本的截至日期甘特图截图8实时跟踪实时跟踪允许你跟踪解决某一具体问题所花费的时间。 通过填写预期时间, 项目经理可以根据你的进度更好地制定项目计划。 同时实时跟踪与项目成员建立了关联, 从而有效的度量了每个成员的工作情况。 给问题登记工时通过点击问题浏览页面上登记工时的链接, 可以给该问题登记工时。预计耗时

21、字段可填入的时间格式如下:o 整数格式的小时和分钟: 1, 1h, 1hour, 2hours, 30m, 30min, 1h30, 1h30m, 1:30o 小数格式的小时: 1,5(等于1h30)你也可以在更新问题时填入工时 项目级别的登记工时如果登记工时时问题字段为空, 那么该工时就属于整个项目的工时。9新闻在新闻选项卡下, 你可以发布关于项目的新闻条目, 甚至任何你喜欢的新闻条目。新闻条目包含的字段有: 标题 概述概述将和标题一起被显示在项目概述页面的最近新闻部分, 而详细信息只有点击了该新闻条目时才能看到。 详细信息如果你有创建新闻的权限, 那么你就可以添加/编辑/删除新闻。10文档

22、在这里可以书写不同类型的文档, 默认有两种文档类型: 用户文档 技术文档管理员可以添加文档类型11文件在这里可以上传项目需要用到的其他资源, 如图片, 视频等等。12讨论区讨论区给项目成员之间提供一个交流的平台。 管理员根据需要可以创建不同类别的讨论区。 讨论区列表页面显示的内容:o 话题的总数o 留言的总数o 最后留言的链接 发起一个话题点击右上角的新贴链接, 进入新建贴子的页面, 输入主题和内容, 点击创建按钮, 一个新的话题就发起了。话题有两个可选选项:o 置顶(sticky): 如果选中, 表示该话题将会在讨论区列表置顶, 并加粗显示o 锁定(locked): 如果选中, 表示该贴不允

23、许用户跟贴13Wikis 创建一个新的Wiki页面在任何一个wiki页面，仅仅需要添加一个你想要创建的新页面的链接。MyNewPage保存当前页面，点击刚添加的链接，恭喜：你已经成功创建了一个名为MyNewWikiPage的新页面。 保护wiki页面如果你拥有保护wiki页面的权限，你可以点击锁定链接保护该Wiki页面。已经锁定的wiki页面只允许拥有保护wiki页面权限的用户编辑。拥有此权限的用户同样可以为该页面解锁。 Wiki页面的历史Redmine保存每一次wiki页面的改动历史。 通过点击历史链接你可以浏览这些变更。点击变更的序列号可查看某一个具体版本的页面信息。你可以通过点击回退到这

24、个版本的链接回退该页面到先前的版本。14Redmine wiki的文本格式Redmine默认使用Textile作为wiki的文本格式过滤器, 当然你也可以下载其他文本格式过滤器插件(Markdown, reST等)。 以下介绍的语法都是基于Textile。链接Redmine链接Redmine允许在任何wiki文本格式里引用问题，变更集和wiki页面的超链接。 链接到问题: #124 (显示为#124, 如果此问题已经关闭则显示删除线)。 链接到变更集: r758 (显示为r758)。 使用非数字的哈希值链接到变更集: commit:c6f4d0fd(显示c6f4d0fd)。wiki链接 Gui

25、de 显示一个链接到Guide的链接: Guide Guide|Use manual 显示指向同一页面的链接，链接显示的文本是: Use manual Guide#Use-guide|Use guide 显示指向同一页面头的链接，链接显示的文本是: Use guide可以加入指向其它项目wiki页面的链接 sandbox:some page 显示一个指向Sandbox项目名称为Some page的wiki页面的链接。 sandbox: 显示一个指向Sandbox项目Wiki主页面的链接。如果Wiki页面不存在，则连接将显示为红色。链接到其他资源 文档o document#17 (链接到ID为1

26、7的文档）o document:Geetings (链接到标题为Geetings的文档）o document:Some document (当文档标题含有空格时需要使用双引号） 版本o vesion#3 (链接到ID为3的版本)o vesion: (链接到名称为的版本)o vesion: beta 2 (当版本名称含有空格时需要使用双引号) 附件o attachment: (链接到当前页面名称为 的附件)o 到目前为止, 只能引用当前页面的附件(如果您在编辑问题，则只能引用此问题的附件) 版本库o souce:some/file 链接到项目版本库的 /some/file 文件o souce:s

27、ome/file52 链接到项目版本库 /some/file 文件的第52版本o souce:some/file#L120 链接到项目版本库 /some/file 文件的第120行o souce:some/file52#L120 链接到项目版本库 /some/file 文件的第52版本的第120行o souce:somefile52#L120 如果URL中有空格，需要使用双引号来。链接到项目版本库 some file 文件的第52版本的第120行o expot:some/file 强制显示该文件的下载链接转意字符如果您不希望Redmine将上述标记解释为链接，可以在它们前面添加一个感叹号：!外

28、部链接HTTP URLs和邮件地址将自动转换为可点击的链接如果你想指定链接显示的文本,你可以使用标准的textile语法。群英汇文本格式对于标题、粗体、表格、列表, Redmine支持Textile语法。参考上对使用这些特征的详细信息。下面列出一些例子:字体样式*bold* 加粗_italic_ 斜体*_bold italic_* 加粗并斜体+underline+ 下划线-strike-through- 删除线内嵌图片 !image_url! 显示地址为image_url的图片(textile语法) !image_url! 图片右悬浮 !width:300pximage_url! 设置图片的显示宽度如果你的wiki页面有图片附件,你可以使用文件名:!显示它。标题 h1. 一级标题 h2. 二级标题 h3. 三级标题段落 p. 右对齐 p=. 居中块引用段落以 bq. 开始无序列表* Item 1* It