tDiary

きたです．

>* 各プラグインのドキュメント
>
>リソースに書こうと言っていましたが、やはりソースのコメントとして書く
>のはだいぶ無理があるように思います。いっそ外部(Webサイト)に置いて、sp
>プラグインの設定画面から参照できるようにした方が、今後の多言語化にも
>いいのではないかと。
>
>tdiary.orgにwikiを置いて、そこにドキュメントを書けるようにしようと思
>いますが、どうでしょう? このあたりを整理すると、まだリソース化が済ん
>でいない部分はいらなくなります。

ドキュメントを外部の Web ページに追い出すという案には賛成ですが，
tdiary.org はちょっと重すぎるんではないか，という気がします．
# tdiary.org と第一 tdiary.net って同じマシンですよね?

tdiary.org が急に軽くなるとは思えないし，*当面は* tdiary-users.sf.net の 
wiki に同居するか，別の wiki を立てるかした方がいいんじゃないでしょうか?
仮に wiki.fdiary.net を使うとして docs.tdiary.org を当面 wiki.fdiary.net 
に向けとく，とか．

ただただしです。

Junichiro Kita <kita@...> wrote:
>ドキュメントを外部の Web ページに追い出すという案には賛成ですが，
>tdiary.org はちょっと重すぎるんではないか，という気がします．
># tdiary.org と第一 tdiary.net って同じマシンですよね?

いちおう、第一tDiary.Netのトラフィックを、第二〜第四に移すことを前提にし
ています。なかなか着手できないでいるけど、第一のユーザは減らします。

>tdiary.org が急に軽くなるとは思えないし，*当面は* tdiary-users.sf.net の 
>wiki に同居するか，別の wiki を立てるかした方がいいんじゃないでしょうか?
>仮に wiki.fdiary.net を使うとして docs.tdiary.org を当面 wiki.fdiary.net 
>に向けとく，とか．

国際化はしたいから、Hikiを使うのがいいなと思っているので、どこかのHiki
を借りられるならそれに越したことはないです(usersはHikiじゃないし)。そう
か、wiki.fdiary.netを借りるという手はあったなぁ……(笑)。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

ただただしです。

Masao Mutoh <mutoh@...> wrote:
>後々、以前の議論を蒸し返すのはイヤなので、先に。
>ライセンスはどうお考えでしょう？
>
>私としては、（少なくとも自分が提供しているプラグインに関しては）LGPL
>でリリースしていますので、それに準拠・あるいはそれに近いライセンスを
>希望します。

元になるものがプラグインのソースに含まれているコメントですから、とうぜん
元のプラグインのライセンスが適用されると考えています(プラグイン集に入っ
ているものはGPLですが)。Copyrightを入れるのはもちろん、ページごとにライ
センス表記もありでしょう。

さらに、このドキュメントを勝手に改変するのはまかりならんという場合には、
内容が固定されたページへのURLを貼ってもいいと思いますし。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

かずひこ＠ wiki.fdiary.net おおや です。

At Tue, 30 Sep 2003 13:39:34 +0900,
TADA Tadashi wrote:

> >tdiary.org が急に軽くなるとは思えないし，*当面は* tdiary-users.sf.net の 
> >wiki に同居するか，別の wiki を立てるかした方がいいんじゃないでしょうか?
> >仮に wiki.fdiary.net を使うとして docs.tdiary.org を当面 wiki.fdiary.net 
> >に向けとく，とか．
> 
> 国際化はしたいから、Hikiを使うのがいいなと思っているので、どこかのHiki
> を借りられるならそれに越したことはないです(usersはHikiじゃないし)。そう
> か、wiki.fdiary.netを借りるという手はあったなぁ……(笑)。

もちろんどうぞ。ただ、
http://wiki.fdiary.net/tdiary/
はすでに使われていたりします。先見の明がなくてすみません。m(_ _)m

あと、 hoge.tdiary.net を wiki.fdiary.net/hoge/ とかにとばすとかは何なり
とご用命のほどを。
-- 
かずひこ <http://wiki.fdiary.net/kazuhiko/>
  ★シャア「名字が付いてない」
  ☆一兵卒「あんなの飾りです。偉い人にはそれが分からんのです」

ただただしです。

zunda <zunda616e@...> wrote:
>Wikiだと、実際にユーザーの手元にあるプラグインとドキュメントのバージョン
>が合わなくなってしまう心配はあります。

うーん、たしかにこれは想定外でした。まぁ、仕様変更等があった場合には、そ
のドキュメントにそう明記する、という逃げはアリですが。

>cvsレポジトリの一部をwwwからアクセスでき
>るようにして、そこを参照する、という手もあるかもしれません。

Wiki化するという案の本意は、実際に使う人(開発者でない人)が、自分の体験を
元にしてよりわかりやすいドキュメントにしてくれるのではないかという期待が
あります。CVSにすると、エンドユーザからのフィードバックはほとんど見込め
ないですから。

>この場合は、
>tDiaryに添付されているプラグインとそうではないプラグインでURLが違ってし
>まう、という問題がでるかもしれません。こうなると、プラグイン側で、参照す
>るべきドキュメントのURLを持っていてほしいかも。リソースを参照せよ、とい
>うのも含めて。

これは下にも書かれているように、使わないプラグインまでevalしなければなら
ないので、ちょっとね……。でも、なんらかの「メタ情報」を得られるようには
したいですねぇ。

>あと、secure==trueな日記で使えるかどうか、というフラグもあるとうれしいで
>す。

これも同様ですが、セキュアモード時に動かないプラグインは、それなりの対策
をしてもらう方が良いかな、と思います。エラーを出さないようにするとか、同
じ目的のプラグイン間で排他をかけるとか。レンタルの場合はそもそもディレク
トリにそういうものを入れるべきではないし。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

ただただしです。

Mitsuru Shimamura <mitsuru@...> wrote:
>素朴な疑問なんですが、doc/plugin/ などのディレクトリを掘って
>そこに plugin_name.{html,rd,txt} などのファイル名で
>ドキュメントを置くのはダメなんでしょうか？

その方式の問題点のひとつは、インストールの手間がさらに増してしまうこと。
従来、本体だけコピーすればよかったのが、今では場合によっては言語リソース
もコピーしなくてはいけない。その上ドキュメントも……となると、とてもプラ
グインとは呼べないな、と。

もうひとつは、別のメールにも書いたように、CVSに入れちゃうとドキュメント
を改善してくれそうな人の数を減らしてしまう(かも知れない)からです。これは
消極的な理由ですが。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

smbdです。

On Tue, 30 Sep 2003 16:52:42 +0900
TADA Tadashi <sho@...> wrote:

> >素朴な疑問なんですが、doc/plugin/ などのディレクトリを掘って
> >そこに plugin_name.{html,rd,txt} などのファイル名で
> >ドキュメントを置くのはダメなんでしょうか？
> 
> その方式の問題点のひとつは、インストールの手間がさらに増してしまうこと。
> 従来、本体だけコピーすればよかったのが、今では場合によっては言語リソース
> もコピーしなくてはいけない。その上ドキュメントも……となると、とてもプラ
> グインとは呼べないな、と。

なるほど、Officialなpluginは始めから入れておけばいいけど
個人個人で配布しているpluginは今よりも手間が増えてしまうって事ですね…
Officialなpluginのことしか考えてなかった(--;

で、思いついたのはどのみち、サードパーティ(？)pluginの場合
最低でも

1. plugin本体
2. 言語リソース(当面はen, ja?)

はインストールしないといけないわけですよね
だったらインストーラーをつけてしまうというのはどうなんでしょう？

インストーラーって言っても大げさな物ではなく
ruby install.rb setup; ruby install.rb install みたいな感じで。

そうすれば、現状でも面倒な、コピーの負担が減るし
doc/plugin/ 以下にドキュメントを置く場合で
サードパーティpluginの場合も同じ手間ですみますし

でも、そうすると敷居が高くなってしまうのかしら…
自分にはよくわからんですが

> もうひとつは、別のメールにも書いたように、CVSに入れちゃうとドキュメント
> を改善してくれそうな人の数を減らしてしまう(かも知れない)からです。これは
> 消極的な理由ですが。

ドキュメントコミット用のcvsレポジトリを作るとか :p

----
1024D/F6AC9AF9 2002-06-25 Mitsuru Shimamura (smbd) <mitsuru@...>
Fingerprint = B14F C51C FA61 3F7E 4D22 35DF 1384 2E7B F6AC 9AF9
http://smbd.homelinux.org/diary/
----

きたです．

> インストーラーって言っても大げさな物ではなく
> ruby install.rb setup; ruby install.rb install みたいな感じで。

これ，サーバにログインできる人じゃないとダメですよね．
コマンドラインから何か入力しないとダメってのも敷居高いような気がします．

plugin の URL を指定すると HTTP で fetch して適当なディレクトリ
(./site_plugin/ とか) にコピーするメソッドを conf_proc で登録して，設
定画面から plugin をインストールできるようにしてはどうか，と考えていま
す．

ただただしです。

きた <kita@...> wrote:
>> インストーラーって言っても大げさな物ではなく
>> ruby install.rb setup; ruby install.rb install みたいな感じで。
>
>これ，サーバにログインできる人じゃないとダメですよね．
>コマンドラインから何か入力しないとダメってのも敷居高いような気がします．

うん。「日常的にUNIX系OSを使っている人」の意見すぎ(笑)。

>plugin の URL を指定すると HTTP で fetch して適当なディレクトリ
>(./site_plugin/ とか) にコピーするメソッドを conf_proc で登録して，設
>定画面から plugin をインストールできるようにしてはどうか，と考えていま
>す．

面白いけど(同じようなことを考えたことはある)、セキュリティ的に不安な面は
あるなぁ。基本的にプラグインのコードは信用するというモデルだから、そのプ
ラグインファイルがクラックされてたりすると危ない。

まぁ、作ってみることに関しては止めません(笑)。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

ただただしです。

NISHIMURA Takashi <ni46rtk4@...> wrote:
>この度の国際化対応フレームワーク対応版で、windex.rb が動かなくなって
>しまいました。

これ、今回の改造の余波ですか? なんか、もともと動かないっぽく見えなくもな
いんだけど……(気のせいかもしれない)。

ちょっと見てみましたが、だいぶ手を入れないとダメみたい。Gonyさん見てない
かしら。もしくはメンテナ立候補者は?

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

windex作者のごにいです。はじめまして投稿させていただきます。

TADA Tadashi wrote:
>>この度の国際化対応フレームワーク対応版で、windex.rb が動かなくなって
>>しまいました。
> これ、今回の改造の余波ですか? なんか、もともと動かないっぽく見えなくもな
> いんだけど……(気のせいかもしれない)。

久しくCVS追っかけをしていなかったのと、いまや作者自身
使ってないこともあって、動かないというのを把握していませんでした。

大分ブランクがあるのでちょっと時間かかるかもしれませんが
対応しようと思います。
ところで、手元にいくらかいじくりまわした版があるのですが、
せっかくだからそちらをベースに動くものをこしらえようと思います。
しばしお待ちください。

--
郷古泰昭
mailto:gony@...

NT です。

すでにごにいさんが直してくださると書いてくださっていますので、
情報としてお知らせします。

> これ、今回の改造の余波ですか? なんか、もともと動かないっぽく見えなくもな
> いんだけど……(気のせいかもしれない)。

うちの 1.5.5.20030916 では正常に動きます。なので、今回の改造が
引き起こしたものかと。

-- 
NISHIMURA Takashi <ni46rtk4@...>
  GnuPG: 0F7B 4211 F62A E46C 0F6C  7CBD 2861 2D77 6BDF DFDA
  Website: http://246ra.ath.cx/~takasi/

ただただしです。

"NISHIMURA Takashi" <ni46rtk4@...> wrote:
>> これ、今回の改造の余波ですか? なんか、もともと動かないっぽく見えなくもな
>> いんだけど……(気のせいかもしれない)。
>
>うちの 1.5.5.20030916 では正常に動きます。なので、今回の改造が
>引き起こしたものかと。

あらー。すみません、適当なことを言って。しかしなんであそこでエラーが……。
ごにぃさんが見てくれるそうなので、待ちましょう。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

zundaです

どこかで見たかも〜とは思っていたのです…。ご指摘ありがとうございました。

 --- mput <root@...> からのメッセージ：
> mput です。
> 
> On 2003.09.29, at 20:49, zunda wrote:
> 
> > 01sp.rbの改造中に、@secure==trueな日記でプラグインがクッキーを追加しよう
> > とするとセキュリティエラー
> >   tdiary.rb:723:in `<<': Insecure: can't modify array (SecurityError)
> > になるという現象にでくわしました。
> 
> むかしうちの日記(@secure=true)で whatsnew が動かない!と思ってこちらの 
> ML で質問したのですが
> http://www.tdiary.net/archive/devel/msg00689.html
> 結局「 secure モードで @cookies を解放するのは危険すぎる」という結論
> だったように記憶しています。

http://www.tdiary.net/archive/devel/msg00690.html
ですね。

そういうわけで、以前のメールのパッチは当てないようにお願いします。


__________________________________________________
Do You Yahoo!?
Yahoo! BB is Broadband by Yahoo!
http://bb.yahoo.co.jp/

西山和広です。

In <43B9CE04-F28C-11D7-8894-000393735AAE@...>
On Mon, 29 Sep 2003 23:50:27 +0900
mput <root@...> wrote:
> > 01sp.rbの改造中に、@secure==trueな日記でプラグインがクッキーを追加しよう
> > とするとセキュリティエラー
> >   tdiary.rb:723:in `<<': Insecure: can't modify array (SecurityError)
> > になるという現象にでくわしました。
> 
> むかしうちの日記(@secure=true)で whatsnew が動かない!と思ってこちらの 
> ML で質問したのですが
> http://www.tdiary.net/archive/devel/msg00689.html
> 結局「 secure モードで @cookies を解放するのは危険すぎる」という結論
> だったように記憶しています。

それなら

    def add_cookie( cookie )
      @cookies << cookie
    rescue SecurityError
      raise SecurityError, "can't use cookies in plugin when secure mode"
    end

という感じでエラーメッセージを差し替えてしまえばいいのでは
ないでしょうか?


-- 
|ZnZ(ゼット エヌ ゼット)
|西山和広(Kazuhiro NISHIYAMA)

ただただしです。

Kazuhiro NISHIYAMA <zn@...> wrote:
>それなら
>
>    def add_cookie( cookie )
>      @cookies << cookie
>    rescue SecurityError
>      raise SecurityError, "can't use cookies in plugin when secure mode"
>    end
>
>という感じでエラーメッセージを差し替えてしまえばいいのでは
>ないでしょうか?

いいですね。そのままいただきました。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

きたです．

blogkitのカテゴリ機能を plugin として実装して先程コミットしました．
pluginディレクトリに category.rb をコピーするだけで使用可能になります．

使用方法は設定画面から「カテゴリ」を選択すると読めますのでそちらを読んで
頂くとして，特に注意すべき点だけ．

・カテゴリインデックスを初期化しないと使えません．設定画面から行えます．
・過去記事のタイトル中のカテゴリ表記をカテゴリ画面へのリンクにしたい場合
  は，@cache_path の latest.rb と yyyymm.rb を削除する必要があります．
・blogkit 付属の plugin のいくつかはカテゴリ対応できるよう修正しました．


さて，ちょっと別の話になりますが，今 core でアツい i18n 化を，いずれ 
blogkit でもしないといけませんねぇ．

で，i18n 化してリソースを別ファイルに分けると，いくつものファイルを 
plugin ディレクトリにコピーするのはウザイし，いちいち手で plugin ディレ
クトリにファイルをコピーという手順自体，今の core の流れに逆らっているの
ではないかと思います．

今の 01sp.rb では @conf['sp.path'] でプラグインのディレクトリを指定する
ことになっていますが，これを複数のディレクトリを指定できるようにしてみて
はどうでしょうか?

 -core-+-plugin-+-00default.rb
       |        +-01sp.rb
       |        +-ja-+-00default.rb
       |             +-01sp.rb
       |        +-en-+-00default.rb
       |             +-01sp.rb
       +-misc-+-plugin-+-プラグイン集の*.rb
       |               +-ja-上記の日本語リソース
       |               +-en-上記の英語リソース
       +-blogkit-+-plugin-+-blogkitのプラグイン
                          +-ja-上記の日本語リソース
                          +-en-上記の英語リソース

こんなイメージ．

複数のディレクトリを指定できるようになると，例えばサイトローカルの 
plugin とプラグイン集の plugin を別ディレクトリで管理できるようになりま
す．

いかが?

きたです．

blogkitのカテゴリ機能を plugin として実装して先程コミットしました．
pluginディレクトリに category.rb をコピーするだけで使用可能になります．

使用方法は設定画面から「カテゴリ」を選択すると読めますのでそちらを読んで
頂くとして，特に注意すべき点だけ．

・カテゴリインデックスを初期化しないと使えません．設定画面から行えます．
・過去記事のタイトル中のカテゴリ表記をカテゴリ画面へのリンクにしたい場合
  は，@cache_path の latest.rb と yyyymm.rb を削除する必要があります．
・blogkit 付属の plugin のいくつかはカテゴリ対応できるよう修正しました．


さて，ちょっと別の話になりますが，今 core でアツい i18n 化を，いずれ 
blogkit でもしないといけませんねぇ．

で，i18n 化してリソースを別ファイルに分けると，いくつものファイルを 
plugin ディレクトリにコピーするのはウザイし，いちいち手で plugin ディレ
クトリにファイルをコピーという手順自体，今の core の流れに逆らっているの
ではないかと思います．

今の 01sp.rb では @conf['sp.path'] でプラグインのディレクトリを指定する
ことになっていますが，これを複数のディレクトリを指定できるようにしてみて
はどうでしょうか?

 -core-+-plugin-+-00default.rb
       |        +-01sp.rb
       |        +-ja-+-00default.rb
       |             +-01sp.rb
       |        +-en-+-00default.rb
       |             +-01sp.rb
       +-misc-+-plugin-+-プラグイン集の*.rb
       |               +-ja-上記の日本語リソース
       |               +-en-上記の英語リソース
       +-blogkit-+-plugin-+-blogkitのプラグイン
                          +-ja-上記の日本語リソース
                          +-en-上記の英語リソース

こんなイメージ．

複数のディレクトリを指定できるようになると，例えばサイトローカルの 
plugin とプラグイン集の plugin を別ディレクトリで管理できるようになりま
す．

いかが?

きたです．
# 同じ内容のメールが3つもいってしまいました．すみません．

>今の 01sp.rb では @conf['sp.path'] でプラグインのディレクトリを指定する
>ことになっていますが，これを複数のディレクトリを指定できるようにしてみて
>はどうでしょうか?

これですが，昨日 #tDiary でたださんと相談したところ
1．プラグインの読み込み順どうする?
2．複数のディレクトリに異なるバージョンの同じプラグインがあったらどうする?
という問題を指摘されました．

2 に関しては，少なくとも tDiary の plugin 集と blogkit で名前に重複がな
いようにして，あとはサイト管理者に気を付けてもらう，というので良いと思い
ます．
# とか言っておきながら，blogkit のカテゴリも category.rb という名前にし
# てしまいました．blog_category.rb に名前変えようかな．今なら影響範囲狭
# いだろうし．

1に関してはどうしましょうね．
読み込み順も 01sp.rb で制御する? それはちょっとオーバースペックな気がし
ますね．

ただただしです。

Junichiro Kita <kita@...> wrote:
># とか言っておきながら，blogkit のカテゴリも category.rb という名前にし
># てしまいました．blog_category.rb に名前変えようかな．今なら影響範囲狭
># いだろうし．

これは変えた方がいいでしょう。少なくともオフィシャルな範囲では、プラグイ
ンファイル名はWorldwideで一意になっているべき。

>1に関してはどうしましょうね．
>読み込み順も 01sp.rb で制御する? それはちょっとオーバースペックな気がし
>ますね．

まぁ、すべてのディレクトリからリストアップしてから、ファイル名でソートす
れば従来と同じ意味にできると思います。だから同名プラグイン問題さえ解決す
れば、ほとんど問題ないでしょう。

━━━━━━━━━━━━━━━━━
ただただし <http://sho.spc.gr.jp/>
♪ツッコミは、短く鋭く愛を込めて。
━━━━━━━━━━━━━━━━━

きたです．

>Junichiro Kita <kita@...> wrote:
>># とか言っておきながら，blogkit のカテゴリも category.rb という名前にし
>># てしまいました．blog_category.rb に名前変えようかな．今なら影響範囲狭
>># いだろうし．
>
>これは変えた方がいいでしょう。少なくともオフィシャルな範囲では、プラグイ
>ンファイル名はWorldwideで一意になっているべき。

先程 blog-category.rb に名前を変えてコミットしました．
メソッド名やカテゴリインデックス名も接頭語 blog_ を付けるようにしました．