If you're developing for .NET and you're looking to generate XML documentation help files you should look into Microsoft's shared-source Sandcastle project, and the front-end GUI for it "Sandcastle Help File Builder."
It's pretty nice and highly configurable. You can make some really good help documentation using it.
It was a little slow the last time I used it (over 6 months ago) but it may have been optimized since then...
我不确定“免费”，但是 Dr. Explain 的价格略高于 100 美元，但每一分钱都是值得的。 我们使用它为具有单个 CHM 的桌面应用程序和使用 HTML 导出的 Web 应用程序生成帮助。 最好的部分是，它会“自动”神奇地挖掘您的网页或应用程序页面，并为您开始帮助的基本构建。 我们的投资回报率约为 1 天。
I'm not sure about 'free', but Dr. Explain is a little over $100 and worth every penny. We use it to produce both help for desktop apps with a single CHM and web apps using the HTML export. The best part is that it 'auto-magically' mines your webpage or app page and starts the basic construction of the help for you. The ROI for us was about 1 day.
HelpNDoc 免费供个人使用。 它可以根据要求生成 CHM 和 HTML 帮助文件，以及同一来源的 Word DocX、PDF、ePub 和 Kindle 电子书。
HelpNDoc is free for personal use. It can generate CHM and HTML help files as requested, as well as Word DocX, PDF, ePub and Kindle eBooks from the same source.
DocBook is a universal standard file format for writing software documentation.
DocBook is an XML file format and as such is already blessed by Microsoft. It is declarative, earning it further kudos.
DocBook allows you to identify to it what pictures are screenshots, what strings of words are actually commands, and so forth. Which yes, actually means it is a bonafide part of the semantic web.
Because of this, you can use an XPath expression to search for all the screenshots, all the commands, and so forth. Decent IDE's all support XPath searches, and so do lots of small, free utilities.
Once you have worked out which XPath search string returns the content you want, you can write a little XSLT stylesheet yourself or with someone else's help. The stylesheet can collect the information and generate an HTML bullet-list (UL LI), a definitions list (DL DT,DD), or a quick reference card. Whatever you like. XPath, XSLT, and the various *ML languages are very flexible.
For more information about DocBook itself go visit http://www.docbook.org/ - and grab the free XSLT stylesheets for the latest version while you are there.
DocBook files can be automatically converted into many file formats besides the one used in Microsoft Windows WinHelp files. See the docbook.org web site for details. It is a long list of supported file formats, so brace yourself for a pleasant surprise!
If you already have a structured XML text editor, you might want to use that. If you are writing a really big online help file then consider oXygenXML and/or Open Office Writer. The former is a commercial product and the latter is free, open source software.
它不是“免费”的，但我遇到过的最好的软件是 Just Great Software 的 HelpScribble。 我在 Windows 7 上使用它没有任何问题。 我最喜欢的是它能够将 SHG 文件集成到帮助文件中。 一张图片胜过一千个单词，因此我倾向于使用屏幕图像来捕获按钮、文本框或其他内容。 用户可以看到该屏幕，然后只需单击显示即可获得有关“BOOM！”的更多信息。 ...解释立即弹出！ 无需翻阅手册或屏幕。
It's not "free" but the best software I've ever come across is HelpScribble from Just Great Software. I use it on Windows 7 without any problem. What I like most is its ability to integrate SHG files into the helpfile. A picture is worth a thousand words so I tend to use screen images where I capture buttons, text boxes or whatever. The user can see that screen and then just click of the display they want more information on an "BOOM!" ... the explanation pops right up! There's no need to thumb through pages of a manual or screens.
发布评论
评论（8）
是的。 来自 sourceforge 的 HelpMaker（原始网站 www.vizacc.com 已关闭）。 有史以来最好的免费帮助实用程序。
Yes. HelpMaker from sourceforge (The original site www.vizacc.com is down). Best free help utility ever.
HTML 帮助研讨会 微软。
HTML Help Workshop by Microsoft.
如果您正在开发 .NET 并且希望生成 XML 文档帮助文件，您应该查看 Microsoft 的共享源 Sandcastle 项目及其前端 GUI“Sandcastle 帮助文件生成器”。
它非常好并且高度可配置。 您可以使用它制作一些非常好的帮助文档。
我上次使用它时（6个多月前）有点慢，但从那以后它可能已经优化了......
If you're developing for .NET and you're looking to generate XML documentation help files you should look into Microsoft's shared-source Sandcastle project, and the front-end GUI for it "Sandcastle Help File Builder."
It's pretty nice and highly configurable. You can make some really good help documentation using it.
It was a little slow the last time I used it (over 6 months ago) but it may have been optimized since then...
我不确定“免费”，但是 Dr. Explain 的价格略高于 100 美元，但每一分钱都是值得的。 我们使用它为具有单个 CHM 的桌面应用程序和使用 HTML 导出的 Web 应用程序生成帮助。 最好的部分是，它会“自动”神奇地挖掘您的网页或应用程序页面，并为您开始帮助的基本构建。 我们的投资回报率约为 1 天。
I'm not sure about 'free', but Dr. Explain is a little over $100 and worth every penny. We use it to produce both help for desktop apps with a single CHM and web apps using the HTML export. The best part is that it 'auto-magically' mines your webpage or app page and starts the basic construction of the help for you. The ROI for us was about 1 day.
HelpNDoc 免费供个人使用。 它可以根据要求生成 CHM 和 HTML 帮助文件，以及同一来源的 Word DocX、PDF、ePub 和 Kindle 电子书。
HelpNDoc is free for personal use. It can generate CHM and HTML help files as requested, as well as Word DocX, PDF, ePub and Kindle eBooks from the same source.
DocBook 是用于编写软件文档的通用标准文件格式。
DocBook 是一种 XML 文件格式，因此已经受到 Microsoft 的支持。 它是声明性的，赢得了更多的荣誉。
DocBook 允许您识别哪些图片是屏幕截图，哪些字符串实际上是命令，等等。 是的，这实际上意味着它是语义网的真正组成部分。
因此，您可以使用 XPath 表达式来搜索所有屏幕截图、所有命令等。 不错的 IDE 都支持 XPath 搜索，许多小型免费实用程序也是如此。
一旦您确定了哪个 XPath 搜索字符串返回您想要的内容，您就可以自己或在其他人的帮助下编写一个小 XSLT 样式表。 样式表可以收集信息并生成 HTML 项目符号列表 (UL LI)、定义列表 (DL DT、DD) 或快速参考卡。 随你喜欢。 XPath、XSLT 和各种 *ML 语言都非常灵活。
阅读从 DocBook 到集成帮助系统了解如何自动转换将 DocBook 标准文件转换为专有且非常实用的 Microsoft Windows HTML 帮助文件。
有关 DocBook 本身的更多信息，请访问 http://www.docbook.org/ - 并免费获取当您在那里时，获取最新版本的 XSLT 样式表。
除了 Microsoft Windows WinHelp 文件中使用的一种文件格式之外，DocBook 文件还可以自动转换为多种文件格式。 有关详细信息，请参阅 docbook.org 网站。 这是一长串支持的文件格式，所以准备好迎接惊喜吧！
如果您已经有一个结构化 XML 文本编辑器，您可能想要使用它。 如果您正在编写一个非常大的在线帮助文件，请考虑 oXygenXML 和/或 Open Office Writer。 前者是商业产品，后者是免费的开源软件。
有关使用 Open Office Writer 创建/编辑 DocBook 文件的更多信息，请阅读 DocBook 入门关于开放式办公室。
DocBook is a universal standard file format for writing software documentation.
DocBook is an XML file format and as such is already blessed by Microsoft. It is declarative, earning it further kudos.
DocBook allows you to identify to it what pictures are screenshots, what strings of words are actually commands, and so forth. Which yes, actually means it is a bonafide part of the semantic web.
Because of this, you can use an XPath expression to search for all the screenshots, all the commands, and so forth. Decent IDE's all support XPath searches, and so do lots of small, free utilities.
Once you have worked out which XPath search string returns the content you want, you can write a little XSLT stylesheet yourself or with someone else's help. The stylesheet can collect the information and generate an HTML bullet-list (UL LI), a definitions list (DL DT,DD), or a quick reference card. Whatever you like. XPath, XSLT, and the various *ML languages are very flexible.
Read From DocBook to Integrated Help Systems for information about how to automatically convert a DocBook standard file into a proprietary and very practical Microsoft Windows HTML Help file.
For more information about DocBook itself go visit http://www.docbook.org/ - and grab the free XSLT stylesheets for the latest version while you are there.
DocBook files can be automatically converted into many file formats besides the one used in Microsoft Windows WinHelp files. See the docbook.org web site for details. It is a long list of supported file formats, so brace yourself for a pleasant surprise!
If you already have a structured XML text editor, you might want to use that. If you are writing a really big online help file then consider oXygenXML and/or Open Office Writer. The former is a commercial product and the latter is free, open source software.
For more information about using Open Office Writer to create/edit DocBook files, read Getting Started with DocBook on Open Office.
它不是“免费”的，但我遇到过的最好的软件是 Just Great Software 的 HelpScribble。 我在 Windows 7 上使用它没有任何问题。 我最喜欢的是它能够将 SHG 文件集成到帮助文件中。 一张图片胜过一千个单词，因此我倾向于使用屏幕图像来捕获按钮、文本框或其他内容。 用户可以看到该屏幕，然后只需单击显示即可获得有关“BOOM！”的更多信息。 ...解释立即弹出！ 无需翻阅手册或屏幕。
It's not "free" but the best software I've ever come across is HelpScribble from Just Great Software. I use it on Windows 7 without any problem. What I like most is its ability to integrate SHG files into the helpfile. A picture is worth a thousand words so I tend to use screen images where I capture buttons, text boxes or whatever. The user can see that screen and then just click of the display they want more information on an "BOOM!" ... the explanation pops right up! There's no need to thumb through pages of a manual or screens.
Doxygen 虽然最初旨在生成代码文档，但可以很容易地生成任何类型的帮助。
Doxygen, while originally meant to produce code documentation can be made quite easily to produce any kind of help.