对 pyim 感兴趣的同学，可以看看本人的 pyim 配置（总是适用于最新版的 pyim）:

(use-package pyim
  :ensure nil
  :config
  ;; 激活 basedict 拼音词库
  (use-package pyim-basedict
    :ensure nil
    :config (pyim-basedict-enable))

  ;; 五笔用户使用 wbdict 词库
  ;; (use-package pyim-wbdict
  ;;   :ensure nil
  ;;   :config (pyim-wbdict-gbk-enable))

  (setq default-input-method "pyim")

  ;; 我使用全拼
  (setq pyim-default-scheme 'quanpin)

  ;; 设置 pyim 探针设置，这是 pyim 高级功能设置，可以实现 *无痛* 中英文切换 :-)
  ;; 我自己使用的中英文动态切换规则是：
  ;; 1. 光标只有在注释里面时，才可以输入中文。
  ;; 2. 光标前是汉字字符时，才能输入中文。
  ;; 3. 使用 M-j 快捷键，强制将光标前的拼音字符串转换为中文。
  (setq-default pyim-english-input-switch-functions
                '(pyim-probe-dynamic-english
                  pyim-probe-isearch-mode
                  pyim-probe-program-mode
                  pyim-probe-org-structure-template))

  (setq-default pyim-punctuation-half-width-functions
                '(pyim-probe-punctuation-line-beginning
                  pyim-probe-punctuation-after-punctuation))

  ;; 开启拼音搜索功能
  (pyim-isearch-mode 1)

  ;; 使用 pupup-el 来绘制选词框
  (setq pyim-page-tooltip 'popup)

  ;; 选词框显示5个候选词
  (setq pyim-page-length 5)

  ;; 让 Emacs 启动时自动加载 pyim 词库
  (add-hook 'emacs-startup-hook
            #'(lambda () (pyim-restart-1 t)))
  :bind
  (("M-j" . pyim-convert-code-at-point) ;与 pyim-probe-dynamic-english 配合
   ("C-;" . pyim-delete-word-from-personal-buffer)))

pyim 当前的默认的拼音词库是 pyim-basedict, 这个词库的词条量 8 万左右，是一个非常小的拼音词库，词条的来源有两个：

1. libpinyin 项目的内置词库
2. pyim 用户贡献的个人词库

如果 pyim-basedict 不能满足需求，用户可以使用其他方式为 pyim 添加拼音词库，具体方式请参考 1.10.6 小结。

(setq default-input-method "pyim")
(global-set-key (kbd "C-\\") 'toggle-input-method)

pyim 支持双拼输入模式，用户可以通过变量 `pyim-default-scheme' 来设定：

(setq pyim-default-scheme 'pyim-shuangpin)

注意：

1. pyim 支持微软双拼（microsoft-shuangpin）和小鹤双拼（xiaohe-shuangpin）。
2. 用户可以使用变量 `pyim-schemes' 添加自定义双拼方案。
3. 用户可能需要重新设置 `pyim-translate-trigger-char'。

pyim 支持五笔输入模式，用户可以通过变量 `pyim-default-scheme' 来设定：

(setq pyim-default-scheme 'wubi)

在使用五笔输入法之前，请用 pyim-dicts-manager 添加一个五笔词库，词库的格式类似：

# ;;; -*- coding: utf-8-unix -*-
.aaaa 工
.aad 式
.aadk 匿
.aadn 慝 葚
.aadw 萁
.aafd 甙
.aaff 苷
.aaht 芽
.aak 戒

最简单的方式是从 melpa 中安装 pyim-wbdict 包，然后根据它的 README 来配置。

pyim 支持仓颉输入法，用户可以通过变量 `pyim-default-scheme' 来设定：

(setq pyim-default-scheme 'cangjie)

在使用仓颉输入法之前，请用 pyim-dicts-manager 添加一个仓颉词库，词库的格式类似：

# ;;; -*- coding: utf-8-unix -*-
@a 日
@a 曰
@aa 昌
@aa 昍
@aaa 晶
@aaa 晿
@aaah 曑

如果用户使用仓颉第五代，最简单的方式是从 melpa 中安装 pyim-cangjie5dict 包，然后根据它的 README 来配置。 pyim 支持其它版本的仓颉，但需要用户自己创建词库文件。

用户可以使用命令：`pyim-search-word-code' 来查询当前选择词条的仓颉编码

用户可以通过下面的设置让 pyim 在光标处显示一个选词框：

1. 使用 popup 包来绘制选词框 （emacs overlay 机制）

   (setq pyim-page-tooltip 'popup)
   

2. 使用 pos-tip 包来绘制选词框（emacs tooltip 机制）

   (setq pyim-page-tooltip 'pos-tip)
   

注：Linux 平台下，emacs 可以使用 GTK 来绘制选词框：

(setq pyim-page-tooltip 'pos-tip)
(setq x-gtk-use-system-tooltips t)

GTK 选词框的字体设置可以参考：GTK resources 。

pyim 的 tooltip 选词框默认使用双行显示的样式，在一些特殊的情况下（比如：popup 显示的菜单错位），用户可以使用单行显示 的样式：

(setq pyim-page-style 'one-line)

注：用户可以添加函数 pyim-page-style-STYLENAME-style 来定义自己的选词框格式。

可以通过设置 `pyim-fuzzy-pinyin-alist' 变量来自定义模糊音。

1. 第一种方法：使用命令 `pyim-punctuation-toggle'，全局切换。这个命令主要用来设置变量： `pyim-punctuation-translate-p', 用户也可以手动设置这个变量， 比如：

   (setq pyim-punctuation-translate-p '(yes no auto))   ;使用全角标点。
   (setq pyim-punctuation-translate-p '(no yes auto))   ;使用半角标点。
   (setq pyim-punctuation-translate-p '(auto yes no))   ;中文使用全角标点，英文使用半角标点。
   

2. 第二种方法：使用命令 `pyim-punctuation-translate-at-point' 只切换光标处标点的样式。
3. 第三种方法：设置变量 `pyim-translate-trigger-char' ，输入变量设定的字符会切换光标处标点的样式。

1. `pyim-create-Ncchar-word-at-point 这是一组命令，从光标前提取N个汉字字符组成字符串，并将其加入个人词库。
2. `pyim-translate-trigger-char' 以默认设置为例：在“我爱吃红烧肉”后输入“5v” 可以将“爱吃红烧肉”这个词条保存到用户个人词库。
3. `pyim-create-word-from-selection', 选择一个词条，运行这个命令后，就可以将这个词条添加到个人词库。
4. `pyim-delete-word' 从个人词库中删除当前高亮选择的词条。

1. 根据环境自动切换到英文输入模式，使用 pyim-english-input-switch-functions 配置。
2. 根据环境自动切换到半角标点输入模式，使用 pyim-punctuation-half-width-functions 配置。

注意：上述两个功能使用不同的变量设置，千万不要搞错。

使用命令：pyim-dcache-export-personal-dcache

(setq debug-on-error t)

可以通过设置 `pyim-tooltip-width-adjustment' 变量来手动校正。

1. 选词框内容显示不全：增大变量值
2. 选词框弹出位置不合理：减小变量值

pyim 的文档隐藏在 comment 中，如果用户喜欢阅读 html 格式的文档，可以查看在线文档；

http://tumashu.github.io/pyim/

(global-set-key (kbd "M-i") 'pyim-convert-code-at-point)

pyim 默认没有携带任何拼音词库，用户可以使用下面几种方式，获取质量较好的拼音词库：

这里假设有两个词库文件：

1. /path/to/pyim-dict1.pyim
2. /path/to/pyim-dict2.pyim

在~/.emacs文件中添加如下一行配置。

(setq pyim-dicts
      '((:name "dict1" :file "/path/to/pyim-dict1.pyim")
        (:name "dict2" :file "/path/to/pyim-dict2.pyim")))

注意事项:

1. 只有 :file 是必须设置的。
2. 必须使用词库文件的绝对路径。
3. 词库文件的编码必须为 utf-8-unix，否则会出现乱码。

(add-hook 'emacs-startup-hook
          #'(lambda () (pyim-restart-1 t)))

下面两个函数可以将中文字符串转换的拼音字符串或者列表，用于 emacs-lisp 编程。

1. `pyim-hanzi2pinyin' （考虑多音字）
2. `pyim-hanzi2pinyin-simple' （不考虑多音字）

pyim 包含了一个简单的分词函数：`pyim-cstring-split-to-list', 可以将一个中文字符串分成一个词条列表，比如：

                  (("天安" 5 7)
我爱北京天安门 ->  ("天安门" 5 8)
                   ("北京" 3 5)
                   ("我爱" 1 3))

其中，每一个词条列表中包含三个元素，第一个元素为词条本身，第二个元素为词条相对于字符串的起始位置，第三个元素为词条结束位置。

另一个分词函数是 `pyim-cstring-split-to-string', 这个函数将生成一个新的字符串，在这个字符串中，词语之间用空格或者用户自定义的分隔符隔开。

注意，上述两个分词函数使用暴力匹配模式来分词，所以，不能检测出 pyim 词库中不存在的中文词条。

pyim 包含了一个简单的命令：`pyim-cwords-at-point', 这个命令可以得到光标处的英文或者中文词条的 *列表*，这个命令依赖分词函数： `pyim-cstring-split-to-list'。

中文词语没有强制用空格分词，所以 Emacs 内置的命令 `forward-word' 和 `backward-word' 在中文环境不能按用户预期的样子执行，而是 forward/backward “句子” ，pyim 自带的两个命令可以在中文环境下正常工作：

1. `pyim-forward-word
2. `pyim-backward-word

用户只需将其绑定到快捷键上就可以了，比如：

(global-set-key (kbd "M-f") 'pyim-forward-word)
(global-set-key (kbd "M-b") 'pyim-backward-word)

pyim 安装后，可以通过下面的设置开启拼音搜索功能：

(pyim-isearch-mode 1)

注意：这个功能有一些限制，搜索字符串中只能出现 “a-z” 和 “’”，如果有其他字符（比如 regexp 操作符），则自动关闭拼音搜索功能。

开启这个功能后，一些 isearch 扩展有可能失效，如果遇到这种问题，只能禁用这个 Minor-mode，然后联系 pyim 的维护者，看有没有法子实现兼容。

用户激活这个 mode 后，可以使用下面的方式强制关闭 isearch 搜索框中文输入（即使在 pyim 激活的时候）。

(setq-default pyim-english-input-switch-functions
              '(pyim-probe-isearch-mode))