2

WindowsでITツールのドキュメントを作成して提供するにはどうすればよいですか？ヘルプオーサリングツールにお金をかけたくないという追加の制約があります。

ここSOでは、アルゴリズムと最適化、APIとパフォーマンスについて説明します。しかし、私の開発努力からの成果物の1つは、ドキュメントです。それを構築するための最良の方法は何ですか、そしてそれをどのような形で提供する必要がありますか？

一連の.NETAPIを配信する場合、.CHMは配信のための合理的なメカニズムです。SHFBを使用して、ビルドの一部としてヘルプファイルを作成するのは非常に簡単です。また、主にWindowsで使用される場合は、.CHMに非常にアクセスしやすくなります。また、.CHMを.HTMに変換すると、ドキュメントにさらに広くアクセスできるようになります。

ただし、開発者自体ではなく、WindowsWebサーバー管理者が使用するISAPIフィルターのドキュメントを提供したいと思います。インストール、操作、および構成について説明する必要があります。エンドユーザーは多くの場合、開発者と管理者のスキルを持っていると思いますが、いずれにせよ、私の目的のために、ドキュメントは管理タスクと運用上の問題をカバーします。

SHFBを使用すると、通常のHTMLファイルを.CHMに含めることができます。SHFBをすでに知っていて、ヘルプオーサリングツールにお金をかけたくない場合は、これが最善の方法ですか？そうでない場合は、何ですか？

4

4 に答える 4

1

Texlipseは、Eclipse 用の Latex プラグインです。どちらも無料です。Latext は、多くの研究者が論文を作成するために使用しており、多くの教科書にも使用されています。あなたのニーズを満たすことができる無料のツールです。

于 2009-07-09T16:28:26.470 に答える
0

このasciidocを試してください。これはLaTeXではありませんが、優れたPDF / CHM / HTMLを生成し、プログラマー以外の人にドキュメントの作成を教えることができます。これは素晴らしいボーナスです:)

于 2009-07-09T15:16:34.290 に答える
0

最終的に、 http://shfb.codeplex.comで入手できる無料のツール、Sandcastle Help File Builder を使用することにしました。別のプロジェクトの参照ドキュメントを作成するために既にサンドキャッスルを使用していたので、このツールについてある程度の知識がありました。Windows での使用に適した CHM または .HxS ファイルを生成します。SHFB を使用してヘルシーな「設計」を行ったことはありませんでしたが、その方法は非常に簡単に理解できました。結果は非常に良好です。

于 2009-07-11T22:28:00.000 に答える
0

ドキュメントをオープン オフィスで作成してから、pdf でエクスポートしてみませんか?

ラテックスはプロの方法ですが、すぐにアクセスできるわけではありません.

于 2009-07-09T15:22:38.177 に答える