[スレッド全体]

[376] Re4:ヘルプソースの管理・運用変更案 
2007/10/7 (日) 21:51:21 maru

>いいえ、これは、コンパイル後の中間ファイルも公開しましょうと言うことで、そうすればヘルプましんの出力が変わっても分かるという意味です。
>バイナリーファイルでもヘルプましんでUI出来る訳ですから、SVNで管理出来ないと言う訳は無いと思ったのですが。

う〜ん、おっしゃることは理解できましたが、これだけでは私的には旨みがないですね・・・。

>HELP WorkShopのUIが使用できないと言うのが主な理由です。
えっと、まったく使えないわけではなく、一番最後の</UL>が変なところに挿入されてしまうのです。mergeの指定が<UL></UL>の内側に入ってしまいます。
もしコンテンツツリーの編集をWorkshopで行う場合は、最後の<UL>を修正する作業を追加すれば解決します。
そういうことであれば、Workshopでの編集+UL修正、という運用でも私は構いませんので、やはりヘルプましんからの離脱を推進したいのですが、いかがですか。

理由は前回書き込みのデメリット4〜9のためです。

[377] Re5:ヘルプソースの管理・運用変更案 
2007/10/8 (月) 12:26:22 じゅうじ

▼ maruさん
> ■ヘルプましんで管理するデメリット
> 3.コンテンツツリーがバイナリで保存されているので、変更点がわかりにくい。
> 4.コンテンツツリーがバイナリで保存されているので、パッチ配布できない。
> 5.コンテンツツリーがバイナリで保存されているので、別々の修正をマージできない。
> 6.コンパイル前には、hhp内のパス指定を修正しなければならない
> 8.ソース配布前には、XHP内のパス指定を修正しなければならない
>
> ■ヘルプましんで管理するメリット
> 1.UIが日本語
> 2.ヘルプましんからコンテンツツリー構造を変更・保存してもmerge指定が壊れない


A. HTML HELP Workshop で管理するメリット
1.Wikiサイトの管理との関連で、ヘルプましんのGUIは使いたくない、3と4が主な理由。
2.リリース時の手間の問題で、ヘルプましんのXHP,HHPは使いたくない、6と8が主な理由。

B. HTML HELP Workshopで管理するデメリット
1.GUIからCUIに移行する(GUIが英語で使い方が難しい)
2.GUIからコンテンツツリー構造を変更・保存するとmerge指定が壊れる

まとめるとこんな感じでしょうか、私はテキストのXHPも,バイナリーのXHCも更新出来れば更新を続けて欲しいと思います。

さて、HHPについてです。
リリースや、パッチにXHP,XHCは含めないという事でしたら、
毎回ヘルプましんのGUI出力ファイルを使う、B2の問題の為、HTML HELP Workshop のGUI出力ファイルは使わない。
(提供は出来ないが、XHP,XHCは何時でも手元に有るという状態)
A2以外、テキストファイルを直接編集しなくても良くなります。

[378] Re6:ヘルプソースの管理・運用変更案 
2007/10/8 (月) 19:43:10 maru

>リリースや、パッチにXHP,XHCは含めないという事でしたら、
ちょっと違います。「(サクラエディタのヘルプ作成において)ヘルプましんは作業性が悪いから使いたくない」です。

>(提供は出来ないが、XHP,XHCは何時でも手元に有るという状態)
これまた厳しいリクエストで・・・(^^;;
別件で Document/コンテンツツリー にパッチをアップされていらっしゃいますが、これをXHCに反映するのはかなり面倒なはずです。
手順としては
1.XHP,XHCからhhcを作成
2.hhcにパッチをあてる
3.新しいhhc「Workshopプロジェクトの取り込み」でXHCに吸い上げる
4.ヘルプましんが解釈できない部分(アンカーネームなど)を元ファイルを見ながら目視・手修正
のようなプロセスになるかと思います。
「XHP,XHCは何時でも手元に有る」というのは、そういう意味(パッチ提供を受けたらXHCを更新できることを保証する)ですよね?

>テキストファイルを直接編集しなくても良くなります。
あれ?直接テキストを編集したほうが手軽だと思うのですが。
ちょっとした修正のためだけに、いちいち関連ファイルを改変されると、それを元に戻すオーバーヘッドがものすごく無駄に思えてくるのです。
まあ、これは個人の好みに左右されますが。ヘルプましんではグラフィカルなインターフェィスしか利用できないのに対して、Workshopではグラフィカルなインターフェィスまたはテキストの直接編集どちらでもユーザーは好きなほうを選べるのです。これって素敵だと思いませんか?

[379] Re6:ヘルプソースの管理・運用変更案 
2007/10/8 (月) 20:10:25 AC

全部管理するのが理想。
そんなリソースはないというのが現実。


[381] Re7:ヘルプソースの管理・運用変更案 
2007/10/8 (月) 23:36:46 じゅうじ

▼ ACさん
> 全部管理するのが理想。
> そんなリソースはないというのが現実。


 ツールを何にするかで揉めています。
この様子だと、ヘルプましんは使えなく(サクラエディタでは使用禁止)なりそうです。
しかし、よく見ると、ヘルプリリース1.6.0.0のhhcがHTML Workshopの出力と微妙に異なります。
新規作成は、HTML Workshop以外の何かのツールで、既に終わってるようなのです。

#このHELP Documentスレって上がらないですね。

[384] Re8:ヘルプソースの管理・運用変更案 
2007/10/9 (火) 19:48:46 AC

ヘルプましんに固執する理由がわかりません。

今は問題があるけど、改善されれば使えるというのであれ
ば、ヘルプましん作者に改善要望を出してみてはいかがで
しょうか。

[385] Re9:ヘルプソースの管理・運用変更案 
2007/10/9 (火) 21:03:29 じゅうじ

▼ ACさん
> ヘルプましんに固執する理由がわかりません。

ヘルプましんを使った場合、具体的には出力されるHHPファイルにフルパスが含まれる事です。
HHPファイルは、HELP Workshopの入力となる、テキストファイルですから、エディタでそのフルパスを削除すれば使えます。
後、ヘルプましんは操作がGUIのみで、使い方を覚えなければいけないんですが...。
私は、HELP WorkshopのGUIが日本語でも全然分からないので、後残るは hhp,hhc,hhk をエディタで直接編集するしか無い訳で、それはかなり面倒だと思います。
HTML Workshopにするという事であれば、固執していません。

[391] Re9:ヘルプソースの管理・運用変更案 
2007/10/10 (水) 21:15:34 AC

ヘルプましんのHP見てきたんですけど、
放置プレー状態ですね。
(改善要望は無理っぽい

[393] Re10:ヘルプソースの管理・運用変更案 
2007/10/10 (水) 23:29:47 maru

>ヘルプましんのHP見てきたんですけど、
>放置プレー状態ですね。

そうなんですよ(涙)
いくつかの要望に対しては前向きなコメントをいただいたのですが、更新される気配の無いまま1年が経過・・・。
良いソフトなのに、ほぼ開発休止中といった感じで残念です。

[▼次のスレッド]
INCM/CMT
Cyclamen v3.81