Homepage: https://github.com/google/mozc
Updated:
Minor mode to input Japanese with Mozc
mozc-mode is a minor mode to input Japanese text using Mozc server. mozc-mode directly communicates with Mozc server and you can use all features of Mozc, such as suggestion and prediction as well as regular conversion. Supported Emacs version and environment: mozc-mode supports Emacs version 22.1 and later. How to set up mozc-mode: 1. Environment settings You need to install a helper program called 'mozc_emacs_helper'. You may need to set PATH environment variable to the program, or set `mozc-helper-program-name' to the path to the program. You need to install this mozc.el as well. Most of Unix-like distributions install the helper program to /usr/bin/mozc_emacs_helper and mozc.el to an appropriate site-lisp directory (/usr/share/emacs/site-lisp/emacs-mozc for example) by default, and you may have nothing to do on your side. 2. Settings in your init file mozc-mode supports LEIM (Library of Emacs Input Method) and you only need the following settings in your init file (~/.emacs.d/init.el or ~/.emacs). (require 'mozc) ; or (load-file "/path/to/mozc.el") (setq default-input-method "japanese-mozc") Having the above settings, just type \C-\\ which is bound to `toggle-input-method' by default. Note for advanced users: mozc-mode is provided as a minor-mode and it's able to work without LEIM. You can directly enable mozc-mode by running `mozc-mode' command. 3. Customization 3.1. Server-side customization By the design policy, Mozc maintains most of user settings on the server side. Clients, including mozc.el, of Mozc do not have many user settings on their side. You can change a variety of user settings through a GUI command line tool 'mozc_tool' which must be shipped with the mozc server. The command line tool may be installed to /usr/lib/mozc or /usr/lib directory. You need a command line option '--mode=config_dialog' as the following. $ /usr/lib/mozc/mozc_tool --mode=config_dialog Then, it shows a GUI dialog to edit your user settings. Note these settings are effective for all the clients of Mozc, not limited to mozc.el. 3.2. Client-side customization. Only the customizable item on mozc.el side is the key map for kana input. When you've chosen kana input rather than roman input, a kana key map is effective, and you can customize it. There are two built-in kana key maps, one for 106 JP keyboards and one for 101 US keyboards. You can choose one of them by setting `mozc-keymap-kana' variable. ;; for 106 JP keyboards (setq mozc-keymap-kana mozc-keymap-kana-106jp) ;; for 101 US keyboards (setq mozc-keymap-kana mozc-keymap-kana-101us) For advanced users, there are APIs for more detailed customization or even creating your own key map. See `mozc-keymap-get-entry', `mozc-keymap-put-entry', `mozc-keymap-remove-entry', and `mozc-keymap-make-keymap' and `mozc-keymap-make-keymap-from-flat-list'.