AutoTicketLink

AutoTicketLink: 外部チケットシステムへの自動リンク機能†

AutoTicketLink: 外部チケットシステムへの自動リンク機能

特定のフォーマットで記述した文字列を、外部のチケットシステムへ自動リンクする機能です。InterWiki と違い、角括弧2つ [[ ... ]] でページ名を囲む必要がありません。利用頻度の高いサイトへのリンクを短い文字列で表現できます。

(1) JIRA形式の文字列を自動でリンク
(2) 設定したkeyとチケットIDをコロン(:) で繋いだ文字列

動作例:

(JIRA形式)
- PKW-2484 で https://pukiwiki.osdn.jp/dev/?BugTrack/PKW-2484 へリンク
(key形式)
- phpbug:47689 と書くと https://bugs.php.net/bug.php?id=47689 にリンクされます。(Redmine type)
- pwjira:PKW-2420 JIRA Issue形式のリンク
- pukiwiki-commit:bdd91ef0e3092b4b29 Git revision/commit 形式

key形式に対して用意されているtypeは3種類(redmine,jira,git)です。

type	形式	詳細	例
redmine	数字	チケットを数値のみで表すシステム全般に利用可能	myredmine:123
jira	大文字英数-数字	JIRAチケット風	myjira:BUG-123
git	git revision	git revision8文字以上	commit:bdd91ef0e3

↑

設定方法 (JIRA形式)†

↑

JIRAプロジェクト単位で設定†

AutoTicketLinkName のページを編集し、JIRAサーバー、プロジェクトをリスト形式で設定する

- jira https://pukiwiki.osdn.jp/dev/?BugTrack/
-- PKW PukiWiki issue $1
-- PRJ2 PukiWiki Project2 issue $1
-- PRJ3 PukiWiki Project3 issue $1
- jira https://issues.example.com/
-- BUG Example bug $1

1行目先頭の "jira" は固定。続けてチケットに対するベースURLを記述する。

2行目以降、(JIRA Project key) (タイトル) のように記述する。"$1" は Issue key そのものを表す文字列に置換される。

JIRA URL、プロジェクトはそれぞれ複数設定できる。

Wiki利用ユーザーが編集可能です。（初期状態ではページ凍結されています）

↑

JIRA風の文字列をすべてリンクする†

pukiwiki.ini.php の中の $ticket_jira_default_site の設定を変更する。

// AutoTicketLink - JIRA Default site
$ticket_jira_default_site = array(
       'title' => 'My JIRA - $1',
       'base_url' => 'https://issues.example.com/jira/browse/',
);

PukiWikiの管理者のみ設定可能です。

↑

設定方法 (key形式)†

pukiwiki.ini.php で $ticket_link_sites に各チケットシステムの情報を設定する。

/////////////////////////////////////////////////
// AutoTicketLink
$ticket_link_sites = array(
	array(
		'key' => 'phpbug',
		'type' => 'redmine', // type: redmine, jira or git
		'title' => 'PHP :: Bug #$1',
		'base_url' => 'https://bugs.php.net/bug.php?id=',
	),
	array(
		'key' => 'asfjira',
		'type' => 'jira',
		'title' => 'ASF JIRA [$1]',
		'base_url' => 'https://issues.apache.org/jira/browse/',
	),
	array(
		'key' => 'pukiwiki-commit',
		'type' => 'git',
		'title' => 'PukiWiki revision $1',
		'base_url' => 'https://ja.osdn.net/projects/pukiwiki/scm/git/pukiwiki/commits/',
	),
);

設定項目	説明	備考
key	チケットの前につけるプリフィクス
type	redmine,jira,git のいずれか
title	リンクタイトルの指定 $1 がチケットID を表す
base_url	組み合わせるURL