页面未显示在Doxygen文档中

问题描述 投票:0回答:1

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

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

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

doxygen chm
1个回答
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. 或者在MarkDown文件中使用HTML语法在新窗口中打开

有关详细信息,请查看Doxygen specifics Including Markdown files as pages

enter image description here

© www.soinside.com 2019 - 2024. All rights reserved.