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 转 PDF 工具

虽然这显然不是自动化流程的可行解决方案，因此这个问题肯定仍然悬而未决。

Answer 1

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

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

Answer 2

如@aaronncfca 提供的答案所述。问题是由于 CREATE_SUBDIRS 设置为 YES 时路径处理不当造成的。已经为这个问题创建了一个提议的补丁并推送（pull request 328）到 github

Doxygen LaTeX / PDF 链接指向第 1 页

Doxygen LaTeX / PDF links point to page 1

pdf

latex

doxygen

补充说明：

编辑：找到手动解决方案