跳转到正文
EasyLaTeX
EasyLaTeXDocs
开始使用

PDF 元数据与发布

使用 hyperref 设置 PDF 标题、作者、主题和关键词，并让目录、引用和网址变成可点击链接。发布前应从读者视角检查最终 PDF，而不只确认源文件能编译。

EasyLaTeX 编译器设置：XeLaTeX + ctex；需加载 hyperref。学位论文、期刊或长期归档的 PDF 可能有 PDF/A、嵌入字体或文件命名要求，应以交付规范和验证工具为准。

加载 hyperref

hyperref 为目录、交叉引用和 URL 创建链接。它通常在大多数宏包之后加载：

latex
\usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue,citecolor=blue]{hyperref}

colorlinks=true 直接给文字上色；如需黑白打印，可使用 hidelinks 隐藏彩色边框和颜色。不要同时加载多个会管理链接的宏包而不检查模板兼容性。

设置 PDF 元数据

使用 \hypersetup 设置文档属性：

latex
\hypersetup{
  pdftitle={实验报告},
  pdfauthor={张三},
  pdfsubject={材料测试},
  pdfkeywords={LaTeX, 实验报告, 材料测试}
}

这些内容显示在 PDF 阅读器的属性面板和搜索结果中。标题、作者和关键词应与封面、署名和实际内容保持一致。

控制书签和链接

章节标题会自动生成 PDF 书签。可用以下选项让书签展开到指定深度：

latex
\hypersetup{bookmarksopen=true,bookmarksopenlevel=1}

目录使用 \tableofcontents，外部链接使用 \url{...} 或 \href{地址}{显示文字}。链接文字要描述目标，不要使用“点这里”作为唯一说明。

处理标题中的特殊内容

章节标题同时会写入目录和 PDF 书签。复杂公式、脚注或格式命令可能造成书签警告。为目录提供较短版本：

latex
\section[模型比较]{模型 $A/B$ 的比较与讨论}

必要时使用 \texorpdfstring{PDF 中的排版内容}{书签中的纯文本}，让 PDF 正文与书签分别使用合适的文本。

发布前检查

  • 从头完整编译，确认没有未定义引用、溢出或字体相关警告；

  • 在 PDF 阅读器中检查目录、书签、内部引用和外部 URL；

  • 检查 PDF 属性中的标题、作者、主题和关键词；

  • 使用实际交付方式检查纸张尺寸、页码、页眉页脚、图片清晰度与黑白打印效果；

  • 根据要求确认文件名、许可、可访问性、PDF/A 和嵌入字体。

不要通过删除辅助文件或忽略警告来“修复”最终 PDF；先定位警告的来源，再做完整编译。

常见问题

书签显示乱码或不完整

确认使用 XeLaTeX 或 LuaLaTeX，并将源文件保存为 UTF-8。标题中的复杂命令使用短标题或 \texorpdfstring 处理。

链接有难看的彩色边框

使用 colorlinks=true 选择文字颜色，或改用 hidelinks。不要同时设置边框颜色和文字颜色，除非交付规范有明确要求。

PDF 属性仍是旧内容

确认 \hypersetup 位于主文件的导言区且内容已保存。在平台重新编译并等待成功，再检查最新预览或重新下载的 PDF。编译失败时，旧 PDF 的属性不会代表本次修改。

完整示例

latex
\documentclass[UTF8,a4paper,12pt]{ctexart}
\usepackage[
  colorlinks=true,
  linkcolor=blue,
  urlcolor=blue
]{hyperref}
\hypersetup{
  pdftitle={实验报告},
  pdfauthor={张三},
  pdfsubject={材料测试},
  pdfkeywords={LaTeX, 实验报告}
}

\begin{document}
\tableofcontents
\section{方法}\label{sec:method}
方法说明见 \autoref{sec:method}。

项目主页：\href{https://www.latex-project.org/}{LaTeX Project}。
\end{document}
PDF 元数据与发布 | EasyLaTeX | EasyLaTeX