tDiary

むとうです。

こんばんわ。

On Fri, 29 Mar 2002 16:26:42 +0900
Masao Mutoh <mutoh@highway.ne.jp> wrote:

> 大変遅くなりましたが、yasqueezeを
> @options対応してCVSにアップしておきました。

さっそくですが、バグってました。
最新版をCVSにアップしました。

ところで、ChangeLogの方も書き直した方が良いのでしょうか？

それでは。
-- 
.:% Masao Mutoh<mutoh@highway.ne.jp>

ただただしです。
返事遅くてすみません。

　なんかコードを読む元気がなくて、ざっとしか見てないんだけど、こんな
方向性でいいんじゃないかと思います。＃使ってる? >kitaj

＃ところでこのコード、tab=4?

　あとはドキュメントか……。pluginの中にyasqueezeってディレクトリを
掘っちゃうか、yasqueeze.rb内にドキュメントへのURLを書くか。

On Fri, 29 Mar 2002 22:21:42 +0900 "Masao Mutoh" <mutoh@highway.ne.jp> wrote:
>ところで、ChangeLogの方も書き直した方が良いのでしょうか？

　coreのChageLogですか?　pluginの変更は最近はcoreには書いてません。
かといって代わりはないんですが(^^; 小さいのは.rb内に書いちゃってるし。
やっぱドキュメントが大きいのや、複数ファイルから成立してるpluginは、
ディレクトリを掘った方がいいかも知れません。その方向でやっちゃって
くれちゃっていいですよ >むとうさん

　この辺が落ち着いたら1.4.1にしちゃいましょう。

■■ Don't Think, Buuuuy. ■■
■  た   だ   た   だ   し  ■
■http://www.spc.gr.jp/sho/ ■

むとうです。こんばんわ。


On Sun, 31 Mar 2002 00:56:20 +0900
TADA Tadashi <sho@spc.gr.jp> wrote:

> ただただしです。
> 返事遅くてすみません。
> 
> 　なんかコードを読む元気がなくて、ざっとしか見てないんだけど、こんな
> 方向性でいいんじゃないかと思います。＃使ってる? >kitaj
> 
> ＃ところでこのコード、tab=4?

えっと、Emacsのruby-modeのままです。確かに他のエディタで読むと
おかしくなりますね。
とりあえず、TABをスペースに変換してアップデートしました。
＃保存するとき、自動的にTABをスペースに変換する方法ってどうすれば
＃良いんでしたっけ(^^;)。
 
> 　あとはドキュメントか……。pluginの中にyasqueezeってディレクトリを
> 掘っちゃうか、yasqueeze.rb内にドキュメントへのURLを書くか。
>
> On Fri, 29 Mar 2002 22:21:42 +0900 "Masao Mutoh" <mutoh@highway.ne.jp> wrote:
> >ところで、ChangeLogの方も書き直した方が良いのでしょうか？
> 
> 　coreのChageLogですか?　pluginの変更は最近はcoreには書いてません。
> かといって代わりはないんですが(^^; 小さいのは.rb内に書いちゃってるし。
> やっぱドキュメントが大きいのや、複数ファイルから成立してるpluginは、
> ディレクトリを掘った方がいいかも知れません。その方向でやっちゃって
> くれちゃっていいですよ >むとうさん

もしかして、たださんの意図からずれちゃうかもしれませんが、勝手に以下の
ようにさせていただきました。

plugin/doc/
        index.html
        search_form.html
        yasqueeze.html
        doc.css
          /rd/
              makeindex.rb
              makehtml.rb
              search_form.rd
              yasqueeze.rd

makeindex.rbは各rdファイルからH1部分と「機能」段落の最初の空行までから
index.htmlを生成します。

makehtml.rbは各rdファイルからhtmlファイルを生成し、かつmakeindex.rbを
呼び出します。

ドキュメントですが、書き方を以下のようにしようかなと思います。
＃www.tdiary.net/howto.rhtmlに倣っています。
この通りに書いてrdディレクトリに放り込み、makehtml.rbを実行すると自動的に
HTMLファイルが生成され、かつindex.htmlにも含まれます。
＃RDToolが必要です。

----------ここから-------------------
=begin
= hoge.rb - ホゲホゲプラグイン　←タイトル index.htmlで読み込まれる
== 機能
機能概要　　　　←　一つ目の段落がindex.htmlに読み込まれる
：　　　　　　　←
：　　　　　　　←

：　　　　　　　←　2つ目の段落からはindex.htmlには読み込まれません。
：

== 使う場所
本文、ヘッダもしくはフッタ

== 利用方法
説明、パラメータの説明など（この辺は書きやすいように適宜）

--- method_name(foo, bar)  ←　メソッド名
    説明、パラメータの説明など（この辺も書きやすいように適宜）

 例： <%= method_name "foo", "bar" %>

== 表用例
((: <hogehoge> :))   ← ((:, :))はHTMLをそのまま展開しますが、改行を含むことはできません

== ライセンスについて
== メンテナ
== ChangeLog
:2002-03-29  MUTOH Masao  <mutoh@highway.ne.jp>
    * version 1.0.0
=end    

----------ここまで-------------------
懸案・確認事項です。

1. そもそもこの形態で良いか？
2. HTMLはRDから生成されるものとするとCVSには入れない方が良いのではないか
3. CVSに入れるので$Id$とかを取りたいが、HTML, RDのどちらに入れた方が良いのか

コメントいただけるとありがたいです。

それから、もし1.でOKということであれば、他のプラグインについてもRD書きますけど、
どうでしょう？

> 　この辺が落ち着いたら1.4.1にしちゃいましょう。

ドキュメントを一緒にリリースするのは、懸案・確認事項がクリアになってからの方が良いと思います。

しかし、ドキュメントはしばらく私のホームページにも載せておきますので、必須ではない
と思います。
したがって、この方向で問題があるようでしたら、ドキュメントの整備の遅れと1.4.1のリリースは
リンクさせないでいただけると助かります。

それでは。

-- 
.:% Masao Mutoh<mutoh@highway.ne.jp>

むとうです。

たださん、きたさん、リプライどうもです。

On Sun, 24 Mar 2002 22:23:55 +0900
TADA Tadashi <sho@spc.gr.jp> wrote:

> >・yasqueeze.confの別出し
> >　ファイルが増えることに対し若干抵抗があったのですが、たださんの指摘
> >　にもありましたように、今後のバージョンアップを考えるとこちらの方が
> >　良いかなと思います。なお、このファイルはyasqueeze.rbと同じディレク
> >　トリにある必要があります（ここがちょっとイケテナイですが）。
> 
> 　これなんですが、コマンドラインから実行するときはコマンドラインオプ
> ション指定が使えるので、CGIとプラグインとして実行するときだけ外部か
> らオプションを与える方法を考える必要があるわけです。CGIはユーザ別に
> 存在するはずなので、従来通り.rb書き換えでも目的は達成できる。

確かにそうですね。ただ、これであればconfファイル別出しでも対応は
可能ですよね...。
 
> 　残るプラグインは複数ユーザで共有されてしまうので、この場合を考慮す
> ると、.rbと.confが同じディレクトリに存在しては意味がないですよね。こ
> こはやはり、tdiary.confから任意のプラグインにオプションが渡せないと
> ダメっぽいです。ちょっと方法を考えてみます。たぶん、@optionsみたいな
> Hashに、任意のキーで登録できるようにすると思います。

なるほど...。これは考えてませんでした...。

ちょっと気になったんですが、tDiaryを共有するユーザは、
pluginディレクトリに置いてあるプラグインは全て使えるわけですね。
つまり、pluginディレクトリに対するアクセス制限がないってことですよね。

add_*_proc系のメソッドって、ユーザによって使用する・しないを選択できない
のでこれらを用いるプラグイン開発者側はtDiaryに使用するかしないかのフラグを
必ず用意し、これらのメソッドを呼び出す際にはif文をつけるようにしないとですね。

  add_update_proc(Proc.new{"hoge"}) if @options["use"]

みたいな感じです。

あ、でも、管理者側で強制的に使わせたいadd_*_proc系のプラグインがあるかも
しれませんね。

  add_update_proc(Proc.new{"hoge"}) if manager_options["use"] or @user_options["use"] 

ってな感じでしょうか。あ、でも、特定のユーザのみ強制的に使わせたいなんて
場合もありそうな。うーむ。
＃最近ちょっと考えすぎるみたいです...。

> >ドキュメントは元々RDベースで作ってありますのでそちらも添付し、さらに
> >makehtml.rbというRD -> html化ツールも添付しました。元々のRDToolと
> >比べると、若干独自ルールがあります。
> >それから、doc.cssもつけました。これはtDiaryのdoc.cssをベースにして
> >makehtml.rb(というか素のRDToolでもそうだと思います)で生成するファイル
> >に対応できるようにちょこちょこいじったものです。
> 
> 　プラグインのドキュメントについてはちょっと考えないといけないですね
> ……。いままではソースにちょこっと書けば済むレベルのものだったので。

最初はそうしようと思ったんですが、どうも、私はドキュメントを多めに書いてしまう
癖があるようです(^^;)。
ちなみにmakehtml.rbはyasqueeze.rb専用とお考えください。
これ使った方が私的には楽になりますんで一緒に入れておきました。
＃私のようにvalidなHTMLをガシガシ書くことのできない人間にとっては
＃RDで書くのがすごく楽ですんで。
 
> >ところで、今後、CVS版に対するパッチはどなたに送ればよろしいでしょうか。
> >実は、もうちょっとだけ私の方でもいじりたいなぁと思ってるんですが...。
> (snip) 
> >tDiaryの開発者向けのMLとかってあるんですか？
> >あれば参加したいのですが。
> 
> 　SourceForgeの方にtDiary-develを用意してあります。publicになってい
> るので、よろしかったら参加してください。アカウントがあれば、commit権
> 限も出せます。

さっそく、tDiary-develに入りました。

それから、お言葉に甘えて、さっそくアカウントを作りました。

mutoh

です。よろしくお願いします。
＃mutohそのままで取れるとは思いませんでした....。

それでは。
-- 
.:% Masao Mutoh<mutoh@highway.ne.jp>

ただただしです。

　ちと遅くなりましたが、今日のcore commitでyasqueeze救済(?)のための
@options変数を導入しました。むとうさん、これで何かできません? 

On Sun, 24 Mar 2002 22:58:53 +0900 "Masao Mutoh" <mutoh@highway.ne.jp> wrote:
>ちょっと気になったんですが、tDiaryを共有するユーザは、
>pluginディレクトリに置いてあるプラグインは全て使えるわけですね。
>つまり、pluginディレクトリに対するアクセス制限がないってことですよね。

　そうです。この辺をどこまでユーザの自由に任せるかは、これまたバラン
スが難しいところなんですが、複数ユーザに日記を提供する場合は管理者が
強権を持っていてもいいんじゃないか、というのが私のスタンスです。イヤ
なら自分で設置するという選択肢がtDiaryにはあるわけで。

　というわけで、

>add_*_proc系のメソッドって、ユーザによって使用する・しないを選択できない
>のでこれらを用いるプラグイン開発者側はtDiaryに使用するかしないかのフラグを
>必ず用意し、これらのメソッドを呼び出す際にはif文をつけるようにしないとですね。
>
>  add_update_proc(Proc.new{"hoge"}) if @options["use"]

ここまではやらなくていいだろうと。@optionsは設定画面から変更できませ
んから、そもそもこういう指定はできないですし。



■■ Don't Think, Buuuuy. ■■
■  た   だ   た   だ   し  ■
■http://www.spc.gr.jp/sho/ ■

むとうです。こんばんわ。

なんか昨晩から今日にかけていろいろとアホなことしてます。
＃仕事でも(^^;)

On Tue, 26 Mar 2002 23:07:35 +0900
TADA Tadashi <sho@spc.gr.jp> wrote:

> ただただしです。
> 
> 　ちと遅くなりましたが、今日のcore commitでyasqueeze救済(?)のための
> @options変数を導入しました。むとうさん、これで何かできません? 

素早い対応ありがとうございます。
これから見てみます（今日は無理かも(^^;)）。 
 
> On Sun, 24 Mar 2002 22:58:53 +0900 "Masao Mutoh" <mutoh@highway.ne.jp> wrote:
> >ちょっと気になったんですが、tDiaryを共有するユーザは、
> >pluginディレクトリに置いてあるプラグインは全て使えるわけですね。
> >つまり、pluginディレクトリに対するアクセス制限がないってことですよね。
> 
> 　そうです。この辺をどこまでユーザの自由に任せるかは、これまたバラン
> スが難しいところなんですが、複数ユーザに日記を提供する場合は管理者が
> 強権を持っていてもいいんじゃないか、というのが私のスタンスです。イヤ
> なら自分で設置するという選択肢がtDiaryにはあるわけで。

なるほど、了解です。
 
> 　というわけで、
> 
> >add_*_proc系のメソッドって、ユーザによって使用する・しないを選択できない
> >のでこれらを用いるプラグイン開発者側はtDiaryに使用するかしないかのフラグを
> >必ず用意し、これらのメソッドを呼び出す際にはif文をつけるようにしないとですね。
> >
> >  add_update_proc(Proc.new{"hoge"}) if @options["use"]
> 
> ここまではやらなくていいだろうと。@optionsは設定画面から変更できませ
> んから、そもそもこういう指定はできないですし。

こちらも了解です。

それでは。

P.S.
今度はきちんとMLにメールが流れるでしょうか....ちょっと心配(^^;)。

-- 
.:% Masao Mutoh<mutoh@highway.ne.jp>