39

昔は、ヘルプは簡単ではありませんでしたが、可能でした。特別なタグを付けたファンキーな .rtf ファイルを生成し、コンパイラで実行すると、実際にうまく機能する WinHelp ファイル (.hlp) が得られました。

その後、Microsoft は、WinHelp はもはやヒップでもクールでもないと判断し、CHM に切り替え、実際に Vista から WinHelp を廃止しました。

さて、CHM は便利かもしれませんが、ネットワーク上で .chm ファイルを開こうとした人なら誰でも、セキュリティ上の制限が原因で「Web ページへのナビゲーションがキャンセルされました」という素敵な画面が表示されることを知っているでしょう。

CHM をネットワーク外で動作させる方法はありますが、これはあまり良い選択ではありません。なぜなら、ユーザーが [ヘルプ] ボタンを押すと、ヘルプが必要になり、ファンキーな設定を行う必要がなくなるからです。

結論: CHM は絶対に使えないと思います。しかし、WinHelp ももうオプションではないので、特にアプリケーションと統合する場合 (つまり、WinHelp と CHM の場合、トピックに直接ジャンプできる機能があります)、代替手段は何だろうかと思います。

PDF には、Adobe Reader (または、多くの人が使用していないより軽量なもの) が必要であるという欠点があります。これは最近の標準のようなものなので、私はそれを見て暮らすことができますが、特定のページ/アンカーにジャンプするように確実に伝えることができますか?

HTML ファイルが最良の選択のようです。その場合は、さまざまなブラウザー (CSS など) を処理する必要があります。

編集:独自のヘルプ ファイルを作成しようとしています。私は「セットアップなし、抽出して実行するだけ」の哲学のファンであるため、多くのユーザーがネットワークからそれを実行するため、過去に何度もこの問題が発生し、まさにこの問題が発生しました。

そのため、作成するアプリケーションごとに異なるヘルプ システムをコーディングすることなく、ユーザーにヘルプを提供する、より堅牢で将来性のある方法を探しています。

CHM は非常に優れた形式ですが、ヘルプ システムはユーザーにヘルプを提供するものであり、さらに問題を発生させないものであるため、セキュリティ スタッフが使用できないものになっています。

4

10 に答える 10

14

HTML は、パブリック Web サーバーから提供する場合にのみ、次善の選択肢になります。アプリにバンドルしようとすると、すべてのファイル (および画像 (およびスタイルシート (および ...) )) により、CHM は神からの贈り物のように見えます。

そうは言っても、(ネットワーク経由で提供されるのではなく) 実際にインストール パッケージにバンドルされている場合、CHM ファイルが適切に機能することがわかりました。

OTOH、CHM ファイルに関するもう 1 つの落とし穴:ローカルディスク上の CHM ファイルを開こうとしても、最初にどこかからダウンロードした場合は、ファイルが「外部ソースから来た」とマークされる可能性があるため、セキュリティ ブロックにぶつかる可能性があります。取得したとき。

于 2008-08-04T10:51:39.560 に答える
5

私は html オプションが好きではありません。実際にはプレーン HTML から CHM に圧縮して索引付けすることで移行しました。Windows 以外の少数の顧客でさえ、それらを使用しています。それは、ネットワーク上に置く人々の絶え間ない小さな破損(ネストの深さの制限、奇妙なロック効果)、30000のhtmlファイルを含むディレクトリで死んだウイルス対策、および古いシステムへのインストール時の20分の解凍時間、ブラウザの安全地帯と機能、インストーラーに必要なスペースの計算ミスなど。

そして、それらを「修正」し始めた人、「統合」の試行に失敗したサードパーティ製品など、遅さ(ブラウザの起動)についての苦情は含まれていません。

OS とハードウェアが改善されて問題が解決するのを何年も待っていましたが、問題は驚くほど多くの種類で再発し続け、それで十分でした。私たちは chmlib を発見し、OS が提供するものが機能しなくなって切り替えられた場合に、単純な外部リーダーを使用したエスケープとして、これに基づいたものを永遠に使用できると判断しました。

一方、独自のコンパイラも備えているため、将来的にも MS フリーです。これは決して変更しないという意味ではありません (最近ではローカル Web サーバーを使用したソリューションが人気のようです) が、少なくとも選択の余地はあります。

于 2009-09-06T00:03:19.187 に答える
3

インストーラーを使用せず、ユーザーがネットワーク経由でCHMファイルを許可するための追加の手順を実行したくない場合は、WinHelpにフォールバックしてみませんか?VistaにはWinHlp32.exeが含まれていませんが、VistaとServer2008の両方のダウンロードとして無料で入手できます。

于 2008-08-04T13:48:02.993 に答える
3

質問は、独自のヘルプ ファイルを生成する方法ですか、それとも最適なヘルプ ファイル形式は何ですか?

個人的には、CHM が優れていると思います。マシンをセットアップするときに最初に行うことの 1 つは、PHP マニュアルを CHM 形式 ( http://www.php.net/download-docs.php ) でダウンロードし、 Crimson Editorでホットキーを追加することです。そのため、F1 を押すと、CHM が読み込まれ、カーソルが置かれている単語の検索が実行されます (機能をすばやく参照するのに最適です)。

于 2008-08-04T10:52:26.173 に答える
3

当社のソフトウェアは、クライアントにローカルに配布され、ネットワーク共有から提供されます。ネットワークから配信するために、CHM ファイルと一連の HTML ファイルの両方を生成することにしました。プログラムをローカルで開始するユーザーは CHM ファイルを使用し、プログラムをネットワーク共有から提供されるユーザーは HTML ファイルを使用する必要があります。

ヘルプとマニュアルを使用しているため、同じソース プロジェクトから両方のタイプの出力を簡単に生成できます。HTML ファイルには検索機能も含まれており、Web サーバーを必要としないため、最適なソリューションではありませんが、問題なく動作します。

これまでのところ、Windows のすべての単一ファイル タイプは何らかの形で壊れているようです。

  • WinHelp - 廃止
  • HtmlHelp (CHM) - Vista では廃止されました。ネットワーク共有からは機能しません。
  • Microsoft Help 2 (HXS) - これは、破損したインデックスなどで機能しない時点まで正しく機能しているように見えます。例として、これは Visual Studio 2005 以降で使用されています。
于 2008-08-04T11:02:12.097 に答える
3

オンライン ドキュメントが製品にどのようにインポートされるかによって異なります。適切なドキュメント インフラストラクチャを確立するのは複雑になる可能性がありますが、一度完了すれば成果が得られます。これが私たちのやり方です -

  • SCC (ClearCase) に保存されたヘルプ ソースDITA準拠の XML。
  • XMetalの編集のヘルプ
  • ヘルプのコンパイル、カスタマイズされたOpen DITA Toolkit、カスタム Perl/Java 前処理を使用
  • ヘルプ ソースは、コンパイル時にアプリケーション リソース、.RC ファイルなどを相互参照します。
  • 単一ソース、PDF、CHM、Eclipse ヘルプ、HTML からのヘルプ成果物。
  • 単一のソース リポジトリが、10 以上の複数の製品のヘルプを生成し、何千もの共有トピックがあります。

あなたが説明したことから、私はEclipseヘルプを見て、.NETまたはMFCアプリケーションに統合するのは簡単ではありません。基本的に、ヘルプマッピングを実行してURLへのリクエストを解決し、URLをEclipseヘルプラッパーまたはブラウザに起動する必要があります。

于 2008-09-21T00:11:04.110 に答える
2

PDFには、AdobeReaderが必要になるという欠点があります。

私は自宅と職場のWindowsでFoxitReaderを使用しています。はるかに小さく、開くのが非常に速い。a80000326.pdfが正確に何であるか、そしてなぜそれがドキュメントフォルダを詰まらせているのか疑問に思っているときに非常に便利です。

于 2008-08-05T18:55:00.440 に答える
2

「解凍して実行するだけ」を行っていると、セキュリティ上の問題が発生します。これは、ユーザーが Vista (またはそれ以降) を実行している場合に特に当てはまります。アプリケーションをインストーラー内にパッケージ化することを避けたい理由はありますか? インストーラーを使用すると、「外部ソース」の問題が軽減されます。.chm ファイルは問題なく使用できます。

InstallAwareを使用して、インストール パッケージを作成します。安くはありませんが、とても良いです。コストが気になる場合、WIXはオープン ソースでかなり堅牢です。WIX には学習曲線がありますが、操作は簡単です。

于 2008-08-04T12:11:47.900 に答える
2

私たちのアプリケーションで最終的に使用するソリューションは、ヘルプ ファイルを自分でホストすることだと思います。これにより、ファイルにすぐにアクセスでき、最新の状態に保つことができます。

私が計画しているのは、コンテンツを巨大な一連の XML ファイルにロードすることです。各ファイルには、特定のアイテムのヘルプが含まれています。この XML には、他の XML ファイルへのリンクが含まれます。必要に応じて XSLT を使用してコンテンツを表示します。

ライセンスによっては、必要に応じてルック アンド フィールを調整するために、クライアント固有の XSLT ファイルを作成する場合があります。製品の特定のバージョンのヘルプのみを表示できるようにする必要がある場合もありますが、これは XSLT 内のものをフィルターで除外することで実行できます。

于 2008-11-27T20:39:16.930 に答える
1

私は、chm、html、pdf、word、Windows ヘルプ、xml、xhtml など、聞いたことのないさまざまな形式を生成できる AuthorIT という商用パッケージを使用しています (dita はベルを鳴らしますか?)。これは、技術文書作成者のニーズに合わせたコンテンツ管理システムです。利点は、同じコンテンツを使用および再利用して一連のガイドを作成し、それらを異なる形式で生成できることです。

したがって、chm や html などを選択するという問題に関連する要点は、これを使用している場合、特定の形式にロックされていないということですが、ユーザーが選択できるいくつかの形式を提供でき、さらに形式を追加することもできます。追加料金なしで。

作成するガイドが 1 つしかない場合、時間の価値はありませんが、管理するドキュメント セットがある場合は、私の知る限りそれが最善です。彼らのサポートも非常に役に立ちます。

于 2008-09-18T14:47:16.580 に答える