연관글 : 2010/02/22 - Trac GanttCalendarPlugin 0.2 한글화 / 커스터마이징 / i18n (종료)

관련링크 : http://sourceforge.jp/projects/shibuya-trac/wiki/plugins%2FReportIncludePlugin (Browse SVN)
            http://d.hatena.ne.jp/Hirohiro/20090725/1248540577

참고링크 : http://dev.ariel-networks.com/column/tech/tracreport-tips

-- 2010.8.12 추가 : Trac 0.12 용 스크린 샷 으로 변경 함.

사용자 삽입 이미지


wiki 페이지에 Trac 리포트 내용을 그래프로 표시(Include)해주는 플러그인으로

UI 없이 wiki 매크로로 작동하기 때문에 별도 한글화 작업은 필요하지 않습니다.

그러나, 일본어 원본 소스를 설치하게 되면 리포트에서 데이터를 읽어올 때
영어 필드명은 문제가 없으나 한글 필드명이 존재하면 유니코드 에러가 발생합니다.

한글 관련 유니코드 에러를 패치하고 에러 메시지와 소스 주석 한글화 및 커스터마이징을 하였습니다.

-- 2010.8.12 추가 : Trac 0.12 에서 작동하도록 패치 함. (Trac 0.12 용 예외처리 루틴 추가 함)
-- 2011.2.6 추가 : 권한 설정 기능 추가 및 설치 스크립트 정보 수정 함.

reportincludeplugin-r549-ko-customize.11.02.06.zip



리포트 인클루드 플러그인을 다운로드 받아 압축을 해제한 후 아래와 같은 방법으로 설치합니다.
python setup.py install


사용 방법은 원 저작권자의 설명이 담긴 일본어 wiki 페이지를 구글 번역으로 읽어도 충분히 이해가 됩니다.

관련링크 : 리포트 인클루드 wiki 매크로 사용 방법 (구글 번역)


Trac 리포트 예제는 아래 링크의 SQL 을 참고하세요. (사용하는 DB와 Trac 버전에 맞게 SQL 을 수정해야 함)

참고링크 : Trac 리포트 sqlite SQL 예제 (구글 번역)


Trac 0.12 환경에서는 위 설명 내용 중 SQL 쿼리문 (timestamp 관련 필드를 조작하는 date, strftime 함수 내용)을
아래와 같은 방법으로 수정해야 합니다.
date(time, 'unixepoch')   ->   date(time/1000000, 'unixepoch')
strftime('%Y/%m', time, 'unixepoch')   ->   strftime('%Y/%m', time/1000000, 'unixepoch')


리포트 인클루드 플러그인에서 표시해주는 그래프를 보려면 기본적으로 REPORT_VIEW 권한을 필요로 합니다.
(리포트를 읽어 그래프로 대신 표시해 주기 때문에 WIKI_VIEW 권한이 아니라 REPORT_VIEW 권한을 요구합니다.)

REPORT_VIEW 권한 없이 해당 wiki 페이지를 열게되면 에러 메시지 없이 아무 것도 표시 되지 않습니다.

-- 2011.2.6 추가 : 권한 설정 기능 관련 내용 추가 함.

기존에 TICKET_VIEW 나 WIKI_VIEW 정도로 권한을 낮춰주려면, 소스 파일을 직접 수정해야 하였으나
trac.ini 파일 수정만으로 쉽게 권한을 변경할 수 있도록 기능을 추가하였습니다.

사용자 삽입 이미지



- 주의사항

  . 리포트 인클루드 플러그인 한국어 커스터마이즈 버전은 Trac 0.11 용 으로 개발 되었습니다.
    (Trac 0.12 를 지원하지 않아 개인적으로 패치하였기에, Trac 0.12 에서 항상 정상 작동함을 보장하지 않습니다.)

  . 해당 플러그인을 제대로 활용하기 위해서는 wiki 포맷팅wiki 매크로에 대한 이해와 함께
    Trac 리포트의 구조, Trac 시스템 테이블 구조에 대한 이해 및 SQL 쿼리문 작성 능력을 필요로합니다.

    비 개발자가 사용하기에는 비교적 난이도가 높은 편 입니다.


- 제한사항

  . 해당 플러그인은 Shibuya.trac project 에서 개발 중인 결과물로 부터 파생되었습니다. - New BSD License

    버그 패치와 기능 개선 차원으로 시작한 개발인지라 프로젝트를 별도로 Fork 할 의사는 없습니다.
    원 저작권자의 노고에 감사 드리며 원 저작권자의 라이선스인 New BSD License 를 그대로 따릅니다.

    (New BSD License: 사용자의 자유로운 사용/수정/배포 보장, 수정된 소스코드 공개 의무 없음, GPL-compatible)

  . 본 소프트웨어 사용 여부는 사용자 본인의 책임 하에 판단해 주십시오.
    이 플러그인에 의해 발생하는 어떠한 장해나 손해에 대해 작성자는 책임을 지지 않습니다.

자료를 퍼가실 때는 반드시 출처를 표시해 주세요

Posted by Genie.
,