コグノスケ

未来から過去へ表示(*) link

過去から未来へ表示

もっと前

2008年2月6日 >>> 2008年2月6日

もっと後

2008年2月6日

permalink

編集する

PukiWikiのrelatedプラグインの謎

目次: 自宅サーバー

PukiWiki 1.4.7に関連するページへのリンクを表示するrelatedというプラグインがあります。リンクには二種類あって、

対象となるページにあるリンク（以降、順リンク）
対象となるページをリンクしたページへのリンク（以降、逆リンク）

が表示されるようになっています。

PukiWikiの編集時にブロック型プラグイン形式 #relatedか、index.php?plugin=related&page=PageNameのように（便宜的に直起動と呼ぶ）してpluginを呼び出すことで上記の機能が発動します。

どちらの起動方法でも機能は同じ……そんなふうに考えていた時期が俺にもありました。
バキネタはさておき、relatedプラグインってば直で起動するとブロック型とは別の処理が走ってしまいます。そのせいで順リンクが出ません。なんだこれ。

PukiWikiなんてそこら中で使われてるし、relatedの妙な動きにも誰か気づいていそうなもんですが…、そもそもどちらの動きが正しいんでしょう？それによっては以下のエントリが丸々無駄になる可能性があったりなかったり。

backlinksプラグイン

PukiWikiで「ひらメソッド」をやってみると、ある関数が誰を呼ぶか？という一覧の他に、ある関数が誰から呼ばれ得るか？ってのも知りたくなりませんか？

その手の情報は手動で管理すると死ねるので、逆リンクの一覧をページに埋め込むってのが欲しかったわけです。しかしながら #relatedでは、先述したように順リンクが混ざってうまくないです。

relatedを直すとあちこちに影響が出そうなので、今のところは、以下の図のような対象ページの逆リンクだけをすっぱ抜いてくるbacklinksプラグインを追加して凌いでいます。

backlinks.inc.php


<?php
// PukiWiki - Yet another WikiWikiWeb clone
// Backlinks plugin: Show backlinks for the page

function plugin_backlinks_convert()
{
	global $vars;

	return make_backlinks($vars['page'], 'p');
}

function make_backlinks($page, $tag = '')
{
	global $script, $vars, $rule_related_str, $related_str;
	global $_ul_left_margin, $_ul_margin, $_list_pad_str;

	$links = links_get_related_db($vars['page']);

	if ($tag) {
		ksort($links);
	} else {
		arsort($links);
	}

	$_links = array();
	foreach ($links as $page=>$lastmod) {
		if (check_non_list($page)) continue;

		$r_page   = rawurlencode($page);
		$s_page   = htmlspecialchars($page);
		$passage  = get_passage($lastmod);
		$_links[] = $tag ?
			'<a href="' . $script . '?' . $r_page . '" title="' .
			$s_page . ' ' . $passage . '">' . $s_page . '</a>' :
			'<a href="' . $script . '?' . $r_page . '">' .
			$s_page . '</a>' . $passage;
	}
	if (empty($_links)) return ''; // Nothing

	if ($tag == 'p') { // From the line-head
		$margin = $_ul_left_margin + $_ul_margin;
		$style  = sprintf($_list_pad_str, 1, $margin, $margin);
		$retval =  "\n" . '<ul' . $style . '>' . "\n" .
			'<li>' . join($rule_related_str, $_links) . '</li>' . "\n" .
			'</ul>' . "\n";
	} else if ($tag) {
		$retval = join($rule_related_str, $_links);
	} else {
		$retval = join($related_str, $_links);
	}

	return $retval;
}
?>

PukiWikiのpluginディレクトリにbacklinks.inc.phpという名前で置いて、PukiWikiでページ編集するときに #backlinksと書けば動作するはずです。PukiWikiのコード（make_related関数）をそのままパクッてるんで、ライセンスはGPLです。こんなんで良ければご自由にどうぞ。

編集者:すずき(2024/01/13 17:13)

コメント一覧

IKeJIさん(2008/02/08 10:58)
related は他にもバグがあるんですが、Pukiwikiは死んでるんですかね？
http://pukiwiki.sourceforge.jp/dev/?BugTrack%2F735
すずきさん(2008/02/08 18:22)
＞IKeJI さん
PukiWiki は最近バージョンアップしてないようですし、開発が停滞しているのかも知れないですねえ。
＞他のバグ
ありゃーこれはかなりだめな挙動ですね。直さないのかな。

＃backlinks は大丈夫かな…？ダメだったら直すのメンドクサイなあ。