夜雨聆风学习资料网

ARTICLE · 994842

LaTeX 笔记增加“交互感” —— pdfcomment PDF 注释系统

LaTeX 笔记增加“交互感” —— pdfcomment PDF 注释系统

在传统的 LaTeX 排版中,我们习惯于认为:

LaTeX 的任务就是把文字、公式、图片排版成漂亮的 PDF。

但是随着电子文档的发展,PDF 已经不再只是“打印文件”的替代品。

一本优秀的电子书、一份高质量的学习笔记、一篇教学讲义,除了拥有漂亮的版式之外,还可以拥有更多交互功能:

  • • 鼠标移动到某个位置,显示额外解释;
  • • 点击一个单词,弹出详细说明;
  • • 在公式旁边添加隐藏备注;
  • • 给论文增加审阅意见;
  • • 给教材添加教师批注;
  • • 给学习笔记加入自己的思考过程。

这些功能,其实 PDF 本身早已经支持。

而在 LaTeX 中,我们可以借助 pdfcomment 宏包,把普通 PDF 文档变成具有交互能力的电子文档。

今天我们学习的主题是:

LaTeX 笔记增加“交互感” —— pdfcomment PDF 注释系统

通过本文,你将掌握:

  • • 什么是 PDF 注释;
  • • 为什么 LaTeX 默认无法直接添加 PDF 批注;
  • • 如何安装和使用 pdfcomment;
  • • 如何添加普通注释;
  • • 如何制作隐藏说明;
  • • 如何给文字增加解释气泡;
  • • 如何设置注释颜色和图标;
  • • 如何制作教学笔记中的交互效果;
  • • 如何在自己的 LaTeX 书籍模板中使用。

一、从一本普通 PDF 说起

我们继续使用之前文章中的 LaTeX 书籍模板。

这是我们之前一直使用的基础文档:



1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

\documentclass[openany]{ctexbook}

\usepackage[
    a4paper,
    inner=3.2cm,
    outer=2.2cm,
    top=3cm,
    bottom=3.2cm
]{geometry}

\usepackage{lipsum}
\usepackage{fancyhdr}

\pagestyle{fancy}
\fancyhead{}
\fancyfoot{}
\fancyhead[LE]{\leftmark}
\fancyhead[RO]{\rightmark}
\fancyfoot[C]{\thepage}

\title{我的第一本中文书}
\author{Shuepi}
\date{\today}

\begin{document}

\maketitle
\tableofcontents

\chapter{初章:启程}

\section{关于排版}

这是正文内容。

\section{数学公式示例}

$a^2+b^2=c^2$

\chapter{终章:归途}

\lipsum[10-40]

\end{document}


编译以后,我们得到了一本结构完整的 PDF。

它包含:

  • • 封面;
  • • 目录;
  • • 章节;
  • • 页眉页脚;
  • • 正文内容。

但是,如果我们打开 PDF 阅读器,会发现:

这只是一本“静态”的电子书。

例如:

我们正在阅读数学教材:

勾股定理:直角三角形两直角边平方和等于斜边平方。

如果作者想进一步解释:

“这里的直角条件非常重要,如果不是直角三角形,该公式不能直接使用。”

怎么办?

传统方式:

直接写进正文。

结果:

页面越来越长,阅读体验下降。

另一种方式:

增加脚注。

例如:



1

这是勾股定理\footnote{只有直角三角形满足该关系。}


但是脚注的问题是:

  • • 会占用页面空间;
  • • 打断阅读;
  • • 不适合大量补充说明。

那么有没有一种方式:

正文保持干净,需要的时候再查看说明?

答案就是:

PDF 注释。


二、什么是 PDF 注释?

PDF 注释(PDF Comment)是一种 PDF 内置功能。

它类似:

  • • Word 中的批注;
  • • 浏览器中的网页提示;
  • • 阅读软件中的高亮说明。

例如:

正文:

欧拉公式

旁边有一个小图标。

鼠标点击:

弹出:

欧拉公式连接了指数函数、三角函数和复数,是数学中最优美的公式之一。

这种效果,就是 PDF 注释。

它最大的优势:

1. 不影响正文排版

正文保持简洁。

2. 信息隐藏

需要时查看。

3. 非常适合电子教材

特别适用于:

  • • 数学教材;
  • • 学术论文;
  • • 学习笔记;
  • • 电子书;
  • • 课程讲义。

三、认识 pdfcomment 宏包

pdfcomment 是 LaTeX 中专门用于创建 PDF 注释的宏包。

使用之前,需要导入:



1

\usepackage{pdfcomment}


因此我们的文档前面增加:



1

\usepackage{pdfcomment}


完整结构:



1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

\documentclass[openany]{ctexbook}

\usepackage[
    a4paper,
    inner=3.2cm,
    outer=2.2cm,
    top=3cm,
    bottom=3.2cm
]{geometry}

\usepackage{lipsum}
\usepackage{fancyhdr}
\usepackage{pdfcomment}

\pagestyle{fancy}
\fancyhead{}
\fancyfoot{}
\fancyhead[LE]{\leftmark}
\fancyhead[RO]{\rightmark}
\fancyfoot[C]{\thepage}


注意:

pdfcomment 主要作用于 PDF。

因此推荐:

  • • XeLaTeX;
  • • LuaLaTeX;

进行编译。


四、第一个 PDF 注释

我们先来看最简单的例子。

命令:



1

\pdfcomment{这里是注释内容}


例如:



1
2

这是勾股定理
\pdfcomment{勾股定理只适用于直角三角形。}


编译 PDF 后:

正文:

这是勾股定理。

旁边出现一个注释标记。

点击以后:

显示:

勾股定理只适用于直角三角形。

这就是最基本的 PDF 注释。


五、给数学公式增加解释

数学学习中,经常遇到这种情况:

公式很短,但是理解很困难。

例如:



1
2
3

\[
a^2+b^2=c^2
\]


普通教材:

只能在下面解释。

使用 pdfcomment:



1
2
3
4

\[
a^2+b^2=c^2
\]
\pdfcomment{这是勾股定理,其中a和b表示直角边,c表示斜边。}


这样:

公式保持简洁。

说明隐藏起来。

对于电子数学笔记来说,非常方便。


六、给文字添加解释

除了单独添加注释,还可以直接绑定文字。

命令:



1

\pdftooltip{文字}{提示内容}


例如:



1

\pdftooltip{欧拉公式}{e^{ix}=cosx+i sinx}


效果:

鼠标移动到:

欧拉公式

会显示:

e^{ix}=cosx+i sinx

这种方式特别适合:

  • • 专业术语;
  • • 英文缩写;
  • • 概念解释。

例如:



1

\pdftooltip{Fourier Transform}{傅里叶变换是一种将信号从时间域转换到频率域的方法。}


阅读体验非常类似网页。


七、制作学习笔记中的隐藏知识点

很多人在制作 LaTeX 学习笔记时,会遇到一个问题:

写得太详细:

页面臃肿。

写得太简单:

知识不足。

pdfcomment 可以解决这个问题。

例如:

正文:



1

矩阵可以表示线性变换。


添加:



1
2
3
4

矩阵可以表示线性变换。
\pdfcomment{
矩阵不仅表示数字排列,更重要的是表示空间中的线性映射。
}


最终:

页面看起来简洁。

但是隐藏信息非常丰富。

这特别适合制作:

  • • LaTeX 教程;
  • • 数学笔记;
  • • 编程手册。

八、设置注释图标

默认情况下:

PDF 注释会显示一个小图标。

我们可以改变图标。

例如:



1
2
3

\pdfcomment[
icon=Note
]{这是一个普通提示}


常用图标:

图标
作用
Note
普通说明
Comment
评论
Help
帮助
Insert
插入
Key
关键提示
NewParagraph
新段落

例如:



1
2
3

\pdfcomment[
icon=Help
]{这里需要重点理解}


显示:

帮助类型图标。


九、设置注释颜色

教学笔记中,经常希望不同类型的信息使用不同颜色。

例如:

重点:



1
2
3

\pdfcomment[
color=red
]{这是重点内容}


提示:



1
2
3

\pdfcomment[
color=yellow
]{这是提示信息}


例如:



1
2
3
4
5
6
7

重要公式
\pdfcomment[
color=red
]
{
这个公式需要牢记。
}


这样:

不同知识层级更加清晰。


十、制作类似教材批注效果

假设我们正在写一本数学教材:



1
2
3

\section{极限}

函数极限表示函数值无限接近某个确定值。


如果增加教师说明:



1
2
3
4
5
6
7
8
9
10
11

\section{极限}

函数极限表示函数值无限接近某个确定值。

\pdfcomment[
author=教师
]
{
注意:
极限描述的是变化趋势,而不是函数是否达到这个值。
}


PDF 中:

学生阅读正文。

教师说明隐藏。

这就是电子教材未来的发展方向。


十一、结合我们的书籍模板

现在把 pdfcomment 加入之前的书籍。

完整代码:



1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

\documentclass[openany]{ctexbook}

\usepackage[
    a4paper,
    inner=3.2cm,
    outer=2.2cm,
    top=3cm,
    bottom=3.2cm
]{geometry}

\usepackage{lipsum}
\usepackage{fancyhdr}
\usepackage{pdfcomment}

\pagestyle{fancy}
\fancyhead{}
\fancyfoot{}
\fancyhead[LE]{\leftmark}
\fancyhead[RO]{\rightmark}
\fancyfoot[C]{\thepage}

\title{我的第一本中文书}
\author{Shuepi}
\date{\today}

\begin{document}

\maketitle
\tableofcontents

\chapter{初章:启程}

\section{关于排版}

这是正文内容。

\pdfcomment[
icon=Note
]
{
LaTeX是一种专业排版系统,非常适合制作长篇技术文档。
}

\section{数学公式示例}

\[
a^2+b^2=c^2
\]

\pdfcomment[
icon=Help
]
{
这是勾股定理,只适用于直角三角形。
}

\chapter{终章:归途}

\lipsum[10-40]

\end{document}


这样:

一本普通 PDF:

变成:

具有隐藏知识层的电子书。


十二、pdfcomment 最适合哪些场景?

1. 数学教材

公式旁边添加解释。

2. LaTeX 教程

代码旁边添加说明。

3. 学术论文

增加审稿意见。

4. 个人笔记

保存自己的思考过程。

5. 电子书制作

隐藏扩展内容。


十三、pdfcomment 与传统脚注的区别

很多初学者会问:

为什么不用脚注?

两者区别:

功能
脚注
pdfcomment
显示位置
页面底部
隐藏
占空间
占用
不占用
适合电子阅读
一般
优秀
交互效果
无
有
支持隐藏信息
否
是

如果你的目标是:

制作打印书籍:

脚注更合适。

如果你的目标是:

制作电子教材:

pdfcomment 更有优势。


十四、总结

LaTeX 的魅力,不只是生成漂亮的 PDF。

真正强大的地方在于:

它可以创造专业的信息载体。

pdfcomment 宏包让 PDF 从:

“一张静态页面”

变成:

“可以交互学习的知识系统”。

通过它,我们可以:

  • • 给公式添加解释;
  • • 给概念增加提示;
  • • 制作隐藏知识点;
  • • 创建电子教材;
  • • 丰富学习笔记。

当一本 LaTeX 制作的 PDF 不仅排版精美,而且还能与读者互动时,它就不再只是一个文件。

它更像一本真正的数字化教材。

这就是:

LaTeX 笔记增加“交互感” —— pdfcomment PDF 注释系统

让你的 LaTeX 文档,从“漂亮”走向“智能”。

相关学习资料