Doxygen LaTeX / PDF链接指向第1页

Question

我正在使用Doxygen创建产品手册，我遇到了这个问题。

输出的PDF（从LaTeX创建）中的某些链接被破坏;他们指向文档的第一页。

随附的HTML输出不会出现此问题;链接工作正常，如下所示：

此页面的Doxygen代码：

/** 
    @mainpage [product] Developer's Guide

    Blah blah blah.

    This manual is divided into the following sections:
    - @subpage intro
    - @subpage [etc]
 */

进一步说明：

• 我尝试使用@ref而不是@subpage。没有区别。
• PDF中的其他一些引用也被破坏（某些部分中的自动文件引用），但许多工作正常。

这是此页面的LaTeX中间体：

This manual is divided into the following section\-:
\begin{DoxyItemize}
\item \hyperlink{intro}{Product Introduction}
[etc]

编辑：找到手动解决方案

• 从LaTeX输出目录中打开refman.tex
• 将条目\hypertarget{d1/dfb/intro}{}更改为\hypertarget{intro}{}
• 重复其他页面
• 运行LaTeX to PDF工具

这显然不是自动化流程的可行解决方案，所以这个问题肯定仍然存在。

Answer 1

找到有效的解决方法：在Doxygen配置中禁用CREATE_SUBDIRS（专家选项卡，doxywizard中的项目主题）。

问题（如我的问题中的手册解决方案所示）是Doxygen将路径放在hypertarget事物中，其中只需要符号。通过完全消除路径，禁用子目录可以解决问题。

Answer 2

如@aaronncfca提供的答案所述。如果CREATE_SUBDIRS设置为YES，则问题是由于未正确处理路径引起的。 已经为此问题创建了一个提议的补丁，并将其推送（拉取请求328）到github