twtlog の編集 - PukiWiki

* twtlog: Twitter logview [#o7f0d3f7]

#contents

* ダウンロード [#a06c200a]

- &ref(twtlog_20090811a.tar.gz);
-- [最新]リンクのURLから日付（d=yyyymmdd）を外した。
-- 個別モード表示で、ナビゲータ[<<|@|>>]を追加した。
-- 個別モード表示で、自分は常に最初に表示するようにした。
-- CSSデザイン用にclass属性を追加した。
-- [twtlog]リンクに現在使っているtwtlogのバージョンを表示するようにした。
-- tiarraログでの動作を確認。
-- ログの行頭の時刻表示に"秒"が存在していても受け付けるようにした。

: [[[>> 過去のファイル]>twtlog#m7556fbc]] |

* 概要 [#xb35765f]

Twitter+[[TwitterIRCGateway:http://www.misuzilla.org/dist/net/twitterircgateway/]](TIG)+常駐IRCクライアント（plum/tiarraなど）の環境下において、ログ閲覧機能を提供します。

サンプルはこちら。[[@gorry5 log:http://gorry.hauN.org/tw/]]

* インストール方法 [#o46f3223]

+ WWWサーバとperl、Jcode.pmが必要です。
+ 展開します。標準では、WWWホームディレクトリの"twtlog"へインストールすることを想定した設定が行われています。それ以外のフォルダで使用する場合は、twtlog.phの$TWTLOGURLを適宜変更する必要があります。
+ 展開したファイルを、以下のようにリネームします。
-- index.cgi.sample  -> index.cgi
-- twtlog.ph.sample  -> twtlog.ph
+ twtlog.phを環境に合わせて編集します。&br;最低限、以下の設定が必要です。
| $USERNAME  | Twitterユーザー名            |
| $LOGPATH   | plum/tiarraなどのログディレクトリへのPATH |
| $TWTLOGURL | index.cgiを示すURL           |
| @GROUP     | ロググループ情報             |
+ index.cgiにCGI実行属性を与え、WWWサーバからCGIが実行できるかどうかを確認します。
+ .htaccessなどで、適宜ソースファイルやディレクトリの非可視化を設定しておくとよいでしょう。

* アンインストール方法 [#x24c05b9]

+ インストール先ディレクトリの全ファイルを削除します。

* 使用方法 [#oc064afc]

CGIを引数なしで実行すると、「今日の最新ログ」が表示されます。

先頭と末尾には、コマンド行が表示されます。クリックすると、以下の動作をします。

それ以外の部分には、Twitterのタイムラインに相当する行が表示されます。

: 日付時刻 |クリックすると、その行を中心とした行を表示します。すべての行には固有のURLがあり、右クリックで取得することができます。
: (@username) | 発言した人を示します。またTwitterサイトの@usernameページへリンクを行います。&br;[表示]が[@usernameのみ]または[個別]のときは、各ユーザーの(@username)は省略されます。
: @username | 発言内容に@usernameが含まれるときは、Twitterサイトの@usernameページへリンクを行います。
: URL | 発言内容にURLが含まれる場合、そのURLへのリンクを行います。リンクは、googleを利用したクッションページを経由します。&br;twtlog.phで動作を変更することができます。
-- 「$URLLINK = 0」にすると、リンクを行いません。
-- 「$URLCUSHION = 0」にすると、クッションページを表示しません。
-- 「$URLSHORTEN = 0」にすると、URL文字列を"[URL]"に置き換えるのを行いません。

* CGI引数 [#tdd133d2]

CGI引数を与えて、表示内容を直接指定することができます。

: d=日付 | 表示する日付を与えます。日付の書式は、"yyyy/mm/dd"です。省略した場合は、CGIの実行日付が内部的に与えられます。
: id=行ID | 表示する行IDを与えます。指定行の強調表示と、前後行の表示が行われます。&br;IDは日別で行単位に1以降の数値が振られます。また以下の特殊IDがあります。
-- 行IDを指定しない場合は0となり、すべての行が表示されます。
-- 行IDに-1を与えると、「その日の最終行」に置き換えられます。
:me=0/me=1/me=2 | [表示]オプションに相当します。
-- 0  全て
-- 1  @usernameのみ
-- 2  個別
省略した場合は、ヘッドモードのときは1、それ以外では0となります。
: line=行数 | IDを指定したときの表示行数を指定します。最大値は100、指定しないときは5となります。&br;行IDが0のときは無視され、常にすべての行が表示されます。
: head=1 | ヘッドモードで表示します。他のHTMLファイルからインクルードされることを想定した出力となります。
-- HTMLヘッダ・フッタを出力しません。
-- me=1（@usernameのみを表示）に固定されます。
-- lineのデフォルト値を10にします。
-- 最新日から表示行数を満たすまで過去分をすべてスキャンします。スキャンするときの一覧ファイル名として、グループ情報のLOGMASKが使用されます。

* 注意 [#a9fd5ab0]

HTTPサーバ上に設置しての使用は、バグや予想外の事態によりサーバやネットワークシステムに大きなダメージを与える可能性があります。使用者の責任において、厳重な監視のもとでご使用ください。

* 使用許諾文書 [#q951d2fa]

twtlogは、作者に許諾を得ることなく、自由に使用・配布・改変を行うことができます。
これらは無保証であり、使用した、あるいはしなかったことによる一切の責任は所有者にあるものとします。

* 過去のファイル [#m7556fbc]

- &ref(twtlog_20090803a.tar.gz);
-- 最初のバージョン。

- &ref(twtlog_20090803b.tar.gz);
-- 引数が何も存在しないとき、「今日の最終行を全フォローで」表示するよう各所調整。
-- &GetLog2()で引数にゼロサプレスされた日付を与えると誤動作するバグを修正。

- twtlog_20090809a.tar.gz
-- 人柱版。
-- jcode.plをやめ、Jcode.pmを使用するようにした。
-- [twtlog.ph]ロググループ対応。
--- @GROUP
-- その他全体的に作り直し。twtlog.phは非互換に。

- &ref(twtlog_20090809b.tar.gz);
-- デバッグコードが残っていたのを削除。
-- reply行が表示されないことがあったのを修正。
-- 個別表示で最後のユーザーが表示されないバグを修正。
-- ヘッドモードが正常に表示されなくなっていたのを修正。
-- [twtlog.ph]TypableMapサポートの追加。
--- $TYPABLEMAPCOMMAND
--- $SHOWTYPABLEMAPKEY
--[twtlog.ph]$LOGPATH2末尾に'/'が入っていなかったのを修正。

* コメント [#uc864f1d]
-2010/09/21のtwitter XSS問題に対処するつもりがないため、配布を停止します。 -- [[GORRY]] &new{2010-09-21 22:48:45 (火)};
-もし、既存のものを使い続けたいのであれば、ソース中の「s#(http\:\/\/[^ ]+)#」を「s#(http\:\/\/[\-\%\/\.\$\,\;\:\&\=\?\!\*\~\@\#\_0-9A-Za-z]+)#」に置換してください。 -- [[GORRY]] &new{2010-09-21 23:21:12 (火)};

#comment

RIGHT:counter: today=&counter(today);, yesterday=&counter(yesterday);, total=&counter;

タイムスタンプを変更しない