(翻译)Emacs Hooks

Table of Contents

• 1. 51.2.2 Hooks

51.2.2 Hooks

Hooks（钩子或挂钩，为了保持文章的纯正性，这种专有名词不做翻译，后续以hooks为主），是定制化Emacs非常重要的一种机制。
一个Hook就是一个Lisp变量，其中包含了一系列在某个特定场景下调用的函数，列表中每个函数叫做hook function。比如kill-emacs-hook
会在Emacs推出前运行。

大部分hook都是Normal HOOK，这意味着每当EMACS运行这个Hook,Hook里面的函数会不带参数依次运行。我们努力维持使大多数HOOK都是normal
hook,以便在使用时保持统一的格式。每一个以‘-hook’结尾的Elisp变量都是normal hook.

少部分hooks是abnormal hooks,他们的名字以‘-functions’结尾，使这些hooks成为abnormal hooks的是其中包含的函数的调用方式。
他们或许需要参数或者他们的返回值会被使用。例如，find-file-not-found-functions 就是一个abnoral hooks,因为只要其中一个函数返回
non-nil,剩余的函数就不会继续被调用了。每一个abnormal hook 变量的文档揭示了其中每个函数的用法。

你可以像设置其他lisp 变量一样使用setq来设置hook变量，但推荐的方式是使用add-hook函数来增加函数到hook里，如下例所示。

大部分Major mode,会在initialization的最后一步调用一个或多个mode hooks，mode hooks是一种便捷的方式去定制每一个modes的行为，
mode hooks都是normal的，例如，这里这里设置一个hook在text mode及其他基于text mode 的模式里开始自动填充模式(minor mode).

      （add-hook 'text-mode-hook 'auto-fill-mode）

这是通过调用auto-fill-mode函数并且不加参数，来开启minor mode
接下来，如果你不想在Latex mode中开启auto-fill-mode（Latex mode是基于text mode的），你可以如下设置。

(add-hook 'latex-mode-hook (lambda () (auto-fill-mode -1)))

这里我们使用了特殊宏lambda构造了一个anonymous函数，调用auto-fill-mode ，并赋予参数-1，关闭minor-mode,因为LaTex会在text-mode-hook后
运行latex-mode-hook.

这里给出一个更加复杂的例子，如何使用一个hook去定制C代码的缩进

(setq my-c-style
  '((c-comment-only-line-offset . 4)
  (c-cleanup-list . (scope-operator
                   empty-defun-braces
                   defun-close-semi))))

(add-hook 'c-mode-common-hook
   (lambda () (c-add-style "my-style" my-c-style t)))

Major mode hooks（主模式hooks）也会在其他继承于该主模式的其他主模式生效，比如HTML模式继承于text mode，当HTML mode开启的时候，
会先运行text-mode-hook,再运行html-mode-hook,这是一种通过一个hook影响多个相关模式的方式。特别的是，如果你想通过一个hook影响所有
编程语言模式(programing language mode),将函数加入到prog-mode-hook;

在设计hook的时候最好让其中的函数执行顺序不影响结果，任何依赖于函数执行顺序都可能带来麻烦。但函数执行顺序是可预测的，他们会以在hook
中呈现的顺序来执行。

你可以使用remove-hook来清除函数，也可以使用 setq hook-variable nil来清除整个hook

如果hook变量是一个buffer-local,那么buffer-local变量会被使用而不是全局变量，如果buffer-local变量包含元素t，那么全局hook
也会运行。