This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/chinese/README.org
Eivind Fonn c893383fe4 Fix some documentation bugs
- CSS links
- GIFS in published version
- Unify layer doc titles
- Change emoji layer emojis to an image
2015-12-03 23:50:29 -05:00

4.7 KiB
Raw Blame History

Chinese layer

/TakeV/spacemacs/media/commit/9eb8f86b9a7ff0bf299e81ebd3da352852f45685/layers/chinese/img/China.png /TakeV/spacemacs/media/commit/9eb8f86b9a7ff0bf299e81ebd3da352852f45685/layers/chinese/img/Chinese.png

Description

This Layer adds Chinese related packages:

  • chinese-pyim : The best Chinese Pinyin(拼音) input method.
  • chinese-wbim: The best Chinese Wubi(五笔) input method.
  • youdao-dictionary: The Youdao(有道) Dictionary interface for Emacs.
  • find-by-pinyin-dired: Find file by first Pinyin characters of Chinese Hanzi.
  • ace-pinyin: Jump to Chinese character by pinyin with `ace-jump-mode'.
  • coldnew/pangu-spacing : emacs minor-mode to add space between Chinese and English characters.
  • Join consecutive Chinese lines into a single long line without unwanted space when exporting org-mode to html.

Install

Layer

To use this contribution add it to your ~/.spacemacs

  (setq-default dotspacemacs-configuration-layers '(chinese))

Configuration

Configure the Default Input Method(配置默认中文输入法)

The default Chinese input method is Chinese-pyim, if you are a Wubi(五笔) user, you could set the variable chinese-default-input-method to wubi:

  (setq-default dotspacemacs-configuration-layers '(
    (chinese :variables chinese-default-input-method 'wubi)))

Configure the Chinese-pyim Input Method(配置中文拼音输入法)

When the first time you use Chinese-pyim, you should install the lexicon(词库) file. You could call pyim-dicts-manager to open up the settings buffer and press i e to install the default lexicon. The lexicon is about 20M, so you should be patient when downloading starts. After the lexicon file is downloaded, just press s to save and R to restart configuration.

Enable YouDao(有道) Dictionary(激活有道字典)

The YouDao Dictionary is disabled by default, if you want enable it. You should set chinese-enable-youdao-dict to t.

  (setq-default dotspacemacs-configuration-layers '((chinese :variables
                                                             chinese-enable-youdao-dict t)))

Set monospaced font size(设置等宽字体)

If you are mixing Chinese words with English words, the text is not perfectly aligned in org table. That's because normally the Chinese font size is not equal to the English font size. You could call spacemacs//set-monospaced-font with your own Chinese font name in dotspacemacs/user-config function.

Example configuration:

;; Note: The Hiragino Sans GB is bundled with MacOS X. 
;; If you are not using MacOS X, you should change it to another Chinese font name.
(spacemacs//set-monospaced-font   "Source Code Pro" "Hiragino Sans GB" 14 16)

Enable/Disable ace-pinyin in avy-goto-char

You can use avy-goto-char with pinyin supported by default, if you want to disable it.You can set chinese-enable-avy-pinyin to nil.

  (setq-default dotspacemacs-configuration-layers '((chinese :variables
                                                             chinese-enable-avy-pinyin nil)))

Key Bindings

Currently, there are no built-in key bindings for this layer. You could define your own preference.

Here are a few suggested key bindings (remember that SPC o is reserved for personal usage, spacemacs won´t put any binding under this prefix):

Youdao Dictionary

Bind SPC o y to youdao-dictionary-search-at-point+.

Find-by-pinyin-dired

Bind SPC o d to find-by-pinyin-dired