latex-emacs从零开始

• 高效美观地生成数学公式符号
• 文档更结构化：交叉引用、自动编号等

结论：更省心、效果更好

官方地址：https://www.tug.org/texlive/

• 创建工作目录
• 创建空白文本文件，.tex后缀名结尾，如test.tex
• 记事本打开.tex文件

输入代码: 必不可少的结构

\documentclass{article}

\begin{document}

Hello world!

\end{document}

保存文件内容

• 打开命令行

window用户可以在所在目录

• 方法1：按 Shift 加 右键打开 powershell
• 方法2：在输入框输入 cmd

pdflatex test.tex

可以看到在文件来中多出来几个文件，是在编译过程中产生的辅助文件

> ls
test.aux        test.log        test.pdf          test.tex

tex文件内以空行作为分段，无论多少空行也只相当于一个空行。如

\documentclass{article}

\begin{document}

Hello world!

This is a cat.

\end{document}

适用于windows用户

开源免费，支持同步展示修改的 pdf文件，这样就不用关闭再打开pdf文件了。

下载地址: https://www.sumatrapdfreader.org/download-free-pdf-viewer

我这里下载的是 64-bit SumatraPDF-3.5.2-64-install.exe

安装后，点pdf文件右键选择 打开方式 --> 选择其他应用 --> 选择sumartraPDF 始终选择这个软件打开pdf文件 。

可以高亮latex代码

用emacs打开一个tex文件，除本身文件外下面还多了带*星号的辅助文件，如 *GNU Emacs* 是一个欢迎界面。

• 查看所有buffer： 点击菜单栏中的buffer
• 切换buffer
  • 方法1： 菜单中点击 buffer
  • 方法2：鼠标左键或右键点击状态栏的文件名，向前或向后切换buffer。甚至可以切到同一个文件不同光标位置，进行修改操作。
• 窗口大小：
  • 鼠标在状态栏，上下拖动
• 窗口关闭：
  • 方法1：鼠标停在状态栏，右键
  • 方法2：菜单栏选择 Remove Other Windows 只保留当前buffer，New Window Below 水平
  • 方法3：鼠标滚轮按住状态栏，拖动
  • 方法4：快捷键 C-x 1
• 主题：
  • Options –> Customize Emacs –> Custom Themes –> tango-dark
  • 保存 Save Theme Settings 再状态栏文件切换buffer

正常我们是在命令行终端输入 pdflatex test.tex 进行编译。emacs 也可以编译tex文档。

emacs中修改文件后 C-x C-s 保存，编译latex文件使用 C-c C-c 输入： pdflatex test.tex 回车

• 方法2：因为是pdflatex 直接回车
• 方法3：还可以在命令提示符按向上键，找到上次运行的命令，
• 方法4：也可以按 Tab 鼠标点击之前执行的命令
• 方法5：输入 pdflatex 名称前缀 tab补全

使用2个美元符号$包裹

范例

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{gbsn}

  3.设曲线$L$是空间区域$0 \le x \le 1$,$0 \le y \le 1$, $0 \le z \le 1$的表面与平面
  $x+y+z = \frac{3}{2}$的交线，则
  $| \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| = $

你好
Hello world!

\end{CJK}

\begin{CJK}{UTF8}{gkai}

  再见
  sflj
Hello world!

\end{CJK}

\end{document}

\begin{equation*}
公式
  \end{equation*}

同时必须使用美国数学会的宏包 amsmath

\usepackage{amsmath}

一般来说行间公式比行内公式大一些

范例：

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{gbsn}

  3.设曲线$L$是空间区域$0 \le x \le 1$,$0 \le y \le 1$, $0 \le z \le 1$的表面与平面
  $x+y+z = \frac{3}{2}$的交线，则
  $| \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| = $



  \begin{equation*}
    | \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| =
    \end{equation*}

  $aaaaa           bbb  ccc ddd$

  Hello world

  这是一句中文

  新华社。
  报道。
\end{CJK}

\end{document}

一个latex命令只有遇到 空格 或者 数字 或者 标点符号 才会终止识别。

行内公式和行间公式尽量不要插入换行，避免破坏emacs对latex文档的语法高亮。

在数学环境中连续输入一长串字母，latex会把它理解为单个变量的乘积。即使加了行多空格, latex也会把他们忽略掉。

\le 小于
\pm 加号

latex中加入空格：

\,
\空格
\quad 大一点的空格
\qquad 再在一点的空格

使用场景：

• 积分变量和前面的函数隔开用 \, 。如 $\int_0^1 f()\, dx$
• .被当成是句号，后面加一个真正的空格。 如 s.t.\ XXXXX, i.e.,
• \quad 多个公式之间。如逗号和n不要靠太近 f(n) = n (n+1),\quad n = 1, 2, 3, \dots.

范例：

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{gbsn}

  3.设曲线$L$是空间区域$0 \le x \le 1$,$0 \le y \le 1$, $0 \le z \le 1$的表面与平面
  $x+y+z = \frac{3}{2}$的交线，则
  $| \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| = $

  \begin{equation*}
    | \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| =
  \end{equation*}

  $dfasd\, fa\ sd\quad fa\qquad dfsf$
  $\int_0^1 f(x)\, dx$

  s.t. \ XXXXX, i.e.,
  \begin{equation*}
    f(n) = n (n+1),\quad n = 1, 2, 3, \dots.
    \end{equation*}
\end{CJK}

\end{document}

一个点直接用英文句号.即可
$\dot{A}$  在字母上方加点
$\dots$  省略号
$f(x_1, x_2, \cdots, x_n)$ 省略号在公式中间
$a \cdot b$ 数学中的点乘

上标： ^ 脱字符
下标： _ 下划线。默认1个字母，多个字母使用花括包裹 如$a^{abc}$

积分的上下线或求和的上下线也是由上下标来实现的。 如一个东西的极限 $\lim_{ n \to \infty } na_n^2$ ，其中我们希望把极限放在极限号的下面，现在显示的结果 是下标的位置，解决方法把公式写在行间公式中。如还想在行内公式实现可以在上下标前加个limits，如$\lim\limits_{ n \to \infty } na_n^2$

类似其它的符号：
$\sum$, 求和号，$\int$, 积分号， $\prod$ 连乘号

范例：

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{gbsn}

  3.设曲线$L$是空间区域$0 \le x \le 1$,$0 \le y \le 1$, $0 \le z \le 1$的表面与平面
  $x+y+z = \frac{3}{2}$的交线，则
  $| \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| = $



  \begin{equation*}
    | \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| =
    \end{equation*}


  空格：
  $aaaaa\, bbb\ ccc\quad dd\qquad d$
  $\int_0^1 f(x)\, dx$

  s.t. \ XXXXXX, i.e.,
  \begin{equation*}
    f(n) = n (n+1),\quad n = 1, 2, 3, \dots.
    \end{equation*}

  点与省略号：
  $\dot{A}$, $\dots$, $f(x_1, x_2, \cdots, x_n)$, $a \cdot b$

  上标下标：
  $\lim_{ n \to \infty } na_{n}^2$ \quad $\lim_{ n \to \infty } na_{n}^2$

  \begin{equation*}\lim_{ n \to \infty } na_{n}^2
    \end{equation*}

  $\sum$, 求和号，$\int$, 积分号， $\prod$ 连乘号

  例子：int积分号，积分下限是alpha，积分上限是 beta，f'()求导
  \begin{equation*}
    \int_{ \alpha }^{ \beta } f'( nx - \frac{1}{x} ) \, dx
    \end{equation*}

  $a^abc$ \quad $a^{abc}$ 多字符串用花括号包裹

  Hello world

  这是一句中文

  新华社。
  报道。
\end{CJK}

\end{document}

• 分式：\frac{ 分子 }{ 分母 }
• 根号：\sqrt{ xxx }
  • 高次根号：\sqrt[]{xxx} 如，开10次根号2，\(\sqrt[ 10 ]{2}\)

范例：

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{gbsn}

  3.设曲线$L$是空间区域$0 \le x \le 1$,$0 \le y \le 1$, $0 \le z \le 1$的表面与平面
  $x+y+z = \frac{3}{2}$的交线，则
  $| \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| = $



  \begin{equation*}
    | \oint_L (z^2 - y^2) dx + (x^2 - z^2) dy + (y^2 - x^2) dz| =
    \end{equation*}


  空格：
  $aaaaa\, bbb\ ccc\quad dd\qquad d$
  $\int_0^1 f(x)\, dx$

  s.t. \ XXXXXX, i.e.,
  \begin{equation*}
    f(n) = n (n+1),\quad n = 1, 2, 3, \dots.
    \end{equation*}

  点与省略号：
  $\dot{A}$, $\dots$, $f(x_1, x_2, \cdots, x_n)$, $a \cdot b$

  上标下标：
  $\lim_{ n \to \infty } na_{n}^2$ \quad $\lim_{ n \to \infty } na_{n}^2$

  \begin{equation*}\lim_{ n \to \infty } na_{n}^2
    \end{equation*}

  $\sum$, 求和号，$\int$, 积分号， $\prod$ 连乘号

  例子：int积分号，积分下限是alpha，积分上限是 beta，f'()求导
  \begin{equation*}
    \int_{ \alpha }^{ \beta } f'( nx - \frac{1}{x} ) \, dx
    = \int_{ \alpha - \frac{1}{ n\alpha } }^{ \beta - \frac{1}{ n \beta  }  }
    f'(ny) x'(y) \, dy
    \end{equation*}

  $a^abc$ \quad $a^{abc}$ 多字符串用花括号包裹

  根号和分式：
  $\frac{ aaaa }{ bbbb }$ \quad $\sqrt{ 2 }$, $\sqrt[ 10 ]{2}$

  例子：2次方程的求根公式
  \begin{equation*}
    x_{1,2} = \frac{ -b \pm \sqrt{ b^2 - 4ac } }{ 2a }
    \end{equation*}


  Hello world

  这是一句中文

  新华社。
  报道。
\end{CJK}

\end{document}

• sin 三角反正弦函数
• cos 三角余弦函数
• log 对数
• ⊃ 上阕
• inf 下阕
• max 最大值

范例：

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

  $\sin \frac{\pi}{2}$, $\sin$, $\cos$, $\log$, $\sup$, $\inf$, $\max$

  $\inf\limits_{x \in A} f(x)$

\end{CJK}

\end{document}

• () 圆括号
• [] 方括号
• \{\} 花括号。 不带斜杠的花括号{公式}包裹很长的数学公式表示编译后强制显示在一行中不能被断开

调整括号大小：

• \big 用在迭代2个函数。如，\(f(f(x))\), \(f \big( f(x) \big)\)
• \Big
• \bigg
• \Bigg
• \| 显示双 ||

范例：

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

  $(x)$, $[y]$, $\{ a_n \}$

  \begin{equation*}
    f(x_1, x_2, \cdots, x_n) = \sum_{ i = 1 }^n
    \big( x_i - \frac{ x_1 + x_2 + \cdots + x_n  }{n} \big)^2
    \end{equation*}

  $\big( \Big( \bigg( \Bigg($

  $f(f(x))$, $f \big( f(x) \big)$

  $\Big\{ \frac{1}{n} \Big\}$

  $|x|$, $\big| \frac{1}{x} \big|$
  $\|x\|$, $\big\| \frac{1}{x} \big\|$

\end{CJK}

\end{document}

• \bar{x} 字符上加横线。字符串上加 \overline{xxxx}
• \vec{x} 字符上加箭头。
• ~{x} 字符上加波浪线。字符串上 \widetilde{xxx}
• \dot{x} 字符上加点

文本模式中加重音：

• \"{字母} 表示字母上加两点
• \'字母 表示字母上加重音符号

\documentclass{article}
\usepackage{amsmath}
\usepackage{CJKutf8}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

  \begin{equation*}
    \bar{x} = \frac{1}{n} \sum_{i = 1}^n x_i
    \quad \vec{x}, \tilde{x}, \dot{x}, \quad
    \overline{xxx}, \widetilde{xxxx}
  \end{equation*}

  H\"{o}lder Fr\'echet


\end{CJK}

\end{document}

• \mathbf {R} \mathbb{R} 用实体的R或者空心的R表示实数
  • 使用\mathbb 需要在文件开头加上 amssymb包，获得更多字体和数学环境的支持
  • 多个字符的话，直接放花括号中

文本模式：

• \textbf{ 这是一句中文} 文本模式中的粗体，表示强调
• \textit{xxxx} 英文中的斜体

\documentclass{article}
\usepackage{amsmath,amssymb}
\usepackage{CJKutf8}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

  $R$, $\mathbf {R}$, $\mathbb {R}$, $\mathbf{R JKKKLL}$, $\mathbb R DFELJL$

  \textbf{    这是一句中文}, faafsfl  \textit{lksjldjf}

\end{CJK}

\end{document}

• 一份不太简短的latex2介绍： https://github.com/CTeX-org/lshort-zh-cn/releases
• 超详细资料：The Comprehensive LATEX Symbol List ：https://www.ctan.org/pkg/comprehensive
• latex mathematical symbols: https://www.cmor-faculty.rice.edu/~heinken/latex/symbols.pdf
  • 个人常用的 只有4页，覆盖平时95%的常用符号

LATEX Mathematical Symbols

1 Greek and Hebrew letters 希腊字母， \希腊字母英文名

2 LATEX math constructs 常见的数学结构，分式根号等

3 Delimiters 各种括号、绝对值等

4 Variable-sized symbols (displayed formulae show larger version) 求和号、连加号等比较大的符号

5 Standard Function Names 常见的函数名 \函数名 显示正体的函数

6 Binary Operation/Relation Symbols 二元运算符，如加减乘除、交集并集、大于等于小于等于

7 Arrow symbols 所有的箭头

8 Miscellaneous symbols 杂

9 Math mode accents 数学环境中使用的修饰，如重音符号、点、尖、向量等

11 Other Styles (math mode only) 数学环境下可以使用的字体

12 Font sizes 如何调整数字环境或文本环境字体的大小

13 Text Mode: Accents and Symbols 文本环境中可以使用的重音符号、特殊符号

标题

在导言区加入 \title{标题名称}，然后在正文中加入 \maketitle

多行标题需要在标题之间加双斜线\\，双斜线也可以用在正文中表示强制换行

范例：

\documentclass{article}
\usepackage{amsmath, amssymb}
\usepackage{CJKutf8}

\title{我是标题  \\  第二行标题}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\maketitle  

你好呀
你\\好\\呀


\end{CJK}

\end{document}

作者

在导言区插入作者，\author{ 作者1 \and 作者2 }

日期

在导言区插入日期，默认使用当前时间

\date{ 5月1日 }

\date{} 不显示日期行

文档类型从article改为书籍book，\documentclass{book} 标题、作者、日期就会单独一页。

需要在 \maketitle 后插入

• \section{第一个小标题}
• \subsection{子标题}
• \subsubsection{子标题的子标题}
• \chapter{第一章节} 章节的标题需要在文档为书籍book中使用

插入的章节被自动加上序号

范例：

\documentclass{article}
\usepackage{amsmath, amssymb}
\usepackage{CJKutf8}

\title{我是标题  \\  第二行标题}
\author{ 作者1 \and 作者2 }
\date{}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\maketitle  

\section{第一个小标题}

你好呀

\section{第二个小标题}

$\lim\limits_{n \to \infty } na_n^2$

\subsection{子标题}

$\sqrt{2}$

\subsubsection{子标题}

$\sin \frac{\pi}{2}$


\end{CJK}

\end{document}

插入章节

\documentclass[UTF8]{ctexbook}
\usepackage{amsmath, amssymb}

\title{我是标题  \\  第二行标题}
\author{ 作者1 \and 作者2 }
\date

\begin{document}

\maketitle

\chapter{第一章标题}  

\section{第一个小标题}

你好呀

\section{第二个小标题}

$\lim\limits_{n \to \infty } na_n^2$

\subsection{第二层小标题}

$\sqrt{2}$

\subsubsection{第三层标题}

$\sin \frac{\pi}{2}$

\end{document}

目录

正文中加入

\tableofcontents

需要经过2次编译，第一次在目录下生成`文件名.toc`文件，第二次编译引用toc文件生成带目录的pdf

范例：

\documentclass{article}
\usepackage{amsmath, amssymb}
\usepackage{CJKutf8}

\title{我是标题  \\  第二行标题}
\author{ 作者1 \and 作者2 }
\date{}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\maketitle

\tableofcontents

\section{第一个小标题}

你好呀

\section{第二个小标题}

$\lim\limits_{n \to \infty } na_n^2$

\subsection{子标题}

$\sqrt{2}$

\subsubsection{子标题}

$\sin \frac{\pi}{2}$


\end{CJK}

\end{document}

红包-目录超链接

在导言区加

\usepackage{hyperref}

可以看到目录周围用红框框起来了，点一下自动跳到所在标题

当文档很长时就需要这些方便查找

因为在emacs中会用到大量的ctrl键，因此需要把 Ctrl键与Caps键进行交换

windows

• 打开注册表编辑器：
  • 右键点击开始菜单运行(run)-> regedit 或者在搜索栏中搜索registry editor
• 找到注册表路径：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControl\SetIControl\KeyBoard Layout
  • 空白处右键新建二进制文件，文件名为Scancode map
  • 右键文件选择编辑

在Scancode map输入如下代码：

00 00 00 00 00 00 00 00
03 00 00 00 1D 00 3A 00
3A 00 1D 00 00 00 00 00

重启电脑就可以了

交叉引用，指在latex文档插入编号以及对编号的引用

显示公式编号

\begin{equation}
    xxxx
\end{equation}

插入交叉引用:

• \label{xxx}： 给公式自定义一个标签 C-c 回车 lable
• \ref{xxx}这是个说明：引用标签，并给出说明 C-c 回车 ref

\begin{equation}\label{eq:1}
    xxxx
\end{equation}

(\req{eq:1})这是个方程

需要编译2次才能显示。

范例：

\documentclass{article}
\usepackage{amsmath, amssymb}
\usepackage{CJKutf8}

\usepackage{hyperref}

\title{我是标题  \\  第二行标题}
\author{ 作者1 \and 作者2 }
\date{}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\maketitle

\tableofcontents

\section{第一个小标题}

你好呀

\section{第二个小标题}

\begin{equation}\label{eq:1}
  \lim\limits_{n \to \infty } na_n^2
\end{equation}

$\int_0^1 f(x)\, dx$

\begin{equation}
  | \oint_L (z^2 - y^2) dx + (x^2 -z^2) dy + (y^2 - x^2) dz| =
\end{equation}
(\ref{eq:1})这是个方程

\subsubsection{子标题}

$\sin \frac{\pi}{2}$


\end{CJK}

\end{document}

标签规范

• 最好用冒号分隔
• section的标签：sec:xx
• 公式的标签：eq:xxx

在章节后打上对应标签 \label{sec:xxx}

页码编号\pageref{xxx}

范例：

\documentclass{article}
\usepackage{amsmath, amssymb}
\usepackage{CJKutf8}

\usepackage{hyperref}

\title{我是标题  \\  第二行标题}
\author{ 作者1 \and 作者2 }
\date{}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\maketitle

\tableofcontents

\section{第一个小标题}

你好呀

\section{第二个小标题}\label{sec:root}

\begin{equation}\label{eq:1}
  \lim\limits_{n \to \infty } na_n^2
\end{equation}

$\int_0^1 f(x)\, dx$

\begin{equation}
  | \oint_L (z^2 - y^2) dx + (x^2 -z^2) dy + (y^2 - x^2) dz| =
\end{equation}
第\pageref{eq:1}页中\ref{sec:root}节中的(\ref{eq:1})这是个方程

\subsubsection{子标题}\label{sec:t}

$\sin \frac{\pi}{2}$


\end{CJK}

\end{document}

• C-c C-e 输入环境名称如equation，输入环境参数如lable eq:gougu
• C-c C-c latex 编译， C-c C-v 本地打开pdf文件
• 交叉引用 C-c 回车 输入ref， gougu

\begin{环境名}

\end{环境名}

如
\begin{equation}
  \label{eq:gougu}
  a^2+b^2=c^2
\end{equation}
\ref{eq:gougu}

itermize无序列表

• C-c C-e 输入itemize 。第二条itemize由 C-c C-j 生成

\begin{itemize}
\item 第一条
\item 第二条
\item 第三条

  \end{itemize}

enumerate带编号列表

嵌套的子列表编号从字母a开始

• C-c C-e 输入enumerate 。第二条由 C-c C-j 生成
• 第二级enumerate C-c C-e 回车 默认用前一个命令
• 增加交叉引用 在item后面 C-c 回车 输入\label 项目列表的引用一般用it:区分
• 引用方法 C-e 回车 输入 \ref 回车 输入it:补全

\begin{enumerate}
\item 对称性： $d(x,y) = d(y,x)$
\item 正定性
  \begin{enumerate}
  \item $d(x,y) \ge 0$
  \item $d(x,y) = 0 \Leftrightarrow x = y$
  \end{enumerate}
\end{enumerate}

%交叉引用
\begin{enumerate}
\item 对称性： $d(x,y) = d(y,x)$
\item 正定性
  \begin{enumerate}
  \item $d(x,y) \ge 0$
  \item\label{it:strict-pd} $d(x,y) = 0 \Leftrightarrow x = y$
  \end{enumerate}
\end{enumerate}

\ref{it:strict-pd

description关键字环境

\begin{description}
\item[关键字1]
\item[关键字2]
\end{description}

列表的交叉引用

标签一般用 \label{it:xxx} 引用：(\ref{it:xxx})

改变环境： 光标在当前环境中， C-u C-c C-e 输入要改变成的环境名。如description

\begin{description}
\item [对称性]： $d(x,y) = d(y,x)$
\item [正定性]:
  \begin{enumerate}
  \item $d(x,y) \ge 0$
  \item\label{it:strict-pd} $d(x,y) = 0 \Leftrightarrow x = y$
  \end{enumerate}
  
\end{description}

如果(\ref{it:strict-pd})不被满足，则称为....

• C-c C-e 回车 输入最简单的表格 tabular 回车，回车，在Format输入 r|cc 表示是3列的表格

format 中可用的字符：

• r：左对齐
• l：左对方
• c：居中
• |：插入列分隔符

范例：

记$\xi$为Bernoulli随机变量，参数为$p$，则其分布列为
\begin{tabular}{r|cc}
  $k$ & $0$ & $1$ \\ \hline
  $P(\xi = k)$ & $p$ & $1-p$
\end{tabular}

注意事项：

• 列之间以 & 分隔
• 不能漏掉行内公式的$…$
• 行尾换行
  
• 行尾用 \hline 添加横线

表格内

• 有更多的属性就需要把tabular环境放入table环境中，table环境会占据页面中间的位置
  • 在想要补全的地址， C-c ] 补全环境(\end{...})
• \label{xxx} 添加标签
• \caption{xxx} 添加标题
• \centering 页面居中表格

表格在pdf出现的位置

• [b] 置于pdf的底部，如 \begin{table}[b]。一般不用设置，程序会自动设置一个比较好的

范例：

记$\xi$为Bernoulli随机变量，参数为$p$，则其分布列为

\begin{table}[b]
  \centering
\begin{tabular}{r|cc}
  $k$ & $0$ & $1$ \\ \hline
  $P(\xi = k)$ & $p$ & $1-p$
\end{tabular}
\caption{Bernoulli随机变量的分布列}
\label{tab:1}
\end{table}

表\ref{tab:1}是Bernoulli随机变量的分布列。

不让表格在页面上下浮动可以将tabular放到center环境中。

• C-c C-e 输入center

\begin{center}
  \begin{tabular}{|r|cc|} \hline
    $k$ & $0$ & $1$ \\ \hline
    $P(\xi = k)$ & $p$ & $1-p$ \\ \hline
  \end{tabular}
\end{center}

从Excel中导入表格

• C-c C-e table 再输入Format对应的列，如|c|c|c|
• 把Excel保存为.csv文件
• 把.csv文件内容复制到emacs中
• 把","替换成&，emacs中选中内容使用alt+% 输入!替换所有
• 用正则表达式替换在行末加上\\ \hline
  • Alt+ctrl+%：$ –> \\\\ \\hline
  • 在emacs中 2个\\斜杠代表一个斜杠

\begin{table}
  \centering
  \begin{tabular}{|c|c|c|c|} \hline
    A & B & C & D\\ \hline
    5.1 & 4 & 9 & 0.8\\ \hline
    8.1 & 7.4 & 3.8 &0.6\\ \hline
    4.4 & 7.0 & 0.6 & 0.1\\ \hline
  \end{tabular}
\end{table}

• 在导言区调用宏包 graphicx C-c 回车 \usepackage 输入graphicx
• 在想要插入的地方输入 \includegraphics{文件名} 插入图片。 C-c 回车 includegra补全
• [width=?\textwidth] 调整宽度

与表格一样，给图片加上标签和标题需要把它放到一个环境中，figure

• \caption{xxx} 标题
• \label{xx} 标签
• \centering 居中
• 两个并排的图片，放在一个环境里，调整图片宽度使得它们想加小于1就可以了。

\begin{center}
  \includegraphics[width=0.6\textwidth]{1.png}
\end{center}

\begin{figure}
  \includegraphics[width=0.6\textwidth]{1.png}
  \caption{图片}
  \label{fig:fitting}
\end{figure}

\begin{figure}
  \includegraphics[width=0.45\textwidth]{1.png}
  \includegraphics[width=0.45\textwidth]{2.png}
  \caption{图片}
  \label{fig:fitting}
\end{figure}

emacs 中，鼠标选中区域

C-c C-r 编译区域
对比：
C-c C-c 编译全文件
(r = region)

范例：

鼠标选中区域
C-c C-r 回车，默认开始编译，并生成一个 _region_.pdf 文件
C-c C-r 回车，默认View，打开pdf文件

常用选定区域的命令

• C-c * 选中当前章节。需要有auctex包
• C-c . 选中当前环境。需要有auctex包，在行间公式中特别有用
• C-c ; (取消)注释。需要有auctex包。手动注释是在要注释的位置前加 % 百分号

方法1：鼠标左键按住，拖动

在 emacs 中一个区域的范围是由2个点决定的。第一个点是标记(mark)，任何在标记和光标之间的东西都是区域的一部分。在状态栏下面的minibuffer中会有提示信息"Mark set" 。即使这个区域的高亮消失了，那个标记还会存在在那里，还是能对标记和光标之间的内容进行操作。

方法2：Shift + 方向键

方法3：左键点击标记位置，右键点击光标位置

方法4：

1. 激活标记：C-@ 或者 C-空格
2. 用方向键/Emacs快捷键移动光标 或者 C-n 向下移动光标

C-x C-x 交换标记和光标的位置

在latex常用的快捷键组合

• (章节末)输入
• C-c * 选中章节
• C-c C-r，回车，编译章节
• C-x C-x 光标回到章节末
• 继续输入

C-x Tab: 调整区域缩进

• ->：右移1个空格
• Shift + -> ：右移8个空格(= tab)
• <-：左移1个空格
• Shift + <=：左移8个空格(=tab)

C-g 中断当前命令

C-/ 撤消 或 C-_

恢复的话需要撤消我们的撤消：

• 中断撤消：如按一下空格中断撤消
• C-/ 就会是撤消之前撤消

选定全文件

• 方法1：
  • M-< 跳到文件头
  • C-@ 设定标记
  • M-> 跳到文件尾
• 方法2：
  • C-x h 即mark-whole-buffer

C-w 剪切
M-w 复制
C-y 粘贴
M-y 从剪贴析中选择

剪切(删除行)

C-k 剪切光标到行末

C-S-退格 剪切光标所在行  S 为Shitf 键。等同于 C-a C-k C-k

用 C-k 和 C-S-退格删除的内容会保留在剪贴板中，可以用C-y/M-y进行粘贴

剪切3行的三种方法

• 方法1：C-a (至行首)，C-空格 (标记)，
  • C-n, C-n, C-e (移动光标)，
  • C-w 剪切区域
• 方法2：C-a (至行首)，连续按 C-k
• 方法3：连续按 C-S-退格

emacs中连续的命令，可以用 C-y 把连续删除的内容一次性粘贴出来

单词操作

• 退格：向左删除字符
• C-退格：向左删除单词(保存到剪贴板)
• C-d/Delete：向右删除字符
• Alt-d：向右删除单词(保存到剪贴板)

修改方法：

M-x customize-variable 回车 cdlatex-math-symbol-alist

添加或者覆盖已有的快捷键，点INS按钮：

Character: x 设定哪个快捷键
Repeat: 替换内容

范例：0改为\varnothing, 把emptyset放第2层列表，修改完后按Apply and Save保存

Character: 0
Repeat:
  macro: \varnothing
  macro: \emptyset

设置界面也是一个buffer

按C-x b 可以跳回到刚刚的buffer(tex 文件)

使新设置生效的方法：

1. 关闭emacs重新打开
2. 关闭文件重新打开
3. "刷新"文件 需要有auctex包
   1. 利用LaTeX菜单Multifile/Parsing中"Reset buffer"命令 或者 按C-c C-n

M-x customize-variable 回车 cdlatex-math-modify-alist

范例：单引号按t，修饰数学符号

Key character : t 关键字
TeX macro inside  math mode: Value Menu String: \mathbb 空心粗体，在数学环境中使用
TeX macro outside math mode: Value Menu String: 不填，表示在文本环境中没有
Type             : Toggle  Command  把修饰的符号放在花括号里
Remove dot in i/j: Toggle  off (nil) 是否把i/j的点去掉
Italic correction: Toggle  off (nil) 是否需要斜体

Key character : k
TeX macro inside  math mode: Value Menu String: \mathfrak 哥特体，在数学环境中使用
TeX macro outside math mode: Value Menu String: 不填，表示在文本环境中没有
Type             : Toggle  Command  把修饰的符号放在花括号里
Remove dot in i/j: Toggle  off (nil) 是否把i/j的点去掉
Italic correction: Toggle  off (nil) 是否需要斜体
    State : EDITED, shown value does not take effect until you set or save it.
   List description of the LaTeX math accents. Hide
   See ‘cdlatex-math-modify-alist-default’ for an example.  Any entries in this
   variable will be added to the default.
   Each element contains 6 items:
   0. key:      The character that is the key for a the accent.
   1. mathcmd:  The LaTeX command associated with the accent in math mode
   2. textcmd:  The LaTeX command associated with the accent in text mode
   3. type:     t   if command with argument (e.g. \tilde{a}).
                nil if style (e.g. {\cal a}).
   4. rmdot:    t   if the dot on i and j has to be removed.
   5. it        t   if italic correction is required.

生效：C-c C-n 刷新

M-x customize-variable 回车 cdlatex-paired-parens

默认支持 $[{ ，我们再添加一个圆括号匹配：

• 设置为 $([{

不需要刷新，立即生效。

C-c ?：打开tab补全命令帮助界面

定理定义环境特点：

• 使用不同的字体
• 定理环境可以有自带的编号，并且可以用交叉引用的方式引用编号

使用包：

• 定理环境要使用 amsthm 宏包，在导言区加入
• C-c C-n 让 AucTeX 读取导言区

auctex包中快捷键：

导言区： C-c 回车 \newtheorem

• 输入theorem 回车 latex文档中起的名字
• 第一个参数(Optional) Numbered like:，
• 第二参数可选用，
• 最后是在文档中显示的名字

正文： C-c C-e 回车 输入theorem 插入定理

范例：插入一个定理引理

\documentclass{article}
\usepackage{amsmath, amssymb, amsthm}
\usepackage{CJKutf8}

\newtheorem{theorem}{定理}
\newtheorem{lemma}{引理}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\begin{theorem}
  单调数列必有极限。
\end{theorem}

\begin{lemma}
  任意数集必有上确界。
\end{lemma}
\end{CJK}

\end{document}

pdf显示内容

定理 1. 单调数列必有极限。
引理 1. 任意数集必有上确界。

定理引理使用不同的计数器。

如果要使用同一个计数器，就要在定义引理时使用第一个参数： -C-c 回车 \newtheorem

• lemma 回车
• 第一个参数(Optional) Numbered like: theorem

\documentclass{article}
\usepackage{amsmath, amssymb, amsthm}
\usepackage{CJKutf8}

\newtheorem{theorem}{定理}
\newtheorem{lemma}[theorem]{引理}

\begin{document}
\begin{CJK}{UTF8}{gbsn}

\begin{theorem}
  单调数列必有极限。
\end{theorem}

\begin{lemma}
  任意数集必有上确界。
\end{lemma}
\end{CJK}

\end{document}

略

略

引用其它latex文件：

• \input{Tex文件名}

引用的文件只有公式和环境，没有导言区等，编译时可以用：

• C-c _：指定主文件。可看到在文件最后有一些被注释的内容，告诉编译器主文件在哪

如果经常使用多文件，可在emacs配置文件添加如下内容：

;; 编译时，每次都询问主文件，而不是默认把当前文件作为主文件
(setq-default TeX-master nil) 

局部变量使用utf-8编码，可在注释添加

%%% coding: utf-8

C-c `：显示(下一个)错误
M-g p：显示上一个错误
M-x TeX-error-overview：显示所有错误

C-c C-t C-b 打开Bod Boxses 错误提示。排版问题
C-c C-t C-w 打开Warning错误提示

M-x customize-variable 回车 TeX-error-overview-open-after-Tex-run 设置为on：每次编译atex文件后自动显示所有错误窗口

这些交换图表用到的宏包：tikz

• 加载宏包： \usepackage{tikz,tikz-cd}
• 画布：外层equation环境，里层tikzcd环境
• 画点：仿照array环境
• 画箭头：语法：\arrow[options]或者\ar[options]
  • Options:
    • 一定要有！指到哪里：上u下d左l右r
    • 可以有！加标签："f", "f"' 表示标签放在线条外面

范例：生成画布 C-c 回车 usepackage 回车 <宏包名>

插入equation环境：

• equ* TAB

插入一般环境： C-c C-e ENTER <环境名>

\documentclass{amsart}
\usepackage{tikz,tikz-cd}
\begin{document}
\begin{equation*}
  \begin{tikzcd}

  \end{tikzcd}
\end{equation*}

\end{document}

范例：画点、画箭头

编译： C-c C-c LaTeX

查看pdf：C-c C-v

自定义一个插入 \ar[] 的快捷键

M-x customize-variable-other-window 回车 cdlatex-command-alist

ar TAB ENTER

\documentclass{amsart}
\usepackage{tikz,tikz-cd}
\begin{document}
\begin{equation*}
  \begin{tikzcd}
    A \ar[r,"f"] \ar[d,"g"'] & B \ar[d,"h"] \\
    C \ar[r,"i"'] & D
  \end{tikzcd}
\end{equation*}

\end{document}

tikzcd 手册：https://ctan.math.washington.edu/tex-archive/graphics/pgf/contrib/tikz-cd/tikz-cd-doc.pdf

bend left ：弯曲

dashed ：虚线

hook ：实线勾

范例：

\documentclass{amsart}
\usepackage{tikz,tikz-cd}
\begin{document}

Example two
\begin{equation*}
  \begin{tikzcd}
    A \ar[r,dashed,"f"] \ar[rr,bend left,"i"] \ar[rrd,bend right,"j"]
    & B \ar[r,hook,"g"'] & C \ar[d,"h"] \\
    & & D
  \end{tikzcd}
\end{equation*}

Example three
\begin{equation*}
  \begin{tikzcd}
    1 & 3 \ar[l, shift right, "\lambda"'] \ar[l,shift left, "\mu"] \\
  \end{tikzcd}
\end{equation*}

\begin{equation*}
  \begin{tikzcd}
    1 \ar[r,leftarrow, shift left, "\lambda"] \ar[r,leftarrow,shift right,"\mu"']& 3
  \end{tikzcd}
\end{equation*}

\end{document}

• 先在纸上打好格子
• 复杂的图表画几步编译一下
• 不会的部分上网找例子

例4立方体，看似复杂，把它想象成2维，其实是4行4列的点，只是有些点是空的。

Example four
\begin{equation*}
  \begin{tikzcd}
    & f^{*}E_v \ar[dl] \ar[dd] \ar[rr] & & E_v \ar[dl] \ar[dd] \\
    f^{*}E \ar[rr,crossing over] \ar[dd] & & E  & \\
    & U \ar[rr] \ar[dl] & & V \ar[dl] \\
    M \ar[rr] & & N \ar[from=uu,crossing over] &
  \end{tikzcd}
\end{equation*}

from=uu 等价于 uu, leftarrow

例5 2个函子之间的自然变换

Example five
\begin{equation*}
  \begin{tikzcd}
    A \ar[r,bend left, "\alpha"{name=U}] \ar[r,bend right,"\beta"'{name=D}]& b
    \arrow[Rightarrow,from=U, to=D]
  \end{tikzcd}
\end{equation*}

给标签起名，再单独用箭头指向

\begin{equation*}
  \begin{tikzcd}
    A \ar[r,bend left, "\alpha"{name=U}] \ar[r,bend right,"\beta"'{name=D}]& b
    \arrow[phantom,from=U, to=D,"\Downarrow"]
  \end{tikzcd}
\end{equation*}

手写符号识别网站: http://detexify.kirelabs.org

• C-c ` 显示错误
• 标签被盖住时： near start 上移
• 标签比较长时可以用{}括起来。
• tikzcd环境内不能有多余的空行

Emacs 可以在 Windows, Linux, MacOS 全平台上运行, 甚至在 Android 上也可以通过 termux 等命令行工具使用.

• 2023年4月底正式版本 28.2

下面介绍的安装方法主要针对的是最新正式版.

在安装完 Emacs 之后, 我强烈推荐大家在你使用的机器上交换 <大写锁定键> 与 <control>. Emacs 常常使用 以 <control> 开始的快捷键. 在 Emacs 诞生之初时通用的键盘, <control> 确实是在当今键盘 <caps lock> 的位置的. 交换这两个键的具体操作在不同系统上也不一样.

windows

需要去修改注册表. 方法如下

• <Win> + r 输入 regedit 打开注册表
• 找到 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layout]
• 打开或新建 Scancode 文件, 把内容修改为

00 00 00 00 00 00 00 00
03 00 00 00 1d 00 3a 00 
3a 00 1d 00 00 00 00 00

• 保存 Scancode 文件并重启电脑

ubuntu

在 Ubuntu 下, 可以使用图形界面的 gnome-tweaks 找到交换 <caps lock> 和 <control> 的设置. 安装 gnome-tweaks 可以通过 apt 进行:

sudo apt install gnome-tweaks

然后打开 gnome-tweaks 的键盘设置, 在高级选项里有关于 <control> 键的设置. 你不仅仅可以交换它与 <caps lock>, 也可以进行许多别的设置.

又或者, 在很多 Linux 系统的命令行下输入

setxkbmap -option ctrl:swapcaps

也可以交换 <caps lock> 与 <control>.

MacOS

在 MacOS 中, 大家可以在 system -> keyboard -> functional keys 中调整所有功能键的键位.

最后再啰嗦一句, 交换 <caps lock> 与 <control> 绝不是可有可无的事情, 它在我们日常使用 Emacs 中真的非常重要! 大家千万不要怕麻烦.

Window家目录修改

剩下两个设置只有 Windows 用户需要进行. 第一是把 Emacs 的家目录, 在 Emacs 中通过 ~ 访问, 改成 C:/Users/<用户名>/. 默认的家目录是 C:/Users/<用户名>/AppData/Roaming/. 从这个目录出发不方便我们访问像 "我的文档" 这种常用文件夹, 所以我们需要手动修改家目录为 C:/Users/<用户名>/, 与 Linux 和 MacOS 保持一致. 方法是搜索 Edit the system variables, 打开环境变量的设置, 然后增加一个用户的环境变量 HOME, 把它设置为 C:/Users/<用户名>/.

第二是保证你的 Emacs 安装目录在系统变量 PATH 上. 如果不在, 还是在同一个界面, 把包含你 emacs.exe 的文件夹路径手动添加到 PATH 变量中.

windows

env HOME=~/emacs-demo emacs --debug-init

Linux/MacOS

(HOME=$(pwd) emacs --debug-int)

在Emacs 中大家需要理解的一个核心概念就是命令. 在 Emacs 中所有的操作, 无论简单复杂都是命令.

Emacs 这个单词就来自于 macro, 即宏命令. 比如说我们想执行打开一个文件的操作, 有3种方式等价的操作方式:

• 从菜单栏里: file -> visit new file
• M-x find-file
• 用快捷键 C-x C-f 并输入文件名

Emacs 中有许多有用的命令. 你未来也可以自己通过 elisp 语言编写自己命令. Emacs 把其中最常用的命令都绑定了快捷键, 用户自己也可以设置自己的快捷键. 当我们用熟了之后, 很多快捷键就会像打字一样形成肌肉记忆. 作为新手, 我们有很多键盘的快捷操作可以用鼠标代替.

新手必知的几个快捷键

在表中, C 表示 control 键, M 表示 alt. 这也是 Emacs 快捷键通用写法. 最右边一列是快捷键对应的命令名, 也就是第一列所有的快捷键都等价于 M-x 加上第三列.

elisp代码执行：

• C-x C-e ： eval-last-sexp 执行光标所在代码
• eval-region ：执行选中区域代码
• eval-buffer ：执行当前缓冲区代码
• M-x load-file <ENTER> FILE_NAME ：执行指定文件代码

接下来我们介绍如何更好地管理 Emacs 插件, 或叫 Emacs 包 (package). 插件可以给我们带来更多的功能, 是 Emacs 使用中不可缺少的一环. 插件的安装和设置与其它的 Emacs 设置一样, 都放在 Emacs 的启动文件 ~/.emacs.d/init.el 中. 关于插件安装与设置, 我推荐大家使用现在常用的 use-package 语法, 它的语法更简洁, 还可以很方便地自动安装插件.

use-package管理插件的插件

• 更简洁的语法
• 更方便自动安装

两种下载和安装插件的方式

• package.el ：内置
• straight.el 需要访问 github.com 以及使用 git
  • msys2 安装 不行

pacman -S git

我们在 package.el 和 straight.el 的设置示例中都手动检查并安装了 use-package. Emacs 29 后 use-package 已经是内置插件, 相关代码可以省去.

最基本的LaTeX设置

(defun my/latex-hook ()
  (turn-on-cdlatex) 
  (turn-on-reftex)) 
(use-package cdlatex
  :load-path "lisp/" ; 需要手动从网盘或 https://github.com/cdominik/cdlatex/blob/master/cdlatex.el 下载 cdlatex.el 文件, 并置于 ~/.emacs.d/lisp/ 文件夹下
  ;; 若使用 straight, 注释前一行, 并取消下一行注释:
  ;; :straight (:host github :repo "cdominik/cdlatex" )
  )
(use-package tex
  :ensure auctex
  ;; 若使用 straight, 注释前一行, 并取消下一行注释:
  ;; :straight auctex
  :custom
  (TeX-parse-self t) ; 自动解析 tex 文件
  (TeX-PDF-mode t) 
  (TeX-DVI-via-PDFTeX t)
:config 
  (setq-default TeX-master t) ; 默认询问主文件
  (add-hook 'LaTeX-mode-hook 'my-latex-hook)) ; 加载LaTeX模式设置

关于 cdlatex 的安装, 要注意的是, 它并不在任何的软件源时. 如果使用 package.el, 你需要手动下载这个文件 (github 或者我网盘里的备份), 并用 :load-path 关键字指定文件的目录. 如果是 straight, 则需要我们指定 github 源码的网址.

AucTeX 是通过 use-package tex 激活的. 因为不同名的问题, 我们要额外加入 :ensure auctex 或 :straight auctex. 另外, 其实 Emacs 已经内置了 AucTeX, 但不一定是最新版本, 我们这里的 use-package 则会把它更新到最新版.

在用 Emacs 编写 LaTeX 文档的过程中, 你是否…

• 预览 pdf 需要来回在编辑器和 pdf 阅读器之间切换?
• pdf 阅读器想实现一些新功能?
• 想给 pdf 阅读器的常用功能定义新的快捷键?

又或者, 你想用 Emacs 做读书笔记, 需要同时:

• 输入大量的数学符号
• 对 pdf 文件进行批注
• 同步 Emacs 笔记文件和 pdf 文件批注的位置

pdf-tools 可以完美实现这些目标.

与 DocView (Emacs 中内置的 pdf 阅读器) 比较

• DocView: 不清晰, 阅读效果差, 读取速度慢
• pdf-tools:
  • 速度快, 图片渲染效果好
  • 正常鼠标操作 + 大量 (可自定义) 快捷键

功能:

• 基础的 pdf 阅读功能应有尽有, 包括超链接跳转和返回, 展开目录等
• 与 auctex 配合使用, 支持对编译后 pdf 进行正向/反向搜索
• pdf 批注, 高亮, 下划线 (可保存在 pdf 文件上)

使用场景 {#使用场景}

• 编写 latex 文档
• 配合 org-noter 在 pdf 上做读书笔记

https://github.com/vedang/pdf-tools

分为两部分

• 内部安装pdf-tools包
• 外部分装epdfinfo.exe 因为emacs任何图片处理都需要外在的软件支持。

• 向下/上小滑动: 鼠标滚轮, C-n / C-p
• 向下/上大滑动: space / S-space
• 向后/前翻页: n /p

我的设置: 尽量把移动绑定在左手 (awsd), 空出右手进行鼠标操作.

(define-key pdf-view-mode-map
  "d" 'pdf-view-next-page-command) ;; 向后翻页
(define-key pdf-view-mode-map
  "a" 'pdf-view-previous-page-command) ;; 向前翻页
(define-key pdf-view-mode-map
  "s" 'pdf-view-scroll-up-or-next-page) ;; 向下滑动
(define-key pdf-view-mode-map
  "w" 'pdf-view-scroll-down-or-previous-page) ;; 向上滑动

• 高亮: 右键菜单Add markup annotation -> highlight, 或 C-C C-a h (h=highlight)
• 直线下划线: 右键菜单, 或 C-c C-a u (u=underline)
• 波浪下划线: 右键菜单, 或 C-c C-a s (s=squiggly)
• 文字批注: 右键菜单Add text annotation, 或 C-c C-a t (t=text)
• 删除批注: 右键菜单, 或 C-c C-a D (d=delete)

我的设置简化按键:

(require 'pdf-annot)
(define-key pdf-annot-minor-mode-map (kbd "C-a a") 'pdf-annot-add-highlight-markup-annotation) ;; 高亮
(define-key pdf-annot-minor-mode-map (kbd "C-a s") 'pdf-annot-add-squiggly-markup-annotation) ;; 波浪线
(define-key pdf-annot-minor-mode-map (kbd "C-a u") 'pdf-annot-add-underline-markup-annotation) ;; 下划线
(define-key pdf-annot-minor-mode-map (kbd "C-a d") 'pdf-annot-delete) ;; 删除

对于多个一个字母的键绑定，用kbd

这样做的好处：

• 左手负责移动pdf、对选中字段执行命令
• 右手负责点一些区域

• 展示目录: o
  • 跳到目录位置: enter / M-enter
  • 在开了2个窗口时，M-enter 跳到指定pdf位置并关闭大纲
• 关闭目录: q
• 返回上一个位置: l 所有操作会被记录，按l返回上一个操作位置
• 跳到下一个位置: r

这里重新绑定常用的返回功能 (小知识: 在 Sumatra PDF 里对应 Alt-right)

(require 'pdf-history)
(define-key pdf-history-minor-mode-map "b" 'pdf-history-backward)

• 放大/缩小: + / -
• 放大到页宽/页高/屏幕: W / H / P
• 重置: 0

打开 pdf 文件时自动放缩

(add-hook 'pdf-view-mode-hook 'pdf-view-fit-width-to-window) ;; 自动放大到页宽

• 图像旋转 R
• 帮助 h

windows:

(pdf-tools-install)

(setq native-comp-deferred-compilation-deny-list '(".*pdf.*"))
(setq TeX-view-program-selection '((output-pdf "PDF Tools"))) ;; 用pdf-tools 打开 pdf
(add-hook 'TeX-after-compilation-finished-functions
          #'TeX-revert-document-buffer) ;; 在完成编译后刷新 pdf 文件

(define-key pdf-view-mode-map "d" 'pdf-view-next-page-command) ;; 向后翻页
(define-key pdf-view-mode-map "a" 'pdf-view-previous-page-command) ;; 向前翻页
(define-key pdf-view-mode-map "s" 'pdf-view-scroll-up-or-next-page) ;; 向下滑动
(define-key pdf-view-mode-map "w" 'pdf-view-scroll-down-or-previous-page) ;; 向上滑动

(require 'pdf-annot)
(define-key pdf-annot-minor-mode-map (kbd "C-a a") 'pdf-annot-add-highlight-markup-annotation) ;; 高亮
(define-key pdf-annot-minor-mode-map (kbd "C-a s") 'pdf-annot-add-squiggly-markup-annotation) ;; 波浪线
(define-key pdf-annot-minor-mode-map (kbd "C-a u") 'pdf-annot-add-underline-markup-annotation) ;; 下划线
(define-key pdf-annot-minor-mode-map (kbd "C-a d") 'pdf-annot-delete) ;; 删除

(require 'pdf-history)
(define-key pdf-history-minor-mode-map "b" 'pdf-history-backward)

(add-hook 'pdf-view-mode-hook 'pdf-view-fit-width-to-window) ;; 自动放大到页宽

• pdf-tools 的 Github 仓库: https://github.com/vedang/pdf-tools
• msys2 官网 https://www.msys2.org/
• epdfinfo.exe 可用版本: https://www.jianguoyun.com/p/DTiBwxMQ856tCxiflP0EIAA

文本编辑中的两个要素

• 文本本身
• 文本的格式

版本要求

• Emacs >= 25
• AucTex >= 13.1.10 (可通过 M-x package-list-package 中查找 auctex 查看)

将 ("<latex 宏命令>" . <unicode 编码>) 加入列表中

• latex 宏命令一般以 "\\" 开头, 表示一个普通的 "\".
• unicode 编码以 "#x" 表示是16进制数字, 否则就是10进制
• 常用编码表: https://en.wikipedia.org/wiki/Mathematical_operators_and_symbols_in_Unicode

;; #x开头为16进制编码
(require 'tex-mode)
(defun my/more-prettified-symbols ()
  (mapc (lambda (pair) (cl-pushnew pair tex--prettify-symbols-alist))
        '(("\\Z" . 8484) ;; 大多数人在latex中会用 \Z, \Q, \N, \R 表示数域
          ("\\Q" . 8474)
          ("\\N" . 8469)
          ("\\R" . 8477)
          ("\\eps" . 949)
          ("\\ONE" . #x1D7D9)
          ("\\mathbb{S}" . #x1D54A)
          ("\\PP" . #x2119) ;; 个人需要, 经常要使用P和E的数学字体
          ("\\P" . #x1D5AF )
          ("\\Pp" . #x1D40F)
          ("\\E" . #x1D5A4)
          ("\\Ee" . #x1D404)
          ("\\EE" . #x1D53C )
          ("\\Fc" . #x2131)
          ("\\Nc" . #x1D4A9))))
(my/more-prettified-symbols)

个人加入编码的原则

• 原列表中没有的编码
• 像 \N , \Z 等大多数人使用的宏命令, 这样可以减少与他人合作的障碍
• 进一步简化自己的常用命令, 像上面的各种 E, P.

• 实现功能: 用一个 .org 笔记文件作为书本页边空间的延展, 记录任何信息, 包括截图, 数学公式, 代码等
• pdf 窗口和 org 窗口双向同步
  • 在浏览 pdf 文件时, 笔记窗口光标会跟随到相应位置
  • 在笔记文件中移动光标, pdf 文件会跟随滚动

… 或者选择 org 文件的理由

• 电子笔记: 无纸化, 便携, 可检索
• 纯文本格式, 易于保存和同步 (如用 Git)
• 基于 org-mode 的强大功能和生态
  • 诞生于 2003 年 (Markdown 诞生于 2004 年)
  • org-mode 是 Emacs 中最强大的插件
  • 天生为笔记而生. 核心是"大纲式浏览" + "标记语言" + "任务管理"
  • 可以输出成 markdown, html, latex, odt 等多种格式
  • 本身支持 LaTeX 公式的编辑与预览

github: https://github.com/org-noter/org-noter

• org-mode: Emacs 自带, 可以通过 M-x package-list-package 更新到 Melpa 最新版
• pdf-tools: 阅读 pdf 必备:
• org-noter: M-x package-list-package 安装 Melpa 最新版
  • 2023年3月更新内容
    • 2维笔记定位
    • djvu, epub 文件支持
    • 批注小标题优化
  • 如果安装了 use-package, 可将以下代码加入 init.el 自动安装

(use-package org-noter
  :ensure t )

org-mode 中与 LaTex 有关的设置

  (use-package org
    :defer t ;; 延迟加载
    :custom
    (org-highlight-latex-and-related '(native latex entities)) ;; LaTeX 高亮设置
    (org-pretty-entities t) ;; LaTeX 代码的 prettify
    (org-pretty-entities-include-sub-superscripts nil) ;; 不隐藏 LaTeX 的上下标更容易编辑
    (org-format-latex-options
     '(:foreground default :background default :scale 1.8 :html-foreground "Black" :html-background "Transparent" :html-scale 1.0 :matchers ("begin" "$1" "$" "$$" "\\(" "\\["))) ;; 增大公式预览的图片大小
    :config
    (add-hook 'org-mode-hook #'org-cdlatex-mode) ;; 打开 cdlatex
)

cdlatex 的设置可以参考我的视频

• 【教程】 LaTeX+Emacs 从零开始2-2节: cdLaTeX 简介
• 【教程】 LaTeX+Emacs从零开始2-4节：cdLaTeX自定义设置

我会在另一期教程中详细介绍 org-mode 中 LaTeX 编辑的设置.

需要借助 org-download 实现. 在这里只给出实现截图功能的设置代码, 以后的教程再详细讲解.

使用方法

• 使用系统截图工具 (Windows 下用 <Win>+<shift>+s) 将截图保存到剪贴板
• 用 C-M-y (绑定了 org-download-clipboard 函数) 将剪贴板中图片粘贴到 org 文件中.

安装方法

• Linux / MacOS
  • 安装截图工具 snipaste
  • 用以下 use-package 代码安装及设置

(use-package org-download
  :ensure t ;; 自动从 melpa 上安装
  :defer t ;; 延迟加载
  :bind
  (:map org-mode-map
        ("C-M-y" . org-download-clipboard)) ;; 绑定从剪贴版粘贴截图的快捷键
  :custom
  (org-download-heading-lvl 1) ;; 用一级标题给截图文件命名
  :config
  (setq org-download-image-attr-list
        '("#+ATTR_HTML: :width 80% :align center"))
  (setq-default org-download-image-dir "./images")) ;; 用同级 ./img 目录放置截图文件

• Windows

  • 需要安装 ImageMagick, 并保证 magick.exe 在 PATH 变量的路径中

    用 msys2 安装

    pacman -S mingw-w64-x86_64-imagemagick
    

  • 从这里或网盘下载 org-download.el 文件, 置于你的 .emacs.d 文件夹合适的路径中 (如 ~/.emacs.d/lisp/)

  • 使用以下 use-package 代码及设置

    (use-package org-download
      :ensure async ;; 因为不是从melpa安装, 需要手动保证async安装
      :defer t ;; 延迟加载
      :load-path "~/.emacs.d/lisp/"
      :bind
      (:map org-mode-map
            ("C-M-y" . org-download-clipboard)) ;; 绑定从剪贴版粘贴截图的快捷键
      :custom
      (org-download-heading-lvl 1) ;; 用一级标题给截图文件命名
      :config
      (setq-default org-download-image-dir "./images")) ;; 用同级 ./img 目录放置截图文件
    

笔记核心功能:

• 输入: 记录
• 输出: 信息的提取与归纳

笔记类型举例

• 课堂笔记
• 学习心得, 复习笔记
• 读书笔记
• 数学草稿
• 科研日志, 灵感
• 教程/食谱/日记等, 例如: "如何安装Emacs", "如何做红烧肉"

…

从笔记高效地提取信息很难

• 纸质笔记
  • 优点: 简单
  • 缺点: 不能检索
• 电子笔记: LaTeX, org, markdown 等
  • 优点: 可全文搜索, 读取信息能力大大提高
  • 缺点: 思考的过程, 知识间的联系难以体现.

• 自上而下的树状结构
  • 树状结构无处不在: 图书馆目录, 文件夹, 书本章节段落
• 缺陷
  • 输入: 初始分类难
  • 输出: 不利于发现联系
• 传统笔记的完美形式就是一本书
• 但是现代人遇到问题第一反应不是去翻书, 而是用搜索引擎或 ChatGPT.

• 双链笔记: 原子化笔记 + 网状结构
  • 原子化笔记: 将笔记拆分成独立, 完整的小条目
  • 网状结构: 用 链接 串连笔记, 自下而上生成结构
• 原型: 卡片盒笔记 (Zettlekasten)
  • 卢曼 (Luhmann, 1927-1988): 德国社会学家
  • 卢曼从1952年左右开始构建卡片盒笔记, 最后笔记包含9万余条目
  • 卢曼一生发表了50本著作与550篇论文
• 现代实现方式: 双链笔记/个人知识库软件 (2020年前后)
  • Roam Research, Obsidian, Logseq, Notion …
  • 在 Emacs 中: 基于 org-roam 的知识管理系统

… 而不是 Roam Research, Obsedian, Logseq, Notion, …

• 核心: 笔记间的 链接
• 笔记类型
  • 灵感笔记 (fleeting note)
  • 文献笔记 (literature note)
  • 永久笔记 (pernament note)

前2种笔记类型相当于基础信息的输入，输入基础信息后把他们整理成永久笔记，并且在永久笔记之间添加合适的链接。用双链笔记工具发现有着密切联系的笔记。

• 自下而上生成结构: 一组产生密切联系的笔记自然而然形成一个主题, 一个主题可以形成一条新的永久笔记并与其它笔记产生联系. 主题的结合可以产生新的主题, 如此反复.
• 与个人 wiki 的区别: 个人知识库不仅仅是知识的记录, 还有对知识的归纳和提炼 – 这由我们建立的 链接 体现
• 参考资料
  • How to take smart notes: Sönke Ahrens
  • (中文版) 卡片笔记写作法.

• 本期
  • 安装与基本设置
  • 今天以后大家可以用 org-roam 记录学习 org-roam 的笔记
• 与 Zotero 文献管理整合 (org-ref, helm-bibtex, org-roam-bibtex)
• 与 org-noter 整合
• 笔记模板设置
• org 笔记流程优化
  • 数学公式 (org-cdlatex, org-preview)
  • 自动补全 (company)
  • 中文输入法 (pyim)
  • 交叉引用 (org-ref)
  • org 界面优化 (org-modern, org-face …)
• 项目管理
• 任务管理 (org-agenda)
• 日记系统 (org-roam-daily)
• 可视化 (org-roam-ui)
• 导出设置

……

以Emacs 28为准

• gcc 编译器: 用于编译 emacsql-sqlite (Emacs 29后应该不再需要)

  • Windows 下可通过 msys2 安装 (推荐), 并保证在系统可执行文件目录下

    pacman -S mingw-w64-x86_64-gcc
    

  • Linux 或 MacOS 下大概率系统自带
• org-roam 插件
  • 用内置的 package-el 安装: M-x package-install <return> org-roam <return>
  • use-package 模块中 :ensure t (见后面示例)
• org-roam-ui 插件
  • 用内置的 package-el 安装: M-x package-install <return> org-roam-ui <return>
  • use-package 模块中 :ensure t (见后面示例)
• emacsql-sqlite
  • 安装后第一次加载 org-roam, Emacs 会提示正在编译 emacsql-sqlite, 请耐心等待.
  • 编译成功后系统中会找到类似 .emacs.d/elpa/emacsql-sqlite-XXXXX/sqlite 的目录

• 笔记目录: 需要提前手动创建, 要易于同步;
• 日记设置: 目录与快捷键

• 快捷键: 使用任何一个将会启动 org-roam

  (use-package org-roam
    :ensure t ;; 自动安装
    :custom
    (org-roam-directory "~/roam-notes/") ;; 默认笔记目录, 提前手动创建好
    (org-roam-dailies-directory "daily/") ;; 默认日记目录, 上一目录的相对路径
    (org-roam-db-gc-threshold most-positive-fixnum) ;; 提高性能
    :bind (("C-c n f" . org-roam-node-find)
           ;; 如果你的中文输入法会拦截非 ctrl 开头的快捷键, 也可考虑类似如下的设置
           ;; ("C-c C-n C-f" . org-roam-node-find) 
           ("C-c n i" . org-roam-node-insert)
           ("C-c n c" . org-roam-capture)
           ("C-c n l" . org-roam-buffer-toggle) ;; 显示后链窗口
           ("C-c n u" . org-roam-ui-mode)) ;; 浏览器中可视化
    :bind-keymap
    ("C-c n d" . org-roam-dailies-map) ;; 日记菜单
    :config
    (require 'org-roam-dailies)  ;; 启用日记功能
    (org-roam-db-autosync-mode)) ;; 启动时自动同步数据库
  
  (use-package org-roam-ui
    :ensure t ;; 自动安装
    :after org-roam  
    :custom
    (org-roam-ui-sync-theme t) ;; 同步 Emacs 主题
    (org-roam-ui-follow t) ;; 笔记节点跟随
    (org-roam-ui-update-on-save t)) 
  

创建链接是最基础也是最重要的功能!

• org-roam-capture (快捷键 C-c n c)

  创建一条新笔记. 未来可以预设不同主题的默认模板. 每一条笔记就是一个 org 文件

• org-roam-find (快捷键 C-c n f)

  通过关键词查找笔记并跳转

• org-roam-insert (快捷键 C-c n i)

  插入一条笔记的链接

  • 在查找笔记时利用 org-roam-find 的界面
  • 若笔记不存在, 则利用 org-roam-capture 的界面创建笔记
• 删除笔记: 直接删除笔记文件即可, 如 M-x delete-file
  • 更新数据库：~org-roam-db-sync~
• ui界面： C-c n u
• org-mode 内链接跳转: 鼠标点击或 C-c C-o (org-open-at-point)

• 加入标签: 普通的标签可以看作一个特殊的笔记条目, 可以用 org-roam-insert 去插入一些以关键字为标题的笔记充当标签.

  一个通用惯例是在笔记头部用 org 的列表格式罗列标签, 如

  - tag :: <tag-1>, <tag-2>, <tag-3>
  

以后我们也可以把这一行加入笔记模板

vertico + orderless

(use-package vertico ;; 补全界面优化
  :ensure t
  :config
  (vertico-mode))
(use-package orderless ;; 无序搜索
  :ensure t
  :custom
  (completion-styles '(orderless basic))
  (completion-category-defaults nil)
  (completion-category-overrides '((file (styles partial-completion)))))

• org-roam 的笔记文件是纯文本文件, 用任意网盘同步即可
  • 不同机器上要设置好 org-roam-directory 变量 (或者直接放在网盘目录下)
  • 也可以用 git 同步: 可控制文件类型, 版本控制
• 一般不需要同步数据库文件 org-roam.db.
  • 此数据库文件保存了链接信息, 一般保存在 ./emacs.d/ 目录下
  • 当笔记条目很多的时候, 这个文件会很大
  • 在不同的机器上可以根据 org 文件自动生成的 ((org-roam-db-autosync-mode))
• 数据库更新
  • 自动更新: 通过 (org-roam-db-autosync-mode) 实现
  • 手动更新
    • 执行 M-x org-roam-db-sync
    • Windows 下执行这一命令可能会出现 Error ....... Selecting deleted buffer 的错误信息. 只要 emacs-sqlite 已经正常安装, 无视这条错误信息并再次执行 org-roam-db-sync 即可.

A complex system that works is invariably found to have evolved from a simple system that worked. A complex system designed from scratch never works and cannot be patched up to make it work. You have to start over with a working simple system. – Gall's Law

• 卡片盒笔记是一种全新的笔记模式, 需要学习和练习才能掌握
• 特点是链接, 链接, 链接
  • 链接帮助笔记自发地形成结构
  • 链接是我们思想的结晶
• 我的 Emacs 设置可以在 https://gitee.com/mickey991/emacs-latex/tree/master/my-emacs-config 找到.

Zotero 原本是火狐 (Firefox) 浏览器中的一个插件, 用于从网页上读取文献信息或保存网络快照等, 在火狐上可以直接使用, 而在其它浏览器上需要配合浏览器插件. 2017 年 Zotero 5.0 发布, Zotero 成为一个独立的软件. 在所有浏览器中使用都需要同时运行 Zotero.

Zotero 和它的浏览器插件 (Zotero Connector) 都可以从它的官网上下载. Zotero 的PC端支持 Windows, MacOS, Linux 等系统, 移动端暂时只支持苹果系统, 但在安卓上有第三方软件. 浏览器插件支持 Edge, Chrome, Safari 以及 Firefox 等主流浏览器.

• zotero 界面

收藏夹 - 文献列表 - 文献信息

• 收集夹功能
  • 同一文献可以属于不同收藏夹
  • 同一收藏夹内文献可以导出成 .bib 或其它文件
  • 小技巧：按 ctrl 并手动手动文献，左侧会高亮文献所在收藏夹
• 文献可以有 pdf 文件作为附件
  • 双击文献可以用 zotero 内置 pdf 阅读器打开 pdf文件
  • 内置阅读器支持高亮、批注等
  • 也可以设置别的默认阅读器

Zotero 的界面从左至右分为3部分. 中间是文献列表, 右边是当前选中文献的信息, 包括标题, 作者等. 具体的信息类型会根据文献的类别, 如期刊文献, 书藉, 网页, 学位论文等, 而有所有不同. 最左边是用户自己设置的收藏夹 (collection), 可以嵌套, 用于文献的整理和分类.

同一个文献可以出现在多个不同的收藏夹. 把文献加入收藏夹的方式很简单: 用鼠标拖动文献至指定的收藏夹即可. 这里有一个小技巧, 按住 <ctrl> 并点击文献, 左边一栏就会高亮文献出现的所有收藏夹.

除了按照主题分类文献外, 我也常会把同一研究课题相关的文献放在同一个收藏夹. 当需要撰写课题相关的论文时, 可以使用 Zotero 的导出功能, 将同一个收藏夹内的参考文献信息导出成 .bib 文件. 如果不用 LaTeX 进行写作, 也可以导出成其它常见格式用于论文写作. 导出文献非常灵活, 你也可以 选中任意数目的文献, 然后鼠标右键菜单中选择导出即可.

文献可以有附件, 一般是 pdf. 这里的 pdf 文件既可以是下载文献信息时 Zotero 自动下载的, 也可以是你手动添加的. 当文献有 pdf 附件时, 只要双击就能在 Zotero 的内置 pdf 阅读器内打开. 最新的 pdf 阅读器效果还是很不错的, 可以高亮批注等等, 也可以与 Zotero 其它文献阅读功能配合, 当然我们最终会使用 Emacs 中的 org-noter 来进行文献阅读. 你也可以设置用电脑上其它的 pdf 阅读器打开 pdf 的默认阅读器.

Zotero 的强大就在于它加入文献的方式非常灵活. 主要用下面3种方式.

1. 通过浏览器中的 Zotero Connector 插件
2. 通过文献的标识码
3. 通过本地的 pdf 文件

在第一种方法中, 打开任意包含文献的网站 (最好是期刊官网), 点击 Zotero 插件的图标就可以自动读取网页上的文献信息.

如果网站上允许下载 pdf 全文, Zotero 还会自动下载. 对于普通网页, Zotero 默认会保存网页快照. 这在10年前网速和流量短缺时是一很有用的功能, 可以在有限的时间内快速保存网页以便以后阅读, 如今用处不大了.

第二种方法支持的标识码包括 DOI, ISBN, Arxiv ID 等. 点击 Zotero 文献列表上左起第二个画笔的小图标, 输入标识码, 就可以自动下载文献和 pdf 文件.

这里推荐大家尽量使用前两种方式下载, 因为这样可以保证你在论文写作时, 所引用的参考文献的信息是准确无误的. 这里首要是保证文献信息的来源准确. 当你有了文献信息后, 也可 c 通过其它手段下载 pdf 全文, 然后在 Zotero 中用右键点击文献, 选择添加 pdf 附件 (attachment).

如果实在不得已, 你也可以采用第三种方法: 手动从本地的 pdf 文件创建一个文献条目. 方法是点击文献列表上左起第一个绿色的加号, 选择 Store copy of file. Zotero 会尝试从 pdf 文件中读取文献的信息并生成一个文献条目.

我们在使用中重复添加一个文献是很常见的, 比如说你可能几年前找过这个文献, 但你忘记了, 后来又在做另一个课题的时候碰到了. 在 Zotero 中有一个很方便的功能, 可以快速整合不同版本的文献信息. 点击左侧收藏夹最下面的 Duplicate Items, 就会显示文献库中所有重复的条目. 我们可以手动选择保留哪一个版本的标题, 作者, 期刊信息等, 然后选择 Merge, 将不同版本的文献合并成同一个条目.

总结起来, Zotero 实现了如下核心功能

• 收集并整理文献信息
• 根据需要导出文献引用信息
• 管理文献 pdf

因为 Zotero 还有一个强大的生态, 所以它的功能远不止上面介绍的这些. 我平时使用更多是把 Zotero 作为个人资料库里文献管理的一个入口, Zotero 的其它功能也可以在 Emacs 中更好地实现. 但是在这里还是要向大家介绍两个非常实用的 Zotero 插件: Better BibTeX 和 ZotFile.

Better BibTeX 可以优化导出 .bib 文件时引用键名的生成, 还可以对导出的 .bib 文件实时更新. 它也是 Zotero 与其它笔记软件, 如 Org-Roam, Obsidian, Roam Research 等进行交互的必备插件.

ZotFile 补充了一些 pdf 文件管理的功能. 它可以自动对 pdf 附近按自定义规则重命名, 并用个人网盘同步, 解决 Zotero 的同步问题.

要安装 Zotero 插件, 我们首先在它的插件网站上下载对应的 .xpi 格式文件, 然后打开 Tools -> add-ons , 选择从文件进行安装即可.

Better BibTex 的设置在 Edit -> Preference 下.

首先修改引用键名的格式. 比如这里我推荐的一个设置是 authorsAlpha+year+shorttitle(3,3)

• authorsAlpha: 采用 bibtex 中的 alpha 风格; 单作者取姓的前3字母, 2个以上取首字母
• year: 4位数字年份
• shorttitle(m,n): 标题前 m 个单词, 其中前 n 个单词首字母大写

大家可以在 https://retorque.re/zotero-better-bibtex/citing/ 中找到更多的设置

键名设置的原则是在突出重要信息的前提下尽量简短. 也方便有时我们直接在 pdf 文件目录进行搜索 (如在手机和平板上).

第二, 为了保证键名的唯一性, 大家可以在下面勾选 across all libraries.

最后, 我们可以设置 Better BibTeX 自动更新导出的 .bib 文件. 当我们选中一个收藏夹并且导出时, 选择 Better BibTeX 格式, 并且勾选下面的 "自动更新". 然后, 我们在 Better BibTeX 的设置的 Automatic Export 这一页就可以看到刚刚导出的 .bib 文件了.

我们可以把更新的频率选为 On change, 即随时更新.

在 Edit -> Preference -> Sync 下面, 大家可以注册并登录 Zotero 帐号实现不同设备间的同步. 但是 Zotero 的免费空间只有500M, 这对于 pdf 文件的同步是不够的. 所以建议大家用下面介绍的 ZotFile 同步 pdf 附件, 而让 Zotero 只负责同步文献信息.

Better BibTeX 的键名无法同步, 但是只要规则相同, 产生的键名是一样的. 在新机器上建议大家先设置好 Better BibTeX 的键名规则, 再登录 Zotero 帐号同步文献信息. 如果已经同步了文献信息, 则需要手动更新所有的 Better BibTeX 键名, 大的文献库需要几分钟的时间.

下面我们讲解 Zotfile 的设置. 设置界面在 Tools -> ZotFile Preference 菜单下.

第一步, 我们设置在 General Settings -> Custom Locations 下设置一个同步目录. 这里你可以设置为个人网盘里一个子目录. 下面还有一个是否使用子文件夹的选项, 没必要勾选, 因为子文件夹不方便搜索, 而且 Zotero 本身的收藏夹功能已经对文献做好分类了. 存储时没必要再分一次类.

第二步, 我们给 ZotFile 设置一个统一的命名规则, 用于给新添加的 pdf 文件重命名. 设置在 Renaming Rules 下面. 这里推荐使用 %b, 即采用了之前 BibTeX 的键名作为文件名.

3步, 因为 ZotFile 可以自动给 所以我们要设置一个d. 利于我们在不同机器上的使用. 这样设置也可以方便笔记软件在读取 .bib 文件时能通过键名更快地找到对应的 pdf 文件. 也方便我们自己的查打.

最后, 我们在 Advanced Settings -> automatically rename new attachment 中选择 alwasy rename. 这样可以对对 Zotero 自动下载的 pdf 文件自动重命名并移动至我们的个人网盘中. 如果你是手动加入的 pdf 文件, 也可以手动重命名并移动 pdf 文件. 方法是右键点击文献条目, 选择 rename and move .

以上就是 Zotero 的基本设置. 下次我们会介绍如何在 org-roam 笔记流程中整合 Zotero, 包括

• Emcas 中读取 Zotero 文献数据库并进行引用
• 每一条引用的 Zotero 文献建立一则 org-roam 笔记
• 将上述笔记作为 org-noter 笔记文件, 在 Emacs 中阅读 Zotero 文献的 pdf 附件

关于 org-roam 和 org-noter 大家可以参考我的视频 BV1qV4y1Z7h9 与 BV1Tc411s7Tu.

作为 Emacs 和 Zotero 的重度老用户, 将 Emacs 的笔记功能与 Zotero 文献管理整合是我一直以来的梦想. 这次在学习使用 org-roam 的过程中, 终于在 org-roam 的框架下找到了一套成熟的工作流程. 这是我搭建个人知识库的最后一块重要拼图, 也让我毫无顾虑地把所有的笔记都投入到 org-roam 中. 这里非常高兴能与大家分享实现过程.

插入文献笔记流程如下. 具体可见视频中演示.

• 在 org-roam 笔记中, 执行命令 M-x orb-insert-link (快捷键建议: C-c n k) 开始插入一则文献笔记.
• 在 helm-bibtex (或 ivy-bibtex) 的文献搜索界面中, 输入关键词定位文献, 回车确认.
• 进入 org-roam 模板选择界面, 选择预先设置好的文献笔记模板
• 进入 capture 界面, 此后步骤与正常笔记一样
• 这样创建的笔记有多重功能
  • 是普通的 org-roam 双链笔记
  • 在笔记界面执行 M-x org-noter (快捷键建议: C-c n n) 可打开 org-noter 界面.
  • 在笔记界面执行 M-x orb-note-action (快捷键建议: C-c n a) 可执行其它一些操作, 如打开文献网址, 复制文献 bibtex 条目等.

当一则文献笔记创建后, 可以采用 C-c n i 或 C-n n k 插入链接. 区别是

• C-c n i (M-x org-roam-node-insert): 默认链接名是文件名, 也就是文献标题
• C-c n k: 默认链接名可以是引用键名

我们使用了许多插件相互配合才实现了最后的效果. 这里不同插件的设置环环相扣, 所以有必要在一开始对每个插件的角色和功能做一个梳理.

• Zotero
  • 用 Better BibTeX 导出文献数据至 bib 文件
  • 用 ZotFile 保存 PDF 文件 (一般是网盘文件夹)
• helm/ivy-bibtex:
  • 将上面 bib 文件的信息读入 Emacs, 并提取文献的标题, 作者, 引用键名等
  • 提供搜索文献信息的界面

• org-roam:

  准备一个符合 org-noter 的笔记格式的 org-roam 模板

• org-roam-bibtex + org-roam
  • 利用提取的文献信息和上面的模板生成一则 org-roam 笔记
  • 其它一些操作, 如打开文献网址, 打开文献 bibtex 条目等

• org-noter + pdf-tools

  打开 org-roam 笔记中的 PDF 文件并阅读, 做读书笔记.

关于 org-noter 和 pdf-tools 的设置请参考:

• 【Emacs+LaTeX教程】Emacs最强内置pdf阅读器pdf-tools简介
• 【从零搭建Emacs个人知识库】org-noter配置及使用

• 这部分代码建立在 org-roam 的基础设置上, 大家可以参考

  【从零搭建Emacs个人知识库】org-noter配置及使用

• 设置代码中大量使用了 use-package 的功能. 如果想了解 use-package 的基本使用, 可以参考

  【省时省力写LaTeX】新手Emacs快速配置与插件管理

最后简单介绍 helm-bibtex 的一些搜索规则

• 所有关键字以空格分开. 默认可以搜索标题, 作者, 年份, 作品类型, 引用键名
• 关键字前加 ! 表示取否定. 例如 brown !motion 不会匹配 browian motion, 但可以匹配 browian web.
• 全小写的关键字可以匹配大小写, 但是所有关键字中包含至少一个大写字母, 则必须大小写精确匹配. 例如: Brown motion 可以匹配 Brownian motion, 但不能匹配 Brownian Motion, brownian motion. 但是 brown motion 就可以匹配以上所有选项
• 支持正则表达式. 常用的有
  • .? 表示零个或一个字符
  • .* 表示零个或多个字符
  • 201[2-8] 可以匹配 2012 年至 2018 年的文献, 19[6-8] 可以匹配 1960 年至 1989 年的文献.
  • brown \(web\|motion\) 可以匹配 brownian web 或者 brownian motion.