链接或合并CHM文件

Question

我使用狮身人面像作为我的project文档。这很有用，因为我可以从同一个rst源导出标准的html文档和Microsoft (CHM)。但是，我也希望在我自己的项目中包括NumPy chm帮助。有办法这样做吗？

例如，我在单独的.rst文件中有我的项目的文档。然后，我使用sphinx将该文本转换为一个.chm文件，以便分发给Windows。我还为NumPy文档提供了一个单独的chm文件。从我自己的项目文档中可以找到numpy chm的最佳方法是什么？

我更希望在我自己的目录中有一些链接到numpy chm的内容。然而，我会满足于某种超链接，用户可以在一个单独的Microsoft帮助窗口中单击并打开numpy chm (如果需要)。

也许还有更好的解决方案我都没想过？

Answer 1

以下解决方案可能满足您的要求：

1. 我使用帮助创作工具将一些HTML示例文件编译成了一个‘CHM-样例-A.chm’文件。
2. 在相应文件的末尾，我添加了一个包含指向NumPy文档的链接的部分(请参阅下面使用NodePad++编辑的部分)。
3. CHM再次编译，其结果是TOC和内容：

​

​

在一个连接的世界中，您可能希望链接到NumPy的网站，如上面所示。当然，导航窗格中没有目录(TOC)。这里只添加了一个主题节点，不可能进行全文搜索。链接的NumPy web内容显示在CHM内容窗格中。你当然可以在这里导航。

      <LI><OBJECT type="text/sitemap">
        <param name="Name" value="NumPy External Link">
      </OBJECT>
  <UL>
 <LI> <OBJECT type="text/sitemap">
    <param name="Name" value="Jump to NumPy documemts">
    <param name="Local" value="http://docs.scipy.org/doc/numpy-dev">
    <param name="ImageNumber" value="13">
    </OBJECT>
  </UL>       

从下面的链接下载HTMLHelp文件，并尝试编译和添加节点，如上面所示，以满足您的需要：files.zip (用于Microsoft工作室的第一步(免费软件)或FAR HTMLHelp)。或者尝试使用您自己的CHM项目文件。

硬编码索引项(就像TOC那样)是可能的。

链接CHM很困难，并且被安全更新破坏了：http://kb.helpwaregroup.com/ms-html-help/merge/notes

从project链接到PDF (例如NumPy)可能是一个解决方案。有关从：project.zip下载的示例项目，请参阅

​

​