如何定制或移除Doxygen生成LaTeX文档的页眉页脚？

一、定制页眉（含标题、PNG Logo、蓝色线条）和页脚（含蓝色线条、页码） #

要实现需求，需通过自定义header.tex和footer.tex文件，同时在Doxygen配置中指定这两个文件路径。

1. 配置Doxygen #

打开Doxyfile，添加或修改以下配置：

LATEX_HEADER = header.tex
LATEX_FOOTER = footer.tex

2. 编写header.tex文件 #

利用LaTeX的fancyhdr宏包实现自定义页眉，代码如下：

% header.tex 完整内容
\usepackage{fancyhdr}
\usepackage{graphicx}
\usepackage{xcolor}

% 定义蓝色线条颜色（可按需调整RGB值）
\definecolor{headerBlue}{RGB}{0, 102, 204}

% 重置默认页眉页脚样式
\fancyhf{}
% 页眉左侧：插入PNG Logo，width参数控制Logo宽度
\fancyhead[L]{\includegraphics[width=2cm]{your-logo.png}}
% 页眉中间：显示文档标题，粗体强调
\fancyhead[C]{\textbf{你的项目文档标题}}
% 替换默认页眉线条为蓝色
\renewcommand{\headrulewidth}{0.4pt}
\renewcommand{\headrule}{\hbox to\headwidth{\color{headerBlue}\leaders\hrule height \headrulewidth\hfill}}

% 启用自定义页眉样式
\pagestyle{fancy}

注意：替换your-logo.png为实际Logo路径（建议放在LaTeX输出目录），你的项目文档标题改为真实文档名称。

3. 编写footer.tex文件 #

用同样宏包实现自定义页脚，代码如下：

% footer.tex 完整内容
\usepackage{fancyhdr}
\usepackage{xcolor}

% 和页眉保持一致的蓝色
\definecolor{footerBlue}{RGB}{0, 102, 204}

% 页脚中间：显示页码
\fancyfoot[C]{\textbf{Page \thepage}}
% 替换默认页脚线条为蓝色
\renewcommand{\footrulewidth}{0.4pt}
\renewcommand{\footrule}{\hbox to\headwidth{\color{footerBlue}\leaders\hrule height \footrulewidth\hfill}}

% 确保样式生效
\pagestyle{fancy}

4. 编译注意事项 #

• 确保LaTeX环境（TeX Live/MikTeX）已安装fancyhdr、graphicx、xcolor宏包，一般默认包含；
• 生成LaTeX文件后，用pdflatex编译两次，第一次生成内容，第二次才能正确渲染页码和页眉页脚位置。

二、生成无页眉页脚的PDF文档 #

若定制LaTeX文件繁琐，可直接生成无页眉页脚的文档，后续用PDF编辑器添加样式：

1. 修改Doxygen配置 #

创建极简header.tex文件，内容如下：

\usepackage{fancyhdr}
\pagestyle{empty}

然后在Doxyfile中设置：

LATEX_HEADER = header.tex
LATEX_FOOTER =

2. 生成编译 #

正常运行Doxygen生成LaTeX文件，再用pdflatex编译得到无页眉页脚的PDF。之后可使用Adobe Acrobat、Foxit PDF Editor等工具添加自定义页眉、页脚、Logo和线条。

内容的提问来源于stack exchange，提问作者Federico Massimi