页面未显示在Doxygen文档中

时间:2017-08-03 10:45:50

标签: doxygen chm

我正在通过Doxygen创建一个API文档,其中我创建了一个.md文件,其中首先包含一些列表和一些子页面。

当我在CHM文件中编译文档时,它会显示相同文件名下的子页面,但是当我点击文件名时它不会显示任何页面,而在点击菜单栏下的相同文件名后,它显示'此页面无法显示'就像在IE中一样。

请告诉我相同的解决方案。

1 个答案:

答案 0 :(得分:1)

多个链接的markdown文件可能会导致所描述的行为。但是你还没有清楚地描述如何使用这些 *。md 文件。

对于已编译的CHM帮助文件,所有链接必须使用Doxygen生成的HTML文件,然后才能通过HTML Help Workshop编译 * .hhp 文件。

使用指向示例网页的链接时,一切都按预期工作。我添加了一个 README.md 来重现测试项目。

Linking from Doxygen using MarkDown
===================================

[HelpMVP]: http://www.helpmvp.com/  "Help MVP"
[HelpwareGroupDE]: http://www.help-info.de/en/FAR/far_support.htm  "Help Info"

For building CHM's with FAR HTML have a look at [HelpMVP] and [HelpWareGroupDE].

[This link shows a web site topic inside of the CHM's help viewer content pane: ](http://www.help-info.eu/en/FAR/far.htm)

<!-- simple use HTML syntax in a MarkDown file to open in a new window -->
<a href="http://www.help-info.eu/en/FAR/far.htm" target="_blank">This link shows a web site topic in a new window by using HTML syntax as markdown!</a>

运行Doxygen并编译CHM(在我的情况下使用FAR HTML)后,这将导致帮助查看器如下面的快照所示。该主题也可以从相关页面访问。请注意并尝试满足您的需求 - 我的样本中使用了两种链接:

  1. 在CHM的帮助查看器内容窗格
  2. 中显示了一个网站主题
  3. 或简单使用MarkDown文件中的HTML语法在新窗口中打开
  4. 有关详细信息,请查看Doxygen细节Including Markdown files as pages

    enter image description here