Trac

来自Gea-Suan Lin's Wiki
Gslin（讨论 | 贡献）2018年11月27日 (二) 03:00的版本 （→‎目前有安裝的）
跳到导航 跳到搜索

Trac是一套问题追踪系统（英语：Issue tracking system）。

简介

优点

  • 简单，专注在事情的记录上，而不是限制行为上。

缺点

  • 目前还是不支援Python 3。

安装

我是将Python装在www-data这个使用者的pyenv里面（权限会是www-data:www-data）。在装完Python后，用pip安装以下套件： 

$ pip install Trac
$ pip install ​Pygments
$ pip install mysql-python

使用MySQL作为后端资料库时，建议用utf8mb4作为基础，这样资料库可以存所有范围的Unicode字元[1]，另外建立独立的使用者供Trac使用： 

CREATE DATABASE trac DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
GRANT ALL ON trac.* TO `trac`@`localhost` IDENTIFIED BY 'password_here';

这样在安装Trac时的连线设定会是mysql://trac:password_here@localhost/trac（需要自己修改对应栏位）。

在安装套件时，软体本体常常会放在Subversion的伺服器内，在透过pip或是easy_install时会呼叫Subversion，所以会需要安装对应的软体： 

# apt install subversion

另外要建立目录，并且让Trac可以写入： 

# mkdir trac/files
# chown www-data:www-data trac/files

然后是Trac的FastCGI档案，放在Trac的project目录下，并且用chmod 755 trac.fcgi改成可执行： 

#!/usr/bin/env python

import os
from trac.web.main import dispatch_request
import trac.web._fcgi

num = 2
sockaddr = '/var/run/trac/trac.sock'
os.environ['TRAC_ENV'] = os.path.dirname(__file__)

fcgiserv = trac.web._fcgi.WSGIServer(dispatch_request, bindAddress = sockaddr, umask = 7)

num -= 1
while num > 0:
    num -= 1
    if 0 == os.fork():
        break

fcgiserv.run()

另外Systemd的设定档让Trac在开机时以FastCGI模式跑起来，这个档案放在/lib/systemd/system/rsyslog.service并连结到/etc/systemd/system/multi-user.target.wants/trac.service下（要记得把里面的/srv/trac.example.com/trac/改成自己的目录： 

[Unit]
Description=trac fcgi daemon

[Service]
Type=simple
ExecStartPre=/bin/sh -c "/bin/mkdir -p /var/run/trac; /bin/chown www-data:www-data /var/run/trac; /bin/chmod 0755 /var/run/trac"
ExecStart=/bin/su - www-data -c "exec /srv/trac.example.com/trac/trac.fcgi"

[Install]
WantedBy=multi-user.target

目前有安装的

除了基本安装外，还会安装这些套件：

目前Trac 1.2版的安装方式是： 

#!/bin/bash
pip install TracAccountManager
pip install svn+https://trac-hacks.org/svn/duplicateticketsearchplugin/trunk/
pip install svn+https://trac-hacks.org/svn/graphvizplugin/branches/1.2/
pip install svn+https://trac-hacks.org/svn/httpauthplugin/trunk/
pip install git+https://github.com/trac-hacks/trac-subtickets-plugin.git
pip install TracCronPlugin
pip install svn+https://trac-hacks.org/svn/tracwysiwygplugin/0.12/
pip install TracXMLRPC

以前有安装的

以前会安装，但现在因为自己用而没有装上（没有需求或是不想装）：

设定

权限

Trac预设的权限设定过于严格，只给内部使用的情境下，建议对authenticated群组加上：

  • TICKET_EDIT_CC
  • TICKET_EDIT_DESCRIPTION

trac.ini

我自己的Report不想分页（预设是一页100笔），所以设为： 

[report]
items_per_page = 0

让系统吃code.jquery.com所提供的jQuery以及jQuery UI[2]，稍微降低伺服器的负载，另外也有机会与外部网站共用cache。目前的Trac 1.2.2版本可以这样设： 

[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

另外因为我们不太用Trac内建的Wiki，但又关不掉，所以只能针对没找到的页面就不要产生连结了： 

[wiki]
ignore_missing_pages = enabled

site.html

在templates/site.html里做了一些事情进行客制化。

对于外部引用，不要 泄漏Referrer： 

<head>
    <meta name="referrer" content="no-referrer" />
    ...
</head>

CSS

  • 全部使用sans-serif字型。
  • 修正button因为CSS效果而有时会按不到的问题。
  • 针对code block内一行过长时自动换行。
  • 针对今天到期与过期的票用不同的标示标出（配合下方的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;
    }
    pre {
        white-space: pre-wrap;
    }
    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;
    }
    #main img {
        max-width: 100%;
    }
    -->
    </style>

JavaScript

  • 用JavaScript针对今天到期以及过期的票增加CSS。
  • 将新票里的Due Date改为零点零分零秒。
  • 增加button，让关票可以直接点击。
  • 将票里的attachments与modify内容展开。
  • 将开票人的资讯放到Action栏位里，比较好确认这张票的情况。
  • 将日历选择器中，关闭动画效果[3]，另外将每周的第一天设为星期天[3]，并且允许选择其他月份的日期[3]。

在head的地方先加入strftime套件，后面会用到： 

    <script src="https://cdn.jsdelivr.net/npm/strftime@0.10.0/strftime.min.js"></script>

这段程式码则会放在</body>结尾前： 

    <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);
        }

        // Accept & start buttons
        $('#action_accept, #action_start').each(function(){
            var v = $(this).val();

            var that = this;
            var b = $('<button/>').click(function(e){
                var v = $(this).val();
                $(that).click();
                $('#propertyform input[name="submit"]').click();
                e.preventDefault();
            });
            b.attr('value', v).text(v);

            $(this).closest('div').append(b);
        });

        // Resolve with Buttons
        $('#action_resolve_resolve_resolution option').each(function(){
            var v = $(this).val();

            var b = $('<button/>').click( function(e){
                var v = $(this).val();
                $('#action_resolve').click();
                $('#action_resolve_resolve_resolution').attr('disabled', false);
                $('#action_resolve_resolve_resolution').find('option[value="' + v + '"]').attr('selected', 'selected');
                $('#propertyform input[name="submit"]').click();
                e.preventDefault();
            });
            b.attr('value', v).text(v);

            $(this).closest('div').append(b);
        });

        // Closed tickets handling
        $('tr:has(a.closed)').addClass('ticket_closed');

        // Copy reporter information to action section
        if ($('#action_resolve_resolve_resolution').length > 0) {
            var reporter = $('#h_reporter').parent().find('.trac-author, .trac-author-user')[0].outerHTML;

            $('#action_resolve_resolve_resolution').each(function(){
                $(this).parent().append('<span class="hint">(This ticket is created by ' + reporter + ')</span>');
            });
        }
    })(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>

其他

删除使用者时可能会需要手动到以下表格清除资料（清完后需要重跑Trac，因为Trac会读出来cache一份），避免autocomplete之类的套件仍然显示：

  • auth_cookie
  • session
  • session_attribute

著名使用单位

  • Django
  • FFmpeg
  • nginx
  • Tor
  • WebKit
  • WordPress
  • jQuery

相关连结

参考资料

  1. ↑ MySqlDb – The Trac Project. [2018-03-01]. 
  2. ↑ TracIni – The Trac Project. [2018-02-28]. 
  3. ↑ 3.0 3.1 3.2 Datepicker Widget | jQuery UI API Documentation. [2018-02-28]. 

外部连结

取自“https://wiki.gslin.org/index.php?title=Trac&oldid=1069”