Trac
跳到导航
跳到搜索
Trac是一套问题追踪系统（英语：Issue tracking system）。
简介
优点
- 简单，专注在事情的记录上，而不是限制行为上。
缺点
- 目前还是不支援Python 3。
安装
用pip安装以下套件：
pip install Trac
pip install Pygments
pip install mysql-python
使用MySQL作为后端数据库时，建议用utf8mb4作为基础，这样数据库可以存所有范围的Unicode字元[1]：
CREATE DATABASE trac DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
目前有安装的
除了基本安装外，还会安装这些套件：
- GraphvizPlugin – Trac Hacks - Plugins Macros etc.
- Graphviz可以拿来画各类图，我自己最常用的是Dot图。
- SubticketsPlugin – Trac Hacks - Plugins Macros etc.
- 子母票的延伸套件，基本上是必备项目。
- TracCronPlugin – Trac Hacks - Plugins Macros etc.
- 定时跑任务，但其实没很好用... 目前主要是拿来每天寄信通知有哪些票过期。
- TracDragDropPlugin – Trac Hacks - Plugins Macros etc.
- 拖拉就可以上传附件的套件。
- TracWysiwygPlugin – Trac Hacks - Plugins Macros etc.
- 可以针对Textarea区块使用WYSIWYG界面，对于非技术类的使用者来说会方便不少（因为不需要学Trac的Wiki语法）。另外有不少文件可以直接剪下贴上（虽然还是会掉不少效果，但比起完全不能剪下贴上来说已经方便不少）。
- XmlRpcPlugin – Trac Hacks - Plugins Macros etc.
- 让使用者可以透过API操作Trac。
以前有安装的
以前会安装，但现在因为自己用而没有装上：
- gslin/trac-addtocc-plugin: Add participator to cc list automatically.
- 自动把参与者加到Cc列表内，这样才会收到后续的更新。
- AutocompleteUsersPlugin – Trac Hacks - Plugins Macros etc.
- 让使用者账号名称可以autocomplete，在Cc字段与Owner字段会很好用。
- DefaultCcPlugin – Trac Hacks - Plugins Macros etc.
- 针对不同的Component自动加上Cc列表。
- 对于企业内还蛮有用的。像是专案可以开
Proj.开头的Component，而组织可以开Org.开头的Component，这些类型可以设定对应的Cc列表。
- gslin/trac-secret-checkbox-ticket: Add ticket security policy for Trac.
- 将票设定为秘密，只有Reporter（开票人）、Owner（目前有票的人）、Cc列表内的人可以读。
- 这对于企业内有些需求很好用（像是还在进行中的计划，或是一些不会对全公司公开的数据）。
看到的
看过但还没用过的：
- AccountManagerPlugin – Trac Hacks - Plugins Macros etc.
- 说明提到可以吃HTML Form Login，而不局限在HTTP authentication。
设定
trac.ini
让系统吃code.jquery.com所提供的jQuery以及jQuery UI[2]，稍微降低服务器的负载，另外也有机会与外部网站共用cache：
[trac]
jquery_location = https://code.jquery.com/jquery-1.12.4.min.js
jquery_ui_location = https://code.jquery.com/ui/1.12.1/jquery-ui.min.js
jquery_ui_theme_location = https://code.jquery.com/ui/1.12.1/themes/start/jquery-ui.css
site.html
在templates/site.html里做了一些事情进行客制化。
CSS
- 全部使用sans-serif字型。
- 修正button因为CSS效果而有时会按不到的问题。
- 针对今天到期与过期的票用不同的标示标出（配合下方的JavaScript）。
- 将已经关掉的票变淡（配合下方的JavaScript）。
- 让编辑区域使用等宽字型。
- 让可用范围变宽。
<style type="text/css">
<!--
body, th, tr {
font-family: sans-serif;
}
input[type=button]:active, input[type=submit]:active,
input[type=reset]:active {
position: relative;
top: 0;
left: 0;
}
table.tickets tr.duedate_overdue {
font-weight: bold;
}
table.tickets tr.duedate_today {
border: 2px solid;
}
table.subtickets tr.ticket_closed, .closed.ticket {
opacity: 0.5;
}
textarea {
font-family: monospace;
}
#content.ticket {
width: 78em;
}
-->
</style>
JavaScript
- 用JavaScript针对今天到期以及过期的票增加CSS。
- 将新票里的Due Date改为零点零分零秒。
- 将票里的attachments与modify内容展开。
- 将日历选择器中，关闭动画效果[3]，另外将每周的第一天设为星期天[3]，并且允许选择其他月份的日期[3]。
在head的地方先加入strftime套件，后面会用到：
<script src="https://cdn.jsdelivr.net/npm/strftime@0.10.0/strftime.min.js"></script>
<script>
<!--
// Run immediately.
(function($) {
// Due date css handling
var d = new Date();
var today = (new Date(d.getTime() - d.getTimezoneOffset() * 60000)).toISOString().slice(0, 10);
document.querySelectorAll('table.tickets td.due_date').forEach(function(el) {
var due = el.innerText.trim();
if (due < today) {
el.parentElement.classList.add('duedate_overdue');
} else if (due === today) {
el.parentElement.classList.add('duedate_today');
}
});
// Due date (newticket) set to 00:00:00 (in UTC)
if ($('form[action$="/newticket#ticket"]').length > 0) {
do {
let el = $('#field-due_date');
let t = el.val();
if ('Z' === t.slice(-1)) {
console.log(t);
t = new Date(Date.parse(t) + 86400000);
t = strftime('%Y-%m-%dT00:00:00Z', t);
el.val(t);
break;
}
let a = t.match(/\+(\d\d:\d\d)$/);
if (null !== a) {
let tz = a[1];
let new_str = 'T' + tz + ':00+' + tz;
t = new Date(Date.parse(t) + 86400000);
t = strftime('%Y-%m-%d' + new_str, t);
el.val(t);
break;
}
} while (false);
}
// Closed tickets handling
$('tr:has(a.closed)').addClass('ticket_closed');
})(jQuery);
// Run after content loaded.
jQuery(function() {
// Layout
jQuery('#attachments').removeClass('collapsed');
jQuery('#modify').parent().removeClass('collapsed');
// Datepicker
if ($.datepicker) {
$.datepicker.setDefaults({
firstDay: 0,
selectOtherMonths: true,
showAnim: '',
showOtherMonths: true
});
}
});
//-->
</script>
参考资料
- ↑ MySqlDb – The Trac Project. [2018-03-01].
- ↑ TracIni – The Trac Project. [2018-02-28].
- ↑ 3.0 3.1 3.2 Datepicker Widget | jQuery UI API Documentation. [2018-02-28].