2++拡張プラグイン仕様書

はじめに

　2++の拡張用plugin仕様書です。
　pluginは，nakkaさん作成のnScriptを利用しています。
　拡張子はns2，保存先は%log%/#としています。
　本仕様書は，2++ v0.6.9.7β以降をサポートしています。
★プラグイン一覧も参照してください。
★blog-プラグイン一覧も参照してください。
★テスト用プラグイン一覧も参照してください。

2pluginヘッダ

ファイルの先頭の「//#」形式のコメントを2pluginヘッダとして利用します。
以下の項目を認識します。

//#INFO<tab>2++pluginの簡単な説明

//#VER<tab>バージョン番号(整数値)

//#AUTH<tab>作成者名

//#MAIL<tab>メール

//#COPY<tab>著作権

//#CATE<tab>板を挿入するカテゴリ

//#BRD<tab>ホスト名<tab>BBS<tab>BBSの説明

//#HLP<tab>説明

「//#BRD」・「//#HLP」は複数行記述可能です。
「//#BRD」・「//#HLP」・「#CATE」は省略可能です。

BBS-plugin 処理概要

　BBS機能を提供するプラグインです。
　
①板を表示するとき，issupportを実行し，選択された板を処理するpluginか判定。
　
②板の更新が実行されたとき，board_urlを実行し，板URLを取得。
③board_urlが返したURLに対して，HTTPリクエストを発行。
④サーバからの応答に応じて，board_readを実行。
⑤board_readでは，応答結果からスレッドを検索し，thread_addを実行して登録する。
　
⑥スレの更新が実行されたとき，thread_urlを実行し，スレURLを取得。
⑦thread_urlが返したURLに対して，HTTPリクエストを発行。
⑧サーバからの応答に応じて，thread_readを実行。
⑨thread_readでは，応答結果からスレッドを検索し，message_addを実行して登録する。
　
と，いうことですが，出自が2chなのでこんな説明になっています。
標準のnewsサポートでは，板=記事一覧，スレ=記事と対応させています。また，スレには，複数発言あるのですが，newsサポートでは，スレ(=記事)に対して，1件の発言を対応させています。

blog-plugin 処理概要

　[!rss]にて[plugin]をチェックしたときに利用するプラグインです。
　blogの記事を解析する機能を提供します。
　ファイル名は，blog_ではじめてください。
　
①ファイル名をblog_xxxx.ns2とする。
　
②記事取得時に，blog_readを実行。
③blog_readでは，記事を解析し，1を返却する。

BBS-plugin 拡張用関数

　pluginが用意すべき関数です。
　★がついたのは必須です。

pluginがサポートしている？★ - issupport(host,bbs)

host	ホスト名
bbs	BBS名
戻り値	!0:サポートしている。

漢字コード - char_set

戻り値

0:SJIS，1:JIS，2:EUC，3:UTF8

EUCコードを入力とする？ - iseuc()

戻り値

!0:EUCコード。0:SJISコード(デフォルト)。

JISコードを入力とする？ - isjis()

戻り値

!0:JISコード。0:SJISコード(デフォルト)。

※iseuc優先です。

UTF8コードを入力とする？ - isutf8()

戻り値

!0:UTF8コード。0:SJISコード(デフォルト)。

※isjis・iseuc優先です。

News形式？ - isnews()

戻り値

!0:News形式(デフォルト)。0:BBS形式。

形式の相違はだいたい以下の通りです。

形式	News形式	BBS形式
スレッドのダウンロード	1回	無限
自動未読	可(autonewsdown時)	不可
番号リンク	なし	あり

※発言(=記事)が増えたり，変わったりしない場合には，News形式を指定するとよいでしょう。

番号リンク利用？ - isnumlink()

戻り値

!0:番号リンクあり(BBS形式デフォルト)。0:番号リンクなし(News形式デフォルト)。

固定フォントで表示 - isfixedfont()

戻り値

!0:固定フォント。0:可変フォント(デフォルト)

板URLの取得★ - board_url(host,bbs)

host	ホスト名
bbs	BBS名
戻り値	!0:板のURL

URLとして，""を返す(もしくは何も返さない…)と巡回しません。
URLとして，"#"を返すと巡回せずに，board_read()を実行します。

※詳細は，_config.ns2をご覧ください。

スレッドURLの取得★ - thread_url(host,bbs,key,num)

host	ホスト名
bbs	BBS名
key	スレッドの識別子
num	開始番号(!isnews()のみ)
戻り値	!0:板のURL

URLとして，""を返す(もしくは何も返さない…)と巡回しません。
URLとして，"#"を返すと巡回せずに，thread_read()を実行します。

板の読み込み★ - board_read()

板(=記事一覧)の情報を解析して，スレッド(=記事)への情報をthread_add()を実行して登録してください。

スレッドの読み込み★ - thread_read()

スレッド(=記事)の情報を解析して，発言をmessage_addを実行して登録してください。
発言は1件であることが多いですが，複数回実行してもかまいません。

巡回可能？ - cancruise()

戻り値

0:巡回不可，1:巡回可能(デフォルト)

板一覧で板を巡回するか否かを指定します。

発言可能？ - canpost()

戻り値

0:発言不可(デフォルト)，1:発言可能

発言を投稿できるか否かを返します
発言は，message_postで投稿します。

メッセージの投稿 - message_post(name,mail,message)

name	名前
mail	E-mail
mesage	本文

引数をもとにクエリ文字列をハッシュ形式で作成して，http_POSTを呼び出して投稿してください。

設定変更 - config()

設定を変更するときに実行します。

BBS-plugin登録用関数

解析した結果を2++に登録するための関数です。
board_readではthread_addを，thread_readではmessage_addを実行することを期待しています。
＃チェックを行っていないので，別の関数を実行すると予期せぬ結果になります。

スレッドの登録 - thread_add(title,dat)

板を解析(board_read)して発見したスレッドをthread_addを実行して登録します。

datの拡張子を除去したものをkey情報と解釈しています。
dat情報の拡張子は.datに変換して管理します。
dat情報は，一意性を保証して登録します。同一datで登録した場合最初に登録したdatを優先します。
dat情報は，内部的にはURLエンコードして管理しています。
thread_url実行時にはURLデコードして渡しています。このため，aタグのhref属性を渡せば良いでしょう。
dat情報を，?ではじめると，擬似スレッドとして扱います。

title	スレッド(=記事)のタイトル
dat	スレッドのdat情報
戻り値	!0:板のURL

スレッドの登録 - thread_add(title,dat,name,mail,date,message)

スレッドとメッセージの登録を一緒に登録します。

title	スレッド(=記事)のタイトル
dat	スレッドのdat情報
name	メッセージのタイトル
mail	メールアドレス(必要なければ0でよい。)
date	日付
message	発言内容
戻り値	!0:板のURL

メッセージの登録 - message_add(name,mail,date,message,title)

name	メッセージのタイトル
mail	メールアドレス(必要なければ0でよい。)
date	日付
message	発言内容
title	スレッドのタイトル

messageでは，<br>・<font color>・<b>のみ指定可能です。

HTMLから変換 - html2dat()

2ch形式のHTMLを入力として，変換して読み込みます。

板情報を追加 - board_add(category,host,bbs,title)

category	カテゴリ
host	ホスト
bbs	BBS
title	タイトル

無変換 - read_through()

何も変換せずに，読み込みます。
board_readで2ch形式のsubject.txt，または，thread_readで2ch形式のdatのとき，この関数を実行してください。

blog-plugin 拡張用関数

板の読み込み★ - blog_read()

blogの記事を解析して，blogの情報を設定します。
　

blog_generator・blog_feedを参照して，解析対象か判定してください。
html_xxxxを利用して，htmlを記事を解析してください。
blog_xxxxを利用して，解析した情報を設定してください。
解析に成功した場合，1を返してください。

戻り値

0:解析失敗，1:解析成功

blog-plugin プロパティ関数

関数		説明
blog_feed()	GS	blogのfeed-URL
blog_generator()	G	blogの作成
blog_author(v)	S	blogの著者
blog_date(v)	S	blogの時間
blog_message(v)	S	blogの本文
blog_title(v)	S	blogのタイトル
blog_trackback(v)	S	blogのトラックバック

記事は以下のように表示されます。
%blog_date%
%blog_title%(%blog_author%)
[feed]　[trackback]
%blog_message%

htmlのmeta情報参照 - blog_meta(name)

metaタグのname属性を引数に指定したとき，content属性を返却します。

name	metaタグのname属性
戻り値	metaタグのcontent属性

※generatorは，blog_generatorで参照可能。

htmlのlink情報参照 - blog_link(name)

linkタグのtype属性を引数に指定したとき，href属性を返却します。

name	linkタグのtype属性
戻り値	linkタグのhref属性

※application/atom+xml(application/rss+xml)は，blog_feedで参照可能。

RDFの解析- blog_parse_rdf([comment])

HTML内のコメントに埋めこまれた，rdf:Descriptionの情報を解析します。

属性	プロパティ関数
trackback:ping	blog_trackback
dc:title	blog_title
dc:creator	blog_author
dc:date	blog_date

comment	コメント。省略した場合，コメントタグを検索して，解析します。
戻り値	0:解析失敗。1:解析成功。

情報取得用関数

　board_read・thread_read・blog_read実行中に接続先の情報を取得するのに利用します。

関数	説明
url()	URL
host()	ホスト名(board_url・thread_urlのhost引数と同じ)
bbs()	BBS名(board_url・thread_urlのbbs引数と同じ)
key()	スレッドの識別子(thread_urlのbbs引数と同じ)
num()	開始番号(thread_urlのnum引数と同じ)

HTTP関数

　httpのリクエストを発行する時に利用する関数です。
＃2pdkは，未対応です。

GET - http_GET(url,func)

url	httpで受信するurlを指定する。相対URLも指定可能。
func	解析用関数名。
戻り値	funcの戻り値。

※解析用関数には，status-codeを渡します。
※解析用関数で返した文字列が，http_GETの返り値となります。
※詳細は，tenki.ns2をご覧ください。

POST - http_POST(url,query,func)

url	httpで受信するurlを指定する。相対URLも指定可能。
query	クエリ文字列をハッシュ形式で指定します。
func	解析用関数名。
戻り値	funcの戻り値。

※解析用関数には，status-codeを渡します。
※解析用関数で返した文字列が，http_POSTの返り値となります。
※詳細は，megabbs.ns2をご覧ください。

2.ini用関数

　2.iniから設定値を参照・設定する関数です。
＃2pdkでは，2pdk.iniを利用します。

設定値を参照 - ini_get(section,entry,value)

section	セクション
entry	エントリ
value	デフォルト値(省略可)

cfg_get(entry,value)で_configセクションを参照できます。
my_get(entry,value)でplugin固有セクション(pluginのファイル名がfile.ns2のとき，セクション名は#file)を参照できます。

設定値を設定 - ini_set(section,entry,value)

section	セクション
entry	エントリ
value	値

cfg_set(entry,value)で_configセクションに設定できます。
my_set(entry,value)でplugin固有セクション(pluginのファイル名がfile.ns2のとき，セクション名は#file)に設定できます。

設定値を削除 - ini_clear(section[,entry])

section	セクション
entry	エントリ(省略可)

my_clear([entry])でplugin固有セクション(pluginのファイル名がfile.ns2のとき，セクション名は#file)を削除できます。

HTML解析用関数

サーバから取得したHTMLの内容を解析するための関数です。

タグ名・属性名は全て小文字となります。

HTMLの要素の種類

HTMLの各要素を以下の定数値で定義しています。
※これらの値は，2++の中で定義しています。

HTML_ERROR	0	エラーがあった
HTML_START_DOCUMENT	1	HTMLの最初(初期状態)
HTML_END_DOCUMENT	2	HTMLの最後(終了状態)
HTML_TEXT	3	テキスト要素
HTML_COMMENT	4	コメント
HTML_START_TAG	5	開始タグ
HTML_END_TAG	6	閉じタグ

html_next - 次の要素へ移動

この関数を利用して，HTML内の要素を順次解析します。

戻り値

要素の種類

html_isend - HTMLの終端か否か

戻り値

1:HTMLの終端(HTML_ERROR，または，HTML_END_DOCUMENT)

html_text - テキスト要素の取得

戻り値

テキスト(HTML_TEXTの時のみ有効)

※html_plainと異なり<等<に変換される。

html_plain - 生テキスト要素の取得

戻り値

生テキスト(HTML_TEXTの時のみ有効)

※html_textと異なり<等がそのまま得られる。

html_tag - タグ名の取得

戻り値

タグ名(HTML_START_TAG・HTML_END_TAGの時のみ有効)

html_attr(name) - 属性の取得

戻り値

属性(HTML_START_TAGの時のみ有効)

html_comment(name) - コメントの取得

戻り値

コメント(HTML_COMMENTの時のみ有効)

※のとき<!と>だけ除去され-- comment --が返ります。

html_go(value,count) - 取得

value	検索する要素の値
count	検索する回数(省略可)
戻り値	1:見つかった。0:見つからずに終了した。

valueの書式は以下のとおりです。

開始タグ	<tag[@attr[=value]]>
終了タグ	</tag>
コメント	<!value>
文字列	value

※html_go( "<div>")とすると，<div>に移動します。
※html_go( "<div@class=text>")とすると，<div class=text>に移動します。
※html_go( "<div>",2)とすると，2個目の<div>に移動します。

html_go(type,value) - 移動

type	検索する要素の種類
value	検索する要素の値(省略可)
戻り値	1:見つかった。0:見つからずに終了した。

※たとえば，<a>に移動するには，html_go(HTML_START_TAG,"a")と指定します。

html_pull(value) - 取得

指定した位置までテキスト形式に変換して取得します。

value	検索する要素の値
戻り値	見つかった位置までのテキスト値。

valueの書式は以下のとおりです。

開始タグ	<tag[@attr[=value]]>
終了タグ	</tag>
コメント	<!value>
文字列	value

※html_pull( "<div>")すると，<div>までのテキストを取得します。
※html_pull( "<div@class=text>")すると，<div class=text>までのテキストを取得します。

html_pull(type,value) - 取得

指定した位置までテキスト形式に変換して取得します。

type	検索する要素の種類
value	検索する要素の値(省略可)
戻り値	見つかった位置までのテキスト値。

※「<b>太</b><i>斜</i></a>」に対して，html_pull(HTML_END_TAG,"a")を指定すると，「太斜」というテキストが取得できます。

html_resolve(url) - URL解決

解析中のHTML内の相対URLを絶対URLに解決します。

url	相対URL
戻り値	絶対URL

ダイアログ用関数

　ダイアログを操作するための関数です。情報は，iniファイルに保存します。

ダイアログを作成する - dlg_new([section,[label]])

section	値を保持するセクション名(省略時プラグイン名)
label	表示するダイアログ名(省略時プラグイン名)
戻り値	ダイアログオブジェクト

ダイアログを表示する - dlg_show(dlg)

dlg

ダイアログオブジェクト

ダイアログの文字列値 - dlg_str(dlg,entry[,label])

dlg	ダイアログオブジェクト
entry	値のエントリ名
label	値の説明(省略時entry)

ダイアログのパスワード - dlg_password(dlg,entry[,label])

dlg	ダイアログオブジェクト
entry	値のエントリ名
label	値の説明(省略時entry)

ダイアログの数値 - dlg_int(dlg,entry[,label])

dlg	ダイアログオブジェクト
entry	値のエントリ名
label	値の説明(省略時entry)

ダイアログのブール値 - dlg_bool(dlg,entry[,label])

dlg	ダイアログオブジェクト
entry	値のエントリ名
label	値の説明(省略時entry)

ダイアログの選択 - dlg_select(dlg,entry,label[,option]+)

dlg	ダイアログオブジェクト
entry	値のエントリ名
label	値の説明
option+	選択肢(複数指定)

ダイアログのセパレータ - dlg_separator(dlg[,label])

dlg	ダイアログオブジェクト
label	ラベル

プロパティシートの作成 - sheet_new([section,[label]])

section	値を保持するセクション名(省略時プラグイン名)
label	表示するダイアログ名(省略時プラグイン名)
戻り値	プロパティシートオブジェクト

プロパティページの作成 - page_new(sheet,label)

　プロパティシートオブジェクトに対して，page_new()を実行して，プロパティページオブジェクト(=ダイアログオブジェクト)を取得してください。
　取得したプロパティページオブジェクトに対して，ダイアログ関数を実行して，ページの内容を設定してください。

sheet	プロパティシートオブジェクト
label	プロパティページのタイトル
戻り値	プロパティページオブジェクト(=ダイアログオブジェクト)

プロパティシートの表示 - sheet_show(sheet)

sheet

プロパティシートオブジェクト

擬似スレッド

スレッド一覧に表示されるが，巡回せずに特殊な動作を行う擬似スレッドがあります。

?.%name%の形式のキーを擬似スレッドとして扱います。
%name%は，[_a-zA-Z0-9]+でなければならない。(ただし，チェックせず…)

※詳細は，_config.ns2をご覧ください。

?$%name% - 文字列入力

文字列の入力を行う擬似スレッドです。

現在の値は，my_get(%name%)で参照できます。
タイトルには，:を含めてはいけない。
タイトルは，%title%:%現在の値%の形式で表示します。

?#%name% - 数値入力

数値の入力を行う擬似スレッドです。
制限事項は，以下のとおりです。

現在の値は，my_get(%name%)で参照できます。
タイトルには，:を含めてはいけない。
タイトルは，%title%:%現在の値%の形式で表示します。

??%name% - トグル切り替え

ブール値のトグル動作の擬似スレッドです。

現在の値は，my_get(%name%)で参照できます。
タイトルには，:を含めてはいけません。
タイトルは，%title%:%現在の値%の形式で表示します。

?!%name%[:%param%] - 関数実行

プラグイン内の関数を実行します。

謝辞

nScriptは，nakkaさんによって作成されました。

補足

　要望・バグレポートは以下のところに連絡してください

mailto:QVE00513@nifty.com

履歴

2004-08-29 第2版 r0.0.3

html_goのバグ修正と仕様を変更。

2004-08-27 第2版 r0.0.2

html_go・html_pullで，文字列形式の指定をサポート。

2004-08-22 第2版 r0.0.1

2++ for pluginをv0.6.9.7にした。
blogプラグインを追加した。

2004-08-09 第1版 r0.0.13

2++ for pluginをv0.6.9.5にした。
プラグインでhttp_resoveを追加。
プラグインでdlg_selectを修正。
プラグインでchar_set(0=SJIS,1=JIS,2=EUC,3=UTF8)をサポート。
漢字コード指定対応。
configボタンサポート。
その他，2++の修正を吸収。

2004-01-02 第1版 r0.0.12

2++ for pluginをv0.6.0.2にした。
他プログラムのバグフィックスを吸収。
プラグインにcancruiseを追加。

2003-12-20 第1版 r0.0.11

2++ for pluginをv0.5.9.12にした。
プラグインにhttp_POSTを追加。
プラグインにcanpostを追加。
プラグインにboard_addを追加。
プラグインにisutf8を追加。

2003-11-11 第1版 r0.0.10

2++ for pluginをv0.5.9.1にした。
2++ for pluginで，POPの情報を詳しく出すようにした。

2003-10-13 第1版 r0.0.9

ダイアログ関連の関数の説明を追加した。
設定変更config()関数を追加した。
2++ for pluginをv0.5.1.1にした。

2003-09-13 第1版 r0.0.8

thread_addで記事の内容を同時に登録できるようにした。
html→text変換処理で，<a>の解釈を変更した。
2++ for pluginをv0.5.0.1にした。

2003-07-31 第1版 r0.0.7

divを解釈するようにした。
2+ for pluginをv0.3.9.2にした。

2003-07-21 第1版 r0.0.6

<a>内で，<img alt>を解釈するようにした。

2003-07-21 第1版 r0.0.5

html_pullでの<br>の扱いを変更。
ZenToHan追加。
2+ for plugin追加。
ヘッダに#CATEを追加。

2003-07-20 第1版 r0.0.4

EUC・SJISの終端判定を修正。

2003-07-20 第1版 r0.0.3

nScriptのEUC半角仮名の扱いを修正。
HTML解析で<の解釈を一部修正。

2003-07-16 第1版 r0.0.2

<!…>をコメントとして解釈するようにした。

2003-07-15 第1版 r0.0.1

もうそろそろ固定ってことで，第1版とする。
文字コード関数が関数テーブルに入っていなかったのを修正。
スクリプトのリロード処理修正。

2003-07-07 α17版

文字コード関数を組み込んだ。
errorの出力を別画面に出すようにした。
thread_urlでnumを積むようにした。

2003-07-06 α16版

<a>タグ対応。
その他本体の修正項目を吸収。

2003-06-22 α15版

thread_addの仕様変更。
2.iniの削除(ini_clear)を追加。

2003-06-21 α14版

http_GETの仕様変更。
擬似スレッド$!を追加。

2003-06-17 α13版

擬似スレッド追加。
board_url・thread_urlの返すURLの処理を変更。

2003-06-16 α12版

http_GETを追加。利用する場合には，#HLPに書いておいてください。
http2dat・read_throughを追加。
isfixedfontを追加。

2003-06-14 α11版

文書を追加。
2plugin.cgiを追加。
sample.ns2を追加。

2003-06-09 α10版

2.iniへの参照(ini_get)・設定(ini_set)を追加。
ヘッダに#HLPを追加。

2003-06-08 α9版

html_goの仕様変更。

2003-06-07 α8版

html_pullのurl引数を削除。
html_pull時の<a href=url>のurl解析処理変更。
解析中の情報取得関数(url())追加。

2003-06-04 α7版

テスト用ツール2pdkにボタンを増やした。
テスト用ツール2pdkでurl・bbs・keyを指定できるようにした。

2003-06-02 α6版

html_pullで<a href=url>url</a>のとき，囲まれたurlを出力しないようにした。
html_pullで<p>を<br><br>とするようにした。
isjisを追加。

2003-06-01 α5版

解析中の情報取得関数(host()・bbs()・key()・num())追加。
BBS形式のときthread_urlにnum引数を追加。
isnumlink()を追加。

2003-05-29 α4版

isnewsの説明を追加。

2003-05-28 α3版

テスト用ツール2pdkを公開。
ヘッダにMAILを追加。

2003-05-25 α2版

定数を内部で定義するようにした。
2+の公開にあわせて公開。

2003-05-22 α1版

暫定公開版

付録

2pdkについて

2++plugin developers kitで，2++プラグインの関数をテストするためのツールです。

board-html	board_readで解析するhtmlファイル(SJIS)を指定します。
thread-html	thread_readで解析するhtmlファイル(SJIS)を指定します。
[tree]	htmlファイルを木構造で表示します。
2+plugin	2++プラグインのファイルを指定します。
[info]	2++プラグインのヘッダを表示します。
host	board_url・thread_urlのhostパラメタを指定します。
bbs	board_url・thread_urlのbbsパラメタを指定します。
key	board_url・thread_urlのkeyパラメタを指定します。
[next]	2++プラグインの#BRDヘッダの情報をhost・bbsに設定します。実行前に[info]を実行してください。
url	url()の値を設定します。
[exec]	urlのurlをIEで開きます。
[board_url]	board_url関数を実行します。
[board_read]	board_read関数を実行します。
[thread_url]	thread_url関数を実行します。
[thread_read]	thread_read関数を実行します。
[copy]	エディットボックスの内容を転送します。[tree]後に実行するとよいでしょう。
[exit]	終了します。エディットの内容をカレントディレクトリの2pdk.iniに保存します。

2pdkの簡単な使い方

①作りたいプラグインの一覧htmlと記事htmlのurlを確かめます。
②解析する一覧htmlと記事htmlをSJIS形式で用意して，board-html・thread-htmlに指定します。
③ベースとするsample.ns2をもとに，新しいプラグインファイルを作成し，2+pluginに指定します。
④プラグインファイルの2pluginヘッダの情報に①のurlを元にいろいろ入れてあげます。
⑤#BRDに書いた情報を受理するようにissupportを作ります。
⑥解析する頁構成に応じて，iseuc・isjis・isnews・isnumlinkを調整します。
⑦board_urlの確認。[info][next][board_url]の順に押して，urlに①のurlが入るか確認します。だめだったら，function board_urlを調整しましょう。
⑧board_readの確認。

pluginの基礎

同梱しているsample.ns2や，公開されているプラグインのソースを参考にすると良いでしょう。
ただし，複雑なことをやってるのもあるので，ニュース形式の簡単なものの作り方を簡単に記述します。

もっとも簡単なboard_read

<a>タグで囲まれた，文字列をタイトルとして登録するには，↓の用にします。
while( html_go( HTML_START_TAG, "a")){
　　href = html_attr( "href");
　　title = html_pull( HTML_END_TAG, "a");
　　thread_add( title, href);
}
hrefの唯一性は保証しているので，何も考えずにつっこんでも大丈夫です。

ちょっと賢いboard_read

これでは，余分なリンクを拾ってしまうことがあるので，フィルタリングします。
フィルタリングの方針としては，以下のような方針があります。

はじめに，それっぽいのに飛ぶ。

一覧の前に，決まったコメントがあったり，決まったタグがあったりする場合には，html_go()関数ではじめに移動するとよいです。
　たとえば，であれば，html_go(HTML_COMMENT,"-- list --")することで，一気に移動できます。

前に，決まったタグがある。

　<li><a>のように，箇条書きになっているところもあります。この場合，<a>タグで回すのではなく，<li>タグでまわすほうがよいです。
while( html_go( HTML_START_TAG, "li")){
　　if( html_next()!=HTML_START_TAG || html_tag()!="a") continue;
　　//ここには，<li><a>の時来る。
　　href = html_attr( "href");
　　title = html_pull( HTML_END_TAG, "a");
　　thread_add( title, href);
}
　もしくは，
while( html_go( HTML_START_TAG, "li")){
　　if( !html_go( HTML_START_TAG, "a")) continue;
　　//ここには，<li><a>の時来る。
　　href = html_attr( "href");
　　title = html_pull( HTML_END_TAG, "a");
　　thread_add( title, href);
}
の用にします。
2つの違いは，必ず連続してるか，連続してないこともあるかの違いです。
構成がどの程度かっちりしているかによって，判断します。
＃多くの場合，下の方法で問題ないです。上の方法だと，空白文字があったりしても弾かれます。

行き先が決まっている。

　記事のURLの形式が決まっている場合，URLと文字列マッチングをして確認するのが良い場合もあります。
　たとえば，ローカルの絶対パスのみ有効とするには，'/'で始まっていればよいので，
　　if( left( href, 1)!="/") continue;
のようなフィルタリングが利用できます。
　また，".html"でなければならないときは，
　　if( right( href, 5)!=".html") continue;
です。
　他には，正規表現を使って，マッチングを取る方法もありますが，そのへんは適宜ということで。

もっとも簡単なthread_read

記事のタイトルと本文さえあればいいので，…<title>タイトル</title>…<body>本文</body>…の形式であれば，↓の用にします。
if( !html_go( HTML_START_TAG, "title")) return;
title = html_pull( HTML_END_TAG, "title");
if( !html_go( HTML_START_TAG, "body")) return;
message = html_pull( HTML_END_TAG, "body");
message_add( title, 0, "　", message, title);

賢くするには…

賢くするには，いろいろな方法があります。
　
まず，message_addでは，一部のhtmlタグをサポートしています。

<br> 改行することができます。
<b> 太字にすることができます。
<font> 色をつけることができます。

これらをつかって，見栄えを調整することができます。
　
つぎに，board_readの説明に示したとおり，html_go()・html_pull()を使って，必要な部分を切り出すことを考えましょう。
その他，いろんなことをしたい場合には，公開されているpluginも参照してください。

2chリンク

階層的なリンク構造を実現するために，2chリンクが使えます。
2chリンクにはいろいろな形式がありますが，プラグインでは，p:/<host>/#@#/<bbs>/<key>の形式を利用するとよいでしょう。
これをはっておくと，板(<host>，<bbs>)に，スレ(<host>,<bbs>,<key>)が追加されます。

ホームへ

更新日：2004-12-26　QVE00513@nifty.com