6b33031dc5
- Rename contrib directory to layers - Add new variable dotspacemacs-distribution - Move spacemacs layer to layers/!distribution - New layer spacemacs-core in layers/!distribution - User can now set dotspacemacs-distribution to spacemacs or spacemacs-core (default spacemacs) spacemacs-core is very lightweight layer sufficient to build upon spacemacs.
89 lines
4.2 KiB
Org Mode
89 lines
4.2 KiB
Org Mode
#+TITLE: Chinese contribution layer for Spacemacs
|
||
[[file:img/China.png]] [[file:img/Chinese.png]]
|
||
|
||
|
||
* Table of Contents :TOC@4:
|
||
- [[#description][Description]]
|
||
- [[#install][Install]]
|
||
- [[#layer][Layer]]
|
||
- [[#configuration][Configuration]]
|
||
- [[#configure-the-default-input-method配置默认中文输入法][Configure the Default Input Method(配置默认中文输入法)]]
|
||
- [[#configure-the-chinese-pyim-input-method配置中文拼音输入法][Configure the =Chinese-pyim= Input Method(配置中文拼音输入法)]]
|
||
- [[#enable-youdao有道-dictionary激活有道字典][Enable YouDao(有道) Dictionary(激活有道字典)]]
|
||
- [[#set-monospaced-font-size设置等宽字体）][Set monospaced font size(设置等宽字体）]]
|
||
- [[#key-bindings][Key Bindings]]
|
||
- [[#youdao-dictionary][Youdao Dictionary]]
|
||
- [[#find-by-pinyin-dired][Find-by-pinyin-dired]]
|
||
|
||
* Description
|
||
This Layer adds Chinese related packages:
|
||
- [[https://github.com/tumashu/chinese-pyim][chinese-pyim]] : The best Chinese Pinyin(拼音) input method.
|
||
- [[https://github.com/andyque/chinese-wbim][chinese-wbim]]: The best Chinese Wubi(五笔) input method.
|
||
- [[https://github.com/xuchunyang/youdao-dictionary.el][youdao-dictionary]]: The Youdao(有道) Dictionary interface for Emacs.
|
||
- [[https://github.com/redguardtoo/find-by-pinyin-dired][find-by-pinyin-dired]]: Find file by first Pinyin characters of Chinese Hanzi.
|
||
- [[https://github.com/cute-jumper/ace-pinyin][ace-pinyin]]: Jump to Chinese character by pinyin with `ace-jump-mode'.
|
||
- [[https://github.com/coldnew/pangu-spacing][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=
|
||
|
||
#+BEGIN_SRC emacs-lisp
|
||
(setq-default dotspacemacs-configuration-layers '(chinese))
|
||
#+END_SRC
|
||
|
||
** 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:
|
||
#+begin_src emacs-lisp
|
||
(setq-default dotspacemacs-configuration-layers '(
|
||
(chinese :variables chinese-default-input-method 'wubi)))
|
||
#+end_src
|
||
|
||
*** 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`.
|
||
|
||
#+BEGIN_SRC emacs-lisp
|
||
(setq-default dotspacemacs-configuration-layers '((chinese :variables
|
||
chinese-enable-youdao-dict t)))
|
||
|
||
#+END_SRC
|
||
|
||
|
||
*** 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/config= function.
|
||
|
||
Example configuration:
|
||
#+BEGIN_SRC emacs-lisp
|
||
;; 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)
|
||
#+END_SRC
|
||
|
||
|
||
* 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=
|
||
|