[emacs] org-mode的一些小技巧

Table of Contents

• 1 快速输入 #+BEGIN_SRC … #+END_SRC
• 2 代码按语法高亮
• 3 导出成HTML时的一些问题和技巧
  • 3.1 生成目录表
  • 3.2 为每个分节的标题添加标号
  • 3.3 禁用下划线转义
• 4 让不同级别的标题采用不同大小的字体
• 5 org-mode与CUA的兼容性问题
• 6 两个与中文相关的问题
  • 6.1 不关闭中文输入法，输入章节标题里面的星号
  • 6.2 中英文字体混排时的表格对齐问题

1 快速输入 #+BEGIN_SRC … #+END_SRC

用org-mode写文章的的时候，经常需要引用代码片段或者程序输出，这就需要输入 #+BEGIN_SRC ... #+END_SRC 或者 #+BEGIN_EXAMPLE ... #+END_EXAMPLE 。输入的次数多了，就会想办法自动化，要么是用宏，要么是手工写 elisp函数，要么是借助 yasnippets 或者 skeleton 框架来写代码片段（比如 Emacs中文网 就发过一篇 《GNU Emacs Org-mode 写作的几个快捷方式》 ，那是借助 skeleton 来实现的）。

但其实，org-mode已经内置了快速输入的方法: 输入 <s 再按TAB键 ，就会自动展开为 #+BEGIN_SRC ... #+END_SRC 。类似地，输入 <e 再按TAB键，就会自动展开为 #+BEGIN_EXAMPLE ... #+END_EXAMPLE 。

参考:

• GNU Emacs Org-mode 写作的几个快捷方式
• Are there any shortcuts for entering source blocks and comment lines?

2 代码按语法高亮

org-mode在导出成HTML时，可以对代码按照各自的语法进行高亮（只要在 #+begin_src 后面声明的语言是emacs所 支持的，其实也就是对应的major mode存在，比如声明为 #+begin_src js2 就要求 js2-mode 是存在的）。

但能不能在编辑的时候，就可以在org-mode里面看到语法高亮的效果呢？答案是肯定的！

(setq org-src-fontify-natively t)

不过没有看到这个设置的更详细说明（我也没来看代码），在org-mode的文档中仅仅在Editing source code这一节 看到一句: To turn on native code fontification in the Org buffer, configure the variable org-src-fontify-natively. 另外，Pretty fontification of source code blocks这篇文档里有效果图:

 

3 导出成HTML时的一些问题和技巧

3.1 生成目录表

如果想在导出成HTML时在文档前面生成一个章节目录表（Table of Contents），那么可以在文件头部的 OPTIONS 里面添加 toc:t 参数

#+OPTIONS: toc:t  ^:nil author:nil num:2

也可以设置 org-export-with-toc 这个变量

(setq org-export-with-toc t)

如果只想针对前面两个级别生成目录表，可以设置该值为相应的数字

#+OPTIONS: toc:2  ^:nil author:nil num:2

3.2 为每个分节的标题添加标号

导出成HTML时，如果不自定义css（这个高级话题留待下次再说），那么h1, h2, h3各个级别的标题只会字体大小有 点不同，不会呈现不同颜色，不会有缩进，于是阅读起来各节之间的关系就搞不清楚了。可以设置 org-export-with-section-numbers 让导出时为各章节的标题添加 1.2.3 这样的

比如:

  * header foobar

  ** header hello

  ** header welcome

  * header hehe
  some text here

  ** header haha

  *** low level

导出时会变成:

1 header foobar

1.1 header hello

1.2 header welcome

2 header hehe
some text here

2.1 header haha

2.1.1 low level

如果只想针对前面两个级别生成分节号，可以设置该值为相应的数字。比如上面的例子如果设置 org-export-with-section-numbers 为 2 ，导出时就变成了:

1 header foobar

1.1 header hello

1.2 header welcome

2 header hehe
some text here

2.1 header haha

*low level*

3.3 禁用下划线转义

org-mode的文档在导出到html时，有一个挺烦人的问题就是 abc_def 会变成 abc_def，这其实是一种类似TeX的 写法，主要也就是在少数场景下有意义（其实与之相伴的还有一个 10^24 会变成 10²⁴，不过这个对我影响不 大，因为我很少会用到这种写法）。

关闭这个功能的方法是在org文件头部的 OPTIONS 里面添加 ^:nil:

#+OPTIONS: ^:nil

参考: Export settings - The Org Manual

上面的方法是针对当前文件的，如果想针对所有文件缺省关闭这个功能，需要在 ~/.emacs 中设置:

(setq-default org-use-sub-superscripts nil)

4 让不同级别的标题采用不同大小的字体

我从vim转到Emacs的其中一个原因是Emacs的GUI版本支持同时使用多种字体，比如上面的截图中就可以看到标题采 用了较大的字体。而以前对Emacs不太熟悉时，试用 color-theme-tangotango 期间无意中发现它能让 org-mode 的各种标题用不同大小的字体显示，还以为是比较神奇的功能，而不愿意切换到其他的theme去。

其实定制一下 org-level-1, org-level-2 等face的 height 属性就可以了（不过如果你用了其它theme的话， 要在加载这些theme之后再执行一遍下面这些配置，或者你把它们放在 org-mode-hook 中去执行）:

(set-face-attribute 'org-level-1 nil :height 1.6 :bold t)
(set-face-attribute 'org-level-2 nil :height 1.4 :bold t)
(set-face-attribute 'org-level-3 nil :height 1.2 :bold t)))

5 org-mode与CUA的兼容性问题

https://github.com/mlf176f2/org-cua-dwim.el

虽然我不喜欢 cua-mode 里面的 C-c, C-x, C-v 等键，但 cua-mode 里面的 shift 选中，cua rectangle这些功能我还是比较喜欢的，所以我默认还是打开 cua-mode 。

不过 org-mode 跟 cua-mode 不兼容，主要的问题是无法按住 Shift 来选择文本了（ <S-up> <S-home> <S-prior> S-M-b 等)。

安装 org-cua-dwim 这个包即可解决这个问题。不过对于章节标题等特殊的地方，还是org-mode自己控制的。

 

6 两个与中文相关的问题

6.1 不关闭中文输入法，输入章节标题里面的星号

频繁打开/关闭输入法还是挺翻的，比如在连续输入章节或者列表项时，输入章节前面的 * 或者 列表项 前面的 * 或者 - 号，都要先关闭输入法，否则输入的是 × 和

不过可以用下面的方法解决:

(defun org-mode-my-init ()
  ; ......
  (define-key org-mode-map (kbd "×") (kbd "*"))
  (define-key org-mode-map (kbd "－") (kbd "-"))
  )

(add-hook 'org-mode-hook 'org-mode-my-init)

6.2 中英文字体混排时的表格对齐问题

org-mode的表格功能还是比较酷的，用起来相当方便（比较大的缺点是不支持跨列或者跨行合并单元格，甚至简单 一点，表格的某一行实际两行来存放内容（就是类似html编辑器里面那种单元格自动折行的显示方式）也不行）。

对于中文用户来说，最容易碰到的一个问题是一旦表格中同时有中英文的话，表格会无法对齐，中文比较少的时候 还好，只会有一点点错位，但当中文比较多时，这个表格就乱成一团，没法看了。

(本图非本人制作，摘自: 让中英混杂的orgmode table对齐）

这个问题困扰了很多人，大家也 折腾了各种方法。

首先是有人留意到，其实不仅仅是org-mode里面有问题，emacs本身在中英文混排时一个中文字符就跟两个英文字符 不是同样宽度的，除非有时碰巧了（比如当初我在Ubuntu下用Ubuntu Mono作为emacs默认字体时）。所以最开始我 一直在尝试各种字体，看哪种可以解决这个问题——但一直没有满意的方案，在一个机器上试验出来的结果在另外一 个系统上却不好使。最后发现是搞错了方向。

对于大部分的编辑器而言，我们只能选择一种字体（比如写代码常用的DejaVu Sans Mono, Inconsolata, Consolas），但这个字体中可能仅包含英文字符（或者也包含了其它拉丁字符），但大部分情况下不包含CJK字符， 对这种情况下对CJK字符的显示都是由系统来处理的，编辑器自己一般都不管。

不过Emacs毕竟是神的编辑器啊，它可以做到对不同体系的字符指定具体的字体，所以解决这个问题的办法是: 针 对中英文指定不同大小的字体，英文用小字，中文用大字 （别问我为什么，我是没去仔细研究。下面有一堆链接， 有兴趣的自己去看吧）。

(set-default-font "DejaVu Sans Mono 10")
(set-fontset-font "fontset-default" 'unicode"WenQuanYi Bitmap Song 12") ;;for linux
(set-fontset-font "fontset-default" 'unicode "宋体 12") ;; for windows

在你的环境上，你可能得对针对自己喜欢的编程字体去试验一下，看配哪个字号的中文字体（以及字号大小）可以 解决这个问题（或者可以试试下面的font.pl）。如果你还有日文、韩文什么的，可以详细地针对各种charset设定 字体（而不是像上面笼统地用 'unicode 来制定），详情请参看 折腾Emacs: 中文字体配置 | Emacs中文网。

参考:

• 懒惰的程序员: Big Chinese Small ASCII
• 懒惰的程序员 : 让中英混杂的orgmode table对齐
• 折腾Emacs: 中文字体配置 | Emacs中文网
• http://jff.googlecode.com/svn/trunk/utils/font.pl 这个脚本可以在所安装的字体中查找能对齐的中英文 字体及其字号，不过似乎只能在linux下跑，windows下不知道怎么搞
• Unicode Font Comparison: {Arial Unicode MS, DejaVu Sans, Lucida Sans Unicode}
• Best Unicode Fonts for Programing