添加“切到 evil-normal-state 时首项自动上屏”的可选功能 (#213)

* 添加“切到 evil-normal-state 时首项自动上屏”的可选功能；
优化 rime-commit1 相关函数的可读性；
同步修改 README 并稍作完善。

* 对过时函数名新增提示，以便平稳过渡。

* 对 README.org 和 INSTALLATION.org 进行大量结构优化（内容不变）

* Sync README.org and INSTALLATION.org with the _EN ones.

* sync README_EN.org to README.org.

* Nearly full sync between CN and EN docs, but leave some translation
undone.
Tagged "TTBD" the parts to be translated in README_EN.org.

* Minor fixes on html and indent.

* translation, minor sync between CN and EN.

* Translation. Minor fixes.

* Translation. Most TTBDs are done.

* Translation on the last TTBD, partly.

* Translation all done.

* Fix typo of "schema"

* minor fix.

* message minor fix.

* Minor typo fix.

* Minor fix about data dir part in README.

* 将commit1与evil、toggle-input-method等解耦；新增全局commit1选项；同步更新中英文的README。

* Fix coding error.

* Alter the position of defun of rime-commit1.

Author: ATNewHope

INSTALLATION.org

@@ -1,10 +1,32 @@
-#+title: Emacs Rime 安装与使用方法
+#+title: Emacs Rime 基本安装与使用方法
 
 ** 依赖
-
    - Emacs 26.1+ ，且需启用动态支持模块。
-
    - emacs-rime 会自动构建所需的动态模块，这需要 ~make~ 和 ~gcc~ 可用。
+*** 如何获得支持动态模块的 Emacs ？
+#+html: <details>
+#+html: <summary>切换折叠</summary>
+**** Linux
+Linux 各主要发行版自带 emacs 默认已启用动态模块支持。
+
+**** MacOS
+***** emacs-plus 默认启用 ~--with-modules~ 选项，使用 homebrew 安装命令如下：
+#+BEGIN_SRC shell
+brew tap d12frosted/emacs-plus
+brew install emacs-plus
+#+END_SRC
+
+***** emacs-mac 安装时需要启用 ~--with-modules~ 选项，使用 homebrew 安装命令如下 :
+#+BEGIN_SRC shell
+brew tap railwaycat/emacsmacport
+brew install emacs-mac --with-modules
+#+END_SRC
+
+**** 手工编译
+
+使用 ~--with-modules~ 选项.
+
+#+html: </details>
 
 ** 安装 librime
 
@@ -86,6 +108,28 @@
 
     在 mingw64 环境中启动 emacs 来获取正确的 =SHELL= 环境变量，用来在 Emacs 内构建 librime-emacs 以及  =MSYSTEM_PREFIX= 环境变量来设置 ~rime-share-data-dir~ 变量。
 
+*** 编译时无法找到 rime_api.h ？
+#+html: <details>
+#+html: <summary>切换折叠</summary>
+必须设置 ~rime-librime-root~ 参照安装方法中的说明。
+
+#+html: </details>
+*** 编译时无法找到 emacs-module.h ？
+#+html: <details>
+#+html: <summary>切换折叠</summary>
+
+如果自己编译 Emacs 且没有安装到标准目录（/usr/, /usr/local/），
+*必须* 指定 ~rime-emacs-module-header-root~ 。
+
+在 ~:custom~ 中加入如下内容.
+
+(假设将 Emacs 安装到了 ~/emacs)
+
+#+BEGIN_SRC emacs-lisp
+(rime-emacs-module-header-root "~/emacs/include")
+#+END_SRC
+
+#+html: </details>
 ** 最小配置
 
    Emacs Rime 已发布到 Melpa 。
@@ -96,40 +140,43 @@
        (default-input-method "rime"))
    #+end_src
 
-   #+html: <details>
-   #+html: <summary>使用 Straight</summary>
-   #+BEGIN_SRC emacs-lisp
-     (use-package rime
-       :straight (rime :type git
-                       :host github
-                       :repo "DogLooksGood/emacs-rime"
-                       :files ("*.el" "Makefile" "lib.c"))
-       :custom
-       (default-input-method "rime"))
-   #+END_SRC
-   #+html: </details>
-
-   #+html: <details>
-   #+html: <summary>使用 Quelpa</summary>
-   #+BEGIN_SRC emacs-lisp
-     (use-package rime
-       :quelpa (rime :fetcher github
-                     :repo "DogLooksGood/emacs-rime"
-                     :files ("*.el" "Makefile" "lib.c"))
-       :custom
-       (default-input-method "rime"))
-   #+END_SRC
-   #+html: </details>
-
-   *NOTE* 如果你在 MacOS 上或是选择自己编译 librime （没有放在系统路径中）， *必须* 指定 ~rime-librime-root~ 。
-
-   在 ~:custom~ 中加入如下内容.
-
-   (假设将 librime 解压到了 ~/.emacs.d/librime)
-
-   #+BEGIN_SRC emacs-lisp
-     (rime-librime-root "~/.emacs.d/librime/dist")
-   #+END_SRC
+*** 使用 Straight
+#+html: <details>
+#+html: <summary>切换折叠</summary>
+#+BEGIN_SRC emacs-lisp
+  (use-package rime
+    :straight (rime :type git
+                    :host github
+                    :repo "DogLooksGood/emacs-rime"
+                    :files ("*.el" "Makefile" "lib.c"))
+    :custom
+    (default-input-method "rime"))
+#+END_SRC
+#+html: </details>
+
+*** 使用 Quelpa
+#+html: <details>
+#+html: <summary>切换折叠</summary>
+#+BEGIN_SRC emacs-lisp
+  (use-package rime
+    :quelpa (rime :fetcher github
+                  :repo "DogLooksGood/emacs-rime"
+                  :files ("*.el" "Makefile" "lib.c"))
+    :custom
+    (default-input-method "rime"))
+#+END_SRC
+#+html: </details>
+
+*** 注意（MacOS）
+*NOTE* 如果你在 MacOS 上或是选择自己编译 librime （没有放在系统路径中）， *必须* 指定 ~rime-librime-root~ 。
+
+在 ~:custom~ 中加入如下内容.
+
+(假设将 librime 解压到了 ~/.emacs.d/librime)
+
+#+BEGIN_SRC emacs-lisp
+  (rime-librime-root "~/.emacs.d/librime/dist")
+#+END_SRC
 
 ** 激活 Rime 输入法
 

INSTALLATION_EN.org

@@ -5,6 +5,31 @@
    Emacs 26.1+ with dynamic modules support, ~gcc~ and ~make~.
 
    emacs-rime will build dynamic module automatically.
+*** How to get Emacs with dynamic module support?
+
+- **Linux**
+
+Emacs included in major linux distributions has dynamic module support enabled by default.
+
+- **MacOS**
+
+~emacs-plus~ enables dynamic modules support by default. homebrew installation:
+#+BEGIN_SRC shell
+brew tap d12frosted/emacs-plus
+brew install emacs-plus
+#+END_SRC
+
+When installing ~emacs-mac~, you need to add ~--with-modules~ option. homebrew installation:
+#+BEGIN_SRC shell
+brew tap railwaycat/emacsmacport
+brew install emacs-mac --with-modules
+#+END_SRC
+
+- **Compile Emacs 26 manually**
+
+Use ~--with-modules~ option.
+
+
 
 ** Install librime
 
@@ -86,49 +111,65 @@
 
      Start emacs from mingw64's environment to get the correct =SHELL= environment variable for building librime-emacs inside Emacs and =MSYSTEM_PREFIX= for specifying the ~rime-share-data-dir~ variable.
 
+*** Can't find rime_api.h when compile?
+
+You *MUST* specify ~rime-librime-root~ in this case.
+
+Check Installation for how to set.
+
+*** Can't find emacs-module.h when compile?
+
+If you build Emacs by yourself and does not install to standard location,
+you *MUST* specify ~rime-emacs-module-header-root~.
+
+Put following in the ~:custom~ section.
+
+(Assuming you install Emacs to ~/emacs)
+
+#+BEGIN_SRC emacs-lisp
+(rime-emacs-module-header-root "~/emacs/include")
+#+END_SRC
+
 ** Minimal configuration
 
-   #+BEGIN_SRC emacs-lisp
+#+BEGIN_SRC emacs-lisp
+(use-package rime
+  :custom
+  (default-input-method "rime"))
+#+END_SRC
+
+*** Use Straight
+#+BEGIN_SRC emacs-lisp
   (use-package rime
+    :straight (rime :type git
+                    :host github
+                    :repo "DogLooksGood/emacs-rime"
+                    :files ("*.el" "Makefile" "lib.c"))
     :custom
     (default-input-method "rime"))
-   #+END_SRC
-
-   #+html: <details>
-   #+html: <summary>Use Straight</summary>
-   #+BEGIN_SRC emacs-lisp
-     (use-package rime
-       :straight (rime :type git
-                       :host github
-                       :repo "DogLooksGood/emacs-rime"
-                       :files ("*.el" "Makefile" "lib.c"))
-       :custom
-       (default-input-method "rime"))
-   #+END_SRC
-   #+html: </details>
-
-   #+html: <details>
-   #+html: <summary>Use Quelpa</summary>
-   #+BEGIN_SRC emacs-lisp
-     (use-package rime
-       :quelpa (rime :fetcher github
-                     :repo "DogLooksGood/emacs-rime"
-                     :files ("*.el" "Makefile" "lib.c"))
-       :custom
-       (default-input-method "rime"))
-   #+END_SRC
-   #+html: </details>
-
-   *NOTE*: If you are on MacOS or don't have librime in standard path,
-   you *MUST* specify ~rime-librime-root~.
-
-   Put following in the ~:custom~ section.
-
-   (Assuming you unzip librime to ~/.emacs.d/librime)
-
-   #+BEGIN_SRC emacs-lisp
-     (rime-librime-root "~/.emacs.d/librime/dist")
-   #+END_SRC
+#+END_SRC
+
+*** Use Quelpa
+#+BEGIN_SRC emacs-lisp
+  (use-package rime
+    :quelpa (rime :fetcher github
+                  :repo "DogLooksGood/emacs-rime"
+                  :files ("*.el" "Makefile" "lib.c"))
+    :custom
+    (default-input-method "rime"))
+#+END_SRC
+
+*** NOTICE (MacOS)
+If you are on MacOS or don't have librime in standard path,
+you *MUST* specify ~rime-librime-root~.
+
+Put following in the ~:custom~ section.
+
+(Assuming you unzip librime to ~/.emacs.d/librime)
+
+#+BEGIN_SRC emacs-lisp
+  (rime-librime-root "~/.emacs.d/librime/dist")
+#+END_SRC
 
 ** Activate input method