[▲前のスレッド]
[98] ヘルプのソースって　
▽ 2001/11/19 (月) 11:57:48 ▽ やざき 〔HomePage〕

はじめまして。みなさま。

HelpDesignerを使っていませんか？もしそうであれば、
ソースにHelpDesignerのHDPファイルもつけてほしいところです。

あれでは貢献しづらいし。。
[99] Re:ヘルプのソースって　
▽ 2001/11/20 (火) 12:53:17 ▽ やざき 〔HomePage〕

ふたたび参上しました。

まだまだ問題あるけど、サクラエディタのWindowsヘルプを
もっともっと貢献しやすそうなフォーマットに書き換えてます。

現在作成中のファイル
http://www.sam.hi-ho.ne.jp/makoto-y/download.html
に行って、sakura_z_20011111.zip：サクラエディタを
ダウンロードし、sakura_doc.txtを見て!!

ちなみに、手元でヘルプ化したいときは、
ActivePerlとか、HelpDesignerとか、Help Workshopが
必要〜。

では。コメントがあると励みになります。
[100] Re2:ヘルプのソースって　
▽ 2001/11/20 (火) 12:54:12 ▽ やざき 〔HomePage〕

> ダウンロードし、sakura_doc.txtを見て!!

できあがりのヘルプは、
help\sakura_z.hlpでした。

そちらも見てみてくださいませ。
[101] Re3:ヘルプのソースって　
▽ 2001/11/20 (火) 17:21:53 ▽ KENCH

▼ やざきさん
すとーにーさん作成のヘルプファイル(テキスト)から、逆に
いちじくファイルを作成するって事は可能なんでしょうか？
おそらく、すとーにーさんがいちじくファイルを作成する(文法を覚える)という行為を行うのは今までの流れがあるので簡単にはいかないのではと端から思ったりします。
たとえば、Winヘルプはすとーにーさんで、HTMLヘルプはやざき さんがこしらえるとかするといいかなぁぁなんて、個人的におもったりして、、、
[102] Re4:ヘルプのソースって　
▽ 2001/11/20 (火) 18:20:04 ▽ やざき 〔HomePage〕

▼ KENCHさん
> ▼ やざきさん
> すとーにーさん作成のヘルプファイル(テキスト)から、逆に
> いちじくファイルを作成するって事は可能なんでしょうか？
> おそらく、すとーにーさんがいちじくファイルを作成する(文法を覚える)という行為を行うのは今までの流れがあるので簡単にはいかないのではと端から思ったりします。
> たとえば、Winヘルプはすとーにーさんで、HTMLヘルプはやざき さんがこしらえるとかするといいかなぁぁなんて、個人的におもったりして、、、

いちじくファイルが、それほど（あらためて覚えなおすと意識するほど）
難しいと感じられるかどうか、まずは、すとーにーさんのご意見を
お聞きしたく。。。
[103] いちじくファイルの感想　
▽ 2001/11/20 (火) 23:05:06 ▽ げんた

ヘルプと関係ない話題ですみませんが．

>いちじくファイルが、それほど（あらためて覚えなおすと意識するほど）
>難しいと感じられるかどうか

発想はTeX，HTML，unix manなどと同じなのでしょうが，書式指定に日本語文字，それも視覚的にわかりやすい記号を用いることでソースコード自身の可読性を高めようとしているのが特長だと感じました．

ただ，わかりやすい反面入力は面倒くさそう．というのは頻繁に使う書式指定に記号類(丸文字，■，⇒【】)がなかなか漢字変換で出てこなくて記号を拾ったり辞書登録したりする必要があるからです．

例えば ⇒【見よ】と@link[見よ] を比べたら前者の方が視覚的にはわかりやすいですが，後者の方が入力は圧倒的に楽だと思います．

そこで改善案として，記号の代わりに上の例のような半角の文字列を特殊文字に使うようにした上で，既存の形式と相互変換できるようにするというのはどうでしょうか．

＃ 私はすとーにぃさんのソースを見ていないので，「現状」と比べているわけではありません．あくまで自分が使いたいかどうかと言う話です．

あと，jperl必須というのも何とかプログラムでがんばって無くして欲しいなぁ．私は最新のActivePerlを入れているので，今更入れ直す気にはなりません．
[104] Re:いちじくファイルの感想　
▽ 2001/11/21 (水) 01:13:44 ▽ やざき 〔HomePage〕

▼ げんたさん
> ヘルプと関係ない話題ですみませんが．

こちらこそ、つづけてしまってすみませんが。
いちじくが、どうだ。という話をすると、


> ただ，わかりやすい反面入力は面倒くさそう．というのは頻繁に使う書式指定に記号類(丸文字，■，⇒【】)がなかなか漢字変換で出てこなくて記号を拾ったり辞書登録したりする必要があるからです．

逆にいえば、辞書登録すれば、入力も簡単だし、わかりやすい。
ってことですね :-) 賞賛と受け取りました。
ありがとうございまする。


> あと，jperl必須というのも何とかプログラムでがんばって無くして欲しいなぁ．私は最新のActivePerlを入れているので，今更入れ直す気にはなりません．

最新のActivePerlで動くようにするパッチを期待します :-D

きわめてわかりやすい解説本か、ホームページがあれば、
なんとかなるかもしれませんが、私の実力ではきわめて
困難かと。ちなみにそういった本やらホームページを
ご存知ですか？
[105] Re5:ヘルプのソースって　
▽ 2001/11/21 (水) 13:59:07 ▽ すとーにぃ 〔HomePage〕

▼ やざきさん
> ▼ KENCHさん
> > ▼ やざきさん
> > すとーにーさん作成のヘルプファイル(テキスト)から、逆に
> > いちじくファイルを作成するって事は可能なんでしょうか？
　これがほしいです。(^-^;)
　「ヘルプ用RTFの文法は既に知っているが、いちじくはまだ知らない」
　という人がヘルプを修正するときに、RTFを直接いじりたいケースがあると思うので。
　HelpDesignerを利用していない理由もこれ(RTF→HelpDesigner形式ができなかった)です。

> いちじくファイルが、それほど（あらためて覚えなおすと意識するほど）
> 難しいと感じられるかどうか、まずは、すとーにーさんのご意見を
> お聞きしたく。。。
　これは既にあるサンプルをいじればよいのかな。。。


　sakura.hhファイルも自動生成しているのでしょうか？
　SAKURA_Z.hlpをsakura.hlpと改名してsakura.exeと同じフォルダに
配置すると、ヘルプのトピック番号の対応付けが正しくされず、
「メニューを選択してF1」とポップアップヘルプの機能が誤動作します...


＃Perlは不案内(;_;)
[107] Re6:ヘルプのソースって　
▽ 2001/11/21 (水) 22:54:49 ▽ やざき 〔HomePage〕

▼ すとーにぃさん
> ▼ やざきさん
> > ▼ KENCHさん
> > > すとーにーさん作成のヘルプファイル(テキスト)から、逆に
> > > いちじくファイルを作成するって事は可能なんでしょうか？
> 　これがほしいです。(^-^;)
> 　「ヘルプ用RTFの文法は既に知っているが、いちじくはまだ知らない」
> 　という人がヘルプを修正するときに、RTFを直接いじりたいケースがあると思うので。
> 　HelpDesignerを利用していない理由もこれ(RTF→HelpDesigner形式ができなかった)です。

残念ながら、難しいでしょうね。
いちじくは、
・や、1（半角数字）、−などに、タブ文字を続けて書きます。
変換時は、主にタブ文字をレイアウト情報として解釈していきます。

ところが、すとーにぃさんが作られているヘルプでは、
とくにそのあたりを厳密に作られていないようですので、
いちじくファイルに変換するのは難しいのではないかと思います。


逆に、いちじくなら、RTFを知らなくても（そもそもいちじくを知らなくても）
なんとなく書けてしまうし修正もできてしまうという点で、
貢献者を増やすことは期待できないでしょうか？


> > いちじくファイルが、それほど（あらためて覚えなおすと意識するほど）
> > 難しいと感じられるかどうか、まずは、すとーにーさんのご意見を
> > お聞きしたく。。。
> 　これは既にあるサンプルをいじればよいのかな。。。

そうですそうです。(^-^)
すとーにぃさんが見た感じで、RTFといちじくファイルで、
どちらにも不慣れな人が、このプロジェクトに貢献すると
いう点でどちらがよさそうですか？？


> 　sakura.hhファイルも自動生成しているのでしょうか？
> 　SAKURA_Z.hlpをsakura.hlpと改名してsakura.exeと同じフォルダに
> 配置すると、ヘルプのトピック番号の対応付けが正しくされず、
> 「メニューを選択してF1」とポップアップヘルプの機能が誤動作します...

ああそうか、sakura.hhを混ぜないといけませんね。
すっかり忘れてました。sakura.hhを混ぜるように改変してアップロードしなおしときます。
[108] Re7:ヘルプのソースって　
▽ 2001/11/22 (木) 01:21:21 ▽ やざき 〔HomePage〕

> > 　sakura.hhファイルも自動生成しているのでしょうか？
> > 　SAKURA_Z.hlpをsakura.hlpと改名してsakura.exeと同じフォルダに
> > 配置すると、ヘルプのトピック番号の対応付けが正しくされず、
> > 「メニューを選択してF1」とポップアップヘルプの機能が誤動作します...
>
> ああそうか、sakura.hhを混ぜないといけませんね。
> すっかり忘れてました。sakura.hhを混ぜるように改変してアップロードしなおしときます。

というわけで、アップロードしました。
http://www.sam.hi-ho.ne.jp/makoto-y/sakura_z_20011122.zip
です。

この作業をしているときに気が付いたことを書いておきます。

-----
sakura.hhですが、

#define HLP000300        300 //ファイルタイプ
#define HLP000300        301 //スマートインデント
#define HLP000301        302 //色設定ファイル

となっていますが、

#define HLP000300        300 //ファイルタイプ
#define HLP000301        301 //スマートインデント
#define HLP000302        302 //色設定ファイル

ではありませんか？

＃こちらで公開したファイルは、後者に修正してしまいました。

-----
それから、RTFファイルの中の
「目次」のヘルプIDは、HLP000100
「キーワード検索」のヘルプIDは、HLP000101

CNTファイル、HHファイルの中の
「目次」のヘルプIDは、HLP000101
「キーワード検索」のヘルプIDは、HLP000100
となっているので、CNTファイルからたどると、
表示されるトピックが食い違うみたいです。

＃こちらで公開したファイルは、CNTファイルにあわせて、RTFファイルに書かれているIDを変えました。
-----

以上です。
[110] Re7:ヘルプのソースって　
▽ 2001/11/22 (木) 19:30:18 ▽ みく

いったんいちじくで整形しておいてRTFにすれば、
その後はRTF→いちじく変換が容易になりませんか？
RTF→いちじく変換ができれば、いちじくに移行
するユーザも増えて一石二鳥と。
いずれにしても、やざきさんのおかげでヘルプの
バグが取れてるので感謝感謝です。
[111] Re8:ヘルプのソースって　
▽ 2001/11/22 (木) 23:45:47 ▽ やざき 〔HomePage〕

▼ みくさん
> いったんいちじくで整形しておいてRTFにすれば、
> その後はRTF→いちじく変換が容易になりませんか？
> RTF→いちじく変換ができれば、いちじくに移行
> するユーザも増えて一石二鳥と。

鋭い洞察ですね。確かに、いちじく＋HelpDesignerで
作ったRTFを使えば、RTF→いちじく変換はうまく行くかも。

でもそのRTFを修正した後でも→いちじく変換がうまく行くかは、
やっぱり怪しいかなぁ。

> いずれにしても、やざきさんのおかげでヘルプの
> バグが取れてるので感謝感謝です。

そういっていただけると、励みになります :-)


Perlを使わねばっていうのが、敷居が高くなってしまっているのかなぁ。> いちじく
[112] Re8:ヘルプのソースって　
▽ 2001/11/23 (金) 00:18:49 ▽ げんた

>Perlを使わねばっていうのが、敷居が高くなってしまっているのかなぁ。> いちじく
いっそのこと全面的にHTML HELPに移行した方が市販HTML編集ツールを使えるので敷居は低くなるかも．
ただ，Windows Helpを切り捨ててHTMLヘルプ必須にするのはWin95とかを使っている人に申し訳ないような気がします．

Perlを常にインストールするような比較的パワーユーザに近い人は，いちじくは全角の記号類を多用するから入力面でTeXやRTFに劣っていると感じるってことは無いでしょうか．少なくとも私はあまり乗り気でないです．見るからに入力しにくそうなので．
[114] Re9:ヘルプのソースって　
▽ 2001/11/23 (金) 00:52:44 ▽ やざき 〔HomePage〕

▼ げんたさん
> Perlを常にインストールするような比較的パワーユーザに
>近い人は，いちじくは全角の記号類を多用するから入力面で
>TeXやRTFに劣っていると感じるってことは無いでしょうか．
>少なくとも私はあまり乗り気でないです．見るからに入力し
>にくそうなので．

それは残念ですね。TeXとかRTFを書けないと
こういったプロジェクトに参加できないというのが残念。

また、TeXやRTFに入力面で劣っていると感じるか、という
のは、いろいろな人の意見を伺いたいところですね。
どうでしょうか？

私は、「リンク」と入力したら「⇒【■】」がでてくるように
単語登録しているだけですね。少し入力していれば、
「しかく」と入力したら「■」が早い段階で変換候補に
でてきますから、特に不便に思ったことは無いです。

{の閉じ忘れなどを気にしないで、文章に集中できるか
という点では、いちじくのほうが優れていると思います。


別の視点になりますが、たとえば今まで文章だけで
説明していたところを箇条書きにしたほうがわかりやすそう
だから、変えたい。というときに、より修正しやすいのは、
どちらでしょうか？
私は、その点いちじくの方が優れていると思います。


もちろん総合的な表現力で、RTFに軍配が上がるのは
当然のことです。

p.s.
ヘルプの修正に参加したいと思う人は、
プログラムはかけないけど、文章ならなんとか。
と思っている人たち、だと思うので、
そういった人たちにTeXとかRTFのほうが入力しやすいぜ!
って言うのも少し的外れな気がしないでもないです。
[▼次のスレッド]
INCM/CMT
Cyclamen v3.81