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


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

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

動作例:


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

type形式詳細
redmine数字チケットを数値のみで表すシステム全般に利用可能myredmine:123
jira大文字英数-数字JIRAチケット風myjira:BUG-123
gitgit revisiongit 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チケットの前につけるプリフィクス
typeredmine,jira,git のいずれか
titleリンクタイトルの指定 $1 がチケットID を表す
base_url組み合わせるURL

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

補足

  • リンクが有効になるために、前後に半角スペースが必要です。
  • JavaScriptでリンクを生成しています。

関連ページ

コメント



トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2019-03-01 (金) 08:01:43
Site admin: PukiWiki Development Team

PukiWiki 1.5.2+ © 2001-2019 PukiWiki Development Team. Powered by PHP 5.6.40-0+deb8u7. HTML convert time: 0.233 sec.

OSDN