自作プラグイン/showhtml.inc.php

showhtml.inc.php†

サマリ	PukiWiki内でネットサーフィンプラグイン
リビジョン	1.0
対応バージョン	1.4
投稿者	upk
投稿日	2003-10-28 (TUE) 00:37:14

↑

掲載先†

~~斎藤家のフォルダ~~ 公開停止

↑

PukiWiki内でネットサーフィンプラグイン†

注意:著作権には注意して下さい。利用者の責任でお願いします。

補足

PukiWikiも1.4となり、HTMLを加工して表示する関係で、構文を大きく乱す恐れがあります。ご注意下さい。

概要

他サイトのWebページを、PukiWiki内で奇麗に表示するプラグイン。

説明

監視用に構築した MRTGなどの画面を、PukiWiki内に動的に表示することにより、PukiWikiからのシームレスな利用を可能にします。

アンカータグを細工して、PukiWiki内で巡回できるようにしています。 (全部が全部じゃないですが...)

また、Proxy対応をしていますので、インターネット接続できない端末からでも、ブラウズできるようになります。（まずい...?）

あと、フレーム指定でも見做しで無理矢理読もうとします。

使い方

#showhtml(http://pukiwiki.sourceforge.jp/)
#showhtml(http://pukiwiki.sourceforge.jp/,1)
#showhtml(http://pukiwiki.sourceforge.jp/,1c)
#showhtml(http://pukiwiki.sourceforge.jp/,1h30mc)
#showhtml(http://pukiwiki.sourceforge.jp/,30m)
#showhtml(http://pukiwiki.sourceforge.jp/,-1)
#showhtml(http://pukiwiki.sourceforge.jp/,c)
#showhtml(http://pukiwiki.sourceforge.jp/,p)
#showhtml(http://pukiwiki.sourceforge.jp/,a)

#showcache
#showcache(img)

詳細

proxy.inc
showcache
html2pw
pconfig.php
html2pw を稼動させるには、結果的には、上のファイル全てが必要となります

↑

更新履歴†

2003-02-27 (木) 02:23:08
- PukiWiki 1.4対応版

↑

対応機能†

キャッシュ機能
HTMLファイルや、画像ファイル(wgetのような機能)をキャッシュ管理できます。
Proxy
Proxy経由での利用にも対応しています。
相対アドレス指定
不要なタグを削除し、また、アドレスの相対指定などの記述を、ローカルで表示できるように、書き換えています。

また、マイクロソフト社のＩＩＳ固有の %u unicode encoding という非標準エンコードにも対応しています。
自動取得機能
metaタグの自動ジャンプ指定時や、frame指定されている場合には、見做しで取得します。
サイト固有の回避機能
BODYタグを除去する関係で、文字が見えにくくなったりするサイト固有に関わる変換をサイト固有変換定義ファイル([[:config/plugin/showhtml/site_local]])に定義することで回避できるようになっています。
キャッシュ延命機能
イメージを取得したサーバが、何らかの原因で、障害が発生している場合には、キャッシュの有効期限が切れていても、延命するようになっています。しかし、ページが移動された場合などは、この限りではありません。

↑

書式†

#showhtml(url, cache_time, foot_btn, parm_reg)

↑

パラメータ説明†

↑

url†

説明
URL(URI)を指定
例
```
http://localhost/pukiwiki/
```

↑

cache_time†

説明
キャッシュ有効時間および画像キャッシュの指定
省略時
キャッシュなし(0)

書式

指定	説明	例
時間指定	数字	2
分指定	数字m	15m
時分指定	数字h数字m	1h30m
記念写真指定	p のみ指定	p
追加撮影指定	a のみ指定	a
画像キャッシュ指定（永久保存）	c のみ指定	c
画像キャッシュ指定	最後に c を定義	3c
キャッシュ削除指定	負の値 (-1)を指定	-1

※h,m,c,p,a などの英字は、大文字小文字同一視

※キャッシュの有効期限が到来している際に、サーバと接続できなかった場合には、キャッシュ利用を延命します。

記念写真指定(p)
閲覧中ページのキャッシュを作成するモードです。

画像も含めて、キャッシュを作成しますが、c と異なる点としては、アンカーが有効となっていて、次から次へとサーフィンしているイメージをキャッシュするところが異なります。

指定した URLのキャッシュが存在している場合は削除します。また、処理は遅くなります。

showcache プラグインと併用すれば、渡り歩いて生成されたキャッシュを再度、表示することができます。
追加撮影指定(a)
記念写真指定(p)で取得した htmlキャッシュファイルを、通常キャッシュ参照時は、永久保存(c)として参照できます。しかし、記念写真指定(p)の追加撮影が必要となった場合には、このオプションを指定することで、継続作業ができるようにしています。

このオプションは、永久保存(c)で参照することにより、不意な更新を抑止するための迂回オプションとなっています。

↑

foot_btn†

説明
showcache プラグインとの連携用ボタンの表示有無
省略時
0(無)

例

#showhtml(http://pukiwiki.sourceforge.jp/,,1)

↑

parm_reg†

説明
_include プラグインとの互換
省略時
なし
例
```
<body[^>]*>(.*)</body
```

↑

導入†

↑

定義†

CACHE_DIR	./cache/	キャッシュディレクトリを定義
HTML_CACHE_DIR	CACHE_DIR."html/"	キャッシュ・サブディレクトリに保存
HTML_CACHE_IMG_SIZE	90	サムネイル生成時最大サイズ
SHOWHTML_FOOT	1(有効)	フットライン表示可否

↑

前提†

PukiWiki が導入されているディレクトリは、以下を想定し記述しています。適宜、読み替えて下さい。

PukiWiki導入先	ディレクトリ
本体	/var/www/html/pukiwiki/
プラグイン用	/var/www/html/pukiwiki/plugin/

↑

プラグインの導入†

ファイル名	導入先
showhtml.inc.php	/var/www/html/pukiwiki/plugin/
showcache.inc.php	/var/www/html/pukiwiki/plugin/
html2pw.inc.php	/var/www/html/pukiwiki/plugin/
pconfig.php	/var/www/html/pukiwiki/
proxy.inc	/var/www/html/pukiwiki/plugin/
proxy.local	/etc
proxy.allow	/etc

proxy.inc
- /etc/php.ini の include_path で指定したディレクトリ
- /usr/share/pear などのディレクトリ
- PukiWiki のプラグインディレクトリ

のいずれかに置けば利用可能となる。

定義
Proxy機能を利用する場合は、pukiwiki.ini.php に define を追加するか、 proxy.inc を直接修正して利用して下さい。

↑

showhtml キャッシュ用ディレクトリ†

httpd.conf に定義される Apache稼動ユーザおよびグループに、キャッシュ用ディレクトリが読めるように、権限を付与する。

/etc/httpd/conf/httpd.conf
```
User apache
Group apache
```
の場合での例は、以下の通り。

cache

mkdir -p /var/www/html/pukiwiki/cache/html
chown apache.apache
chmod 660

↑

構成定義ファイル(pconfig対応)†

名称	ファイル名
サイト固有変換定義ファイル	[[:config/plugin/showhtml/site_local]]
ＵＲＬ名:日本語マッピングテーブル	[[:config/plugin/showcache/URL]]
キャッシュホルダー名マッピングテーブル	[[:config/plugin/showcache/Folder]]

↑

site_local†

サイト固有変換定義ファイル(旧:showhtml.def)

ファイル名
```
[[:config/plugin/showhtml/site_local]]
```
書式
```
|置換前文字列|置換後文字列|
```

例

*showhtml サイト固有変換テーブル
|color=FFFFCC||
|COLOR="silver"||
|COLOR=ivory||
|COLOR="#FFFFCC"||
|position:absolute;||

↑

URL†

showcache利用時や、showhtml利用時に、URLを表示するのではなく、このファイルで定義してある意味のある日本語名を表示するようになる。

<title>タグを期待しても無駄な場合が多いので、個別定義としています。

ファイル名
```
[[:config/plugin/showcache/URL]]
```

書式

**変換前URL
--表示したい文字列

例

*ＵＲＬ名:日本語マッピングテーブル
**http://pukiwiki.sourceforge.jp/
--PukiWiki本家

↑

Folder†

キャッシュの整理整頓で増えたサブフォルダーに日本語名で表示するようになる。

ファイル名
```
[[:config/plugin/showcache/Folder]]
```

書式

**キャッシュディレクトリ名
--表示したい文字列

例
```
**./cache/html
--保管箱
```

↑

コメント†

名無しさん 2002-11-25 (MON) 04:11:35
こ、こりゃまた強力ですね。
baniko 2002-11-25 (MON) 12:59:20
これ欲しかったので待っていました。しかし、取り込んだページに<base href...>が指定されているとリンクがまずいことになります。この部分は手を加える必要ありそうです。例えばhttp://www.yahoo.co.jp
upk 2002-11-25 (MON) 13:12:03
おぉ。そんな指定がありましたね。忘れてました。うぅ。対応したら、また更新しておきます。
baniko 2002-11-25 (MON) 13:30:03
追加で、proxy.local等は管理者権限がないと/etcにコピーできないので、plugin内かpukiwiki導入先の方が良さそうですね。でもって要望ですが、環境変数http_proxyを拾うとうれしいです。（自分で直せって言われそう）
upk 2002-11-25 (MON) 15:44:19
了解しました。baseタグの修正も簡単だし、環境変数も簡単ですんで、夜には更新できると思います。お待ちを。
upk 2002-11-25 (MON) 18:15:44
環境変数の部分は、書き忘れていたんですが、pukiwiki.ini.php で define すれば終わりという逃げを作っておいたので、修正はしません。ドキュメントに追記しておきます。
upk 2002-11-25 (MON) 19:30:32
baseタグと細々したところをちょっと追加しておきました。def にコメントが書けるようにとかのレベルですけども。
upk 2002-11-25 (MON) 19:32:26
前のアーカイブからは、showhtml.inc.php のみ更新しています。あと、doc/ のドキュメントです。更新は、プラグイン本体だけで結構です。
未亜 2002-11-25 (MON) 21:30:08
自宅鯖とレンタル鯖の連携に使わせていただきましたB)
未亜 2002-11-25 (MON) 21:32:52
リモートが落ちていてもキャッシュを表示し続けるオプションとか……用途が違うか
upk 2002-11-26 (TUE) 01:43:53
サーバが死んでいる場合は、キャッシュを延命するようにしておきました。これ以上やると、ある意味、attachプラグインのようなキャッシュファイル名にする必要が出てくるので、記念撮影モードにはしないで、永久保存モードをつけておきました。c のみ指定すれば、永遠にキャッシュを消そうとはしません。
未亜 2002-11-26 (TUE) 02:19:52
お疲れ様です。期待通り動いている模様です♪
baniko 2002-11-26 (TUE) 11:28:16
ご苦労さまでした。いい感じで動いています。LAN内部のサーバから取り込むのに使用する時、警告がウザかったので、すでに""を返すよう変更してしまいました・・・ :)
upk 2002-11-26 (TUE) 12:14:26
proxyを利用しなくてもlocalに定義された帯域は出さないであれば判定できますけど、以外は、プライベートだろうがグローバルだろうが無駄な判定なので、localは出さないで入れておきましょうかね？
baniko 2002-11-26 (TUE) 12:29:55
ありがたいです。いま一部書き直そうか迷ってたところです。お待ちしています。
upk 2002-11-26 (TUE) 12:40:17
対応しちゃいました。inc.php だけ添付しておきました。どうぞ。
upk 2002-11-26 (TUE) 22:08:46
一部不具合を修正し、１つのアーカイブにしました。これで一時、凍結します。継続利用してくださる方は、最新版にしておいて下さい。疲れた。
upk 2002-12-01 (SUN) 06:48:07
c の代わりに p を指定すると、何でもかんでもキャッシュしようと努力します。その上で、showcacheプラグインから、収集した画像などを楽しむということができるようになりました。(これでいいのだろうか？) ということで、もっぱら個人として楽しむ以外には、大きく著作権に触れることでしょう。ご注意下さいませ。
upk 2002-12-03 (TUE) 12:24:17
現在 p のオプションを強化しています。現在の版だと src= しか取得しませんが href= も取得するように試みます。
upk 2002-12-04 (WED) 20:43:21
%u unicode encoding 対応版ができました。画像を取得しなければ、問題ないんですけどね。近々、更新します。
upk 2002-12-04 (WED) 20:45:29
添付ファイルが消されてますねぇ。何か問題ありですかね？
upk 2002-12-05 (THU) 17:38:33
%u unicode encoding 対応版を添付しておきました。他、強化していますが。
たらこせる 2003-02-18 (TUE) 15:26:45
設置しようと思ったのですがプレビューすると
```
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META http-equiv=Content-Type content="text/html; charset=shift_jis"></HEAD>
<BODY></BODY></HTML>
```
と表示するのみです。PHPバージョンの問題？もしくは回線の問題でしょうか。
- upk 2003-02-21 (FRI) 00:43:00
  showhtmlから利用している、proxy.inc または、pconfig.php のいずれかが利用できないと、全部、このように真っ白になってしまうようだというのは確認しましたが、あとは分かりません。忘れたファイルとかって大丈夫ですよね？
- たらこせる
  設置位置等ではないみたいです...。apache上の設定か何かかなあ...
- たらこせる
  ん？pconfig.phpをブラウザ上で直接呼び出したときはどんな挙動になります？上記吐き出しと同じソースになるのでちょっと気になったんですが
  
  ひとまずpukiwiki.phpと同階層にproxy.incを用意したら反応がありました。
```
Call to undefined function: array_key_exists() in /hoge/plugin/showhtml.inc.php on line 80
```
  　これはpconfigをきちんと読めてないってことでしょうか。
  - upk 2003-02-21 (FRI) 22:06:59
    array_key_existsは、PHP4.1.0以降からサポートだそうです。で、読めてないですね。昔の pconfig だと、この関数は使ってないんですけどね。
  - たらこせる
    了解しました。OS10.0.4PHP4.0.6環境ですんで。10.1やふおくでおっかけようか、別マシン立ち上げるか考えどころです。
  - upk 2003-02-22 (SAT) 01:08:59
    行き先掲示板が利用できないという限定が付きますが、ただ、showhtmlのみの利用であれば、古い pconfig を使えば大丈夫かも。rel.0 というのを貼っておきます。確か、何か対応のためにshowhtml自体を修正した記憶があるんですけど、失念しちゃった。まぁ、とりあえず。
名無しさん 2003-02-19 (WED) 12:11:00
sekineと申します。便利なpluginをありがとうございます。Wikiクローン(MoinMoin)を利用してたのですが、最近xoops+PukiWikiに移行しました。で、過去の資産を生かすにはどうしたものかと思ってたところこのプラグインを発見しました。上記の説明を読んでplugin一式を導入しました。適当なページに
```
#showhtml(http://mydomain/MoinMoin/wiki-moinmoin/moin.cgi/XXXXX,c)
#showcache(ext,./cache/html,1)
#showcache(img,./face)
#showcache(img,./image/)
```
と書いて表示させると、MoinMoinで作ったページが表示されて、その下に管理用コマンド(html,face,image)が表示されます。faceとimageにはPukiWikiで定義されているファイルが幾つか一緒に表示されます。が、htmlのほうは何も表示されません。./cache/htmlの下をshellで見ても何もファイルは出来てませんでした。本当はここでhtmlファイルもキャッシュとして表示されなければならないのでしょうか？なお、site_local,URL,Folderの各設定ファイルもPukiWikiファイルとして作成してURL以外は上記の例に倣っています。ちなみに環境はVine2.5, php-4.2.3, apache-1.3.26, PukiWikiMod 0.03 Based on PukiWiki 1.3.3です。よろしくお願いいたします。
- upk 2003-02-22 (SAT) 01:36:54
  こちらの場合は、proxy.inc が機能していないように見えるんですけどね。
- sekine 2003-02-26 (WED) 17:10:12
  proxy.incの設定を見直してみましたが、状況は変わりません。サーバはproxyを利用してInternetに繋がるようにはなってないので、proxy.incの設定では機能を無効化すればよいのですよね？
  - upk 2003-02-26 (WED) 19:36:10
    proxy機能は利用していなくても、そのproxy.inc内の機能は利用しますから、無効化すれば云々と言っても、たぶん、その手立てでも駄目だと思います。
- 名無しさん
  レスポンスが遅くてすみません。また説明不足で申し訳ありません。proxy.incのための設定はpukiwiki.ini.phpの中に
```
define("PROXY_USE", "0");
define("PROXY_LOCAL", "proxy.local");
define("PROXY_TO_ENCODING", "EUC_JP");
define("PROXY_ACCEPT_LANGUAGE", "ja");
```
  としています。さらにproxy.localでは
```
192.168.*
```
  とだけ書いています。
たらこせる 2003-03-05 (WED) 16:20:05
1.４化したおかげで稼動しました。さて、pオプションを指定すると
```
Warning: array_key_exists() [function.array-key-exists]: The second argument should be either an array or an object in plugin/showhtml.inc.php on line 80
Warning: array_key_exists() [function.array-key-exists]: The second argument should be either an array or an object in plugin/showhtml.inc.php on line 364
Warning: Invalid argument supplied for foreach() in plugin/showhtml.inc.php on line 368
```
とアラートがでます。キャッシュディレクトリの問題でしょうか。
- たらこせる 2003-03-05 (WED) 16:41:34
  【追記】オプション関係なかったです。
  - upk 2003-03-06 (THU) 11:11:18
    最新のものでなかったら、最新のものでやってみて下さい。
たらこせる 2003-03-06 (THU) 14:37:54
終了しました。失礼しました...。
たらこせる 2003-03-25 (TUE) 14:32:43
attachしたhtmlファイルのshowhtml呼び出しって可能なんですか？いや、自分でやってみればいい話なんですが。結構HTMLで吐き出すソフトもあったりしてFTPするのもめんどくさいのでどうかなあ、と。
このプラグインは開発が停止しているとの告知が入っており、現在は公開も停止されています。ライセンスの確認を含めた今後の対応について確認中です(See upk) -- henoheno 2006-03-31 (金) 00:38:32