【问题标题】:Page not displaying in Doxygen documentation页面未显示在 Doxygen 文档中
【发布时间】:2017-08-03 10:45:49
【问题描述】:

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

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

请告诉我解决方案,同样的。

【问题讨论】:

  • 欢迎来到 Stack Overflow!请浏览tourhelp centerhow to ask a good question 部分,了解本网站的运作方式并帮助您改进当前和未来的问题,从而帮助您获得更好的答案。
  • 请在您的 MarkDown 文件中添加代码 sn-p 以查看子页面是如何使用的。

标签: doxygen chm


【解决方案1】:

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

对于已编译的 CHM 帮助文件,所有链接必须在通过例如 HTML Help Workshop 编译 *.hhp 文件之前使用 Doxygen 生成的 HTML 文件。

使用指向示例网页的链接时,一切都按预期工作。我添加了一个 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 详细信息Including Markdown files as pages

【讨论】:

    猜你喜欢
    • 1970-01-01
    • 2016-05-05
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2020-07-20
    • 2020-12-08
    • 2014-11-19
    相关资源
    最近更新 更多