Trac on Apache - 使用说明

最新推荐文章于 2021-05-14 22:03:45 发布

yidichaxiang

最新推荐文章于 2021-05-14 22:03:45 发布

阅读量3k

点赞数

分类专栏： Windows 开发环境配置文章标签： apache subversion components permissions system plugins

Windows 开发环境配置专栏收录该内容

26 篇文章 0 订阅

订阅专栏

Trac on Apache - 使用说明

以下将会简单介绍 Trac 的使用方式，这里是以 0.10.3 版为基础。另外本文仅供初入门的朋友参考，因为我个人也还在学习中。

操作介面

Trac 主要由四个区块组成：搜寻、使用者工具、功能选单及内容页。

搜寻

这里可以搜寻所有记在 Trac 资料库里的资讯，像是 Wiki 、 Changesets 或 Tickets 等等。

使用者工具

包含登入登出功能、使用者资讯修改介面及求助文档。

功能选单

Trac 主要功能的选单，像是 Wiki 、 Timeline 或 Roadmap 等等。

内容页

上面的使用者工具或是功能选单如果有相关画面的话，就会在这里呈现。

主要功能简述

Trac 的重点在於记录专案相关历程，方便管理者或开发人员追踪之用。以下将对相关的功能做简单的描述。

注：我会简单的以意义而非直译来翻译里面的专有名词，不过可能会和业界所公认的有所不同；如果大家有比较好的建议，欢迎告知。

Wiki

Wiki (记事) 通常是用来记录专案的相关说明，像是开发目的、版本演进说明、程式架构与功能等。 Trac 内建的 Wiki 包含很多实用的功能，像是提供连结到 Milestone 、 Ticket 等相关页面的语法，也可以自行扩充 Marco 与 Processor 。

Wiki 的详细说明可参考 http://trac.edgewall.org/wiki/TracWiki 。

注：在新建每个专案时， Trac 都会自动帮我们建立相关的求助文档，这也是用 TracWiki 制作的。

Timeline

Timeline (历程) 会显示专案所有变动，包含程式码的修改、 Wiki 更新、新增 Ticket 或 Milestone 等。我们可以在其右上方的控制板上选择日期范围或是资讯类型，来显示符合条件的变动。

另外这里的内容是不可更改的，因为它们已经是历史了。

Roadmap

Roadmap (指标) 是 Milestone (里程碑) 的集合体，而 Milestone 也可以是 Ticket (编修项目) 的集合体 (非必要) 。

Roadmap 主要的功能是让管理者很清楚的掌握专案的进度；当所有 Milestone 完成後，专案即宣告结束。

Browse Source

因为我们安装的 Trac 是搭配 Subversion ，因此这里可以直接浏览专案 SVN 档案库里的所有资讯。而且这里也可以简单比对出版本之间的差异；这个功能可以让我们在撰写 ChangeLog 时，直接连结引用。

注： Trac 预设是 UTF-8 编码，所以 Source 里面有用到 Big5 编码的话，在这里会看到乱码。解决的方式是在 trac.ini 里，将 trac 区段的 default_charset 改为 big5 。

View Tickets

依分类列出所有编修项目的报告，这可以方便管理者整理出给客户的报表 (可汇出 CSV 格式的文字档) 。 Trac 已预设提供多个实用的报告类型，不过管理者也可以以 SQLite 的 SQL 语法来建立属於自己的报告类型。

New Ticket

建立一个编修项目，预设有 defect (缺失) 、 enhancement (功能加强) 及 task (工作) 等三种类型。

* defect：就是一般我们所说的 Bug 。

*enhancement：原先没有规划的功能，或是客户建议改进的部份。

* task ：专案中预期应该要制作的项目。

这里的 Full description 可以使用 TracWiki 语法。

而 Ticket 也有以下属性可供设定：

*Priority: 优先顺序，预设为 major 。

*Milestone: 里程碑。

*Component: 所属元件。

*Version: 所属版本。

*Severity: 严重性。

*Keywords: 关键字。

*Assign to: 指定给某使用者。

* Cc: 给某使用者一个副本。

另外最下方我们也可以为这个 Ticket 附加相关的档案。

上方 Search 区块的进阶版，多了 Wiki 、 Changesets 或 Tickets 的勾选项目；这里同时也是呈现搜寻结果的页面。

Admin

在安装 WebAdmin 这个 Plugin 後就会多出来的功能，以下会再深入介绍。

管理项目

在 Admin 功能中，如果有依照前面的步骤安装了 WebAdmin 、 Account Manager 及 IniAdmin 等 Plugin 的话，就会出现以下选单项目：

* Accounts

o Configuration

o Users

* General

o Basic Settings

o Logging

o Permissions

o Plugins

* Ticket System

o Components

o Milestones

o Priorities

o Severities

o Ticket Types

o Versions

* trac.ini

一般来说，在这里调整相关设定後，只需要重新登入即可套用变更的设定。不过其中还是有一些设定需要重新启动 Apache ，请特别小心。

注：这里我会略过 trac.ini ，因为大部份需要调整的部份都已经在上面三个大项里了。

Accounts / Configuration

这里可以设定要存取的 Apache 帐号密码档，即为前一篇里的 D:/Repository/project-users.db 。

Accounts / Users

这里会列出 D:/Repository/project-users.db 里所有使用者的帐号，右边的控制板可以让我们新增使用者。

General / Basic Settings

这里可以设定专案的相关资讯，包含专案名称、网址及简述。

General / Logging

这里可以设定 Trac Log 记录的地方，可以是档案或是 Windows 事件里。这里的设定变更後，需要重新启动 Apache 。

General / Permissions

这里会列出所有使用者的权限，右边的控制板则可以设定使用者的权限，而且也可以新增一个群组或是把使用者加入一个群组。

General / Plugins

这里会列出 Trac 已载入的 Plugins ，在 Plugin 的名称上点一下可看到细部元件的启用状况。

另外可以利用档案上传的方式来安装 Plugin ，这样似乎是仅能让该专案使用，而且可以移除；如果该 Plugin 是利用第一篇提到的方式安装的话，似乎就没办法移除。(这里用「似乎」一词是因为我试过但没成功，还望各位先进指导。)

Ticket System / Components

Components (元件) 会列出专案中会用到的独立元件，像是类别库或 JS 库等等。每个 component 都可以为它们指定一个 owner (拥有者) ，以供开发协调用。任意点选一个 component 的名称後即可修改它，这里的 Description 可以使用 TracWiki 语法。