118 lines
4 KiB
Org Mode
118 lines
4 KiB
Org Mode
#+TITLE: Japanese layer
|
||
|
||
#+TAGS: i18n|layer
|
||
|
||
[[file:img/Japanese.png]]
|
||
|
||
* Table of Contents :TOC_5_gh:noexport:
|
||
- [[#description][Description]]
|
||
- [[#features][Features:]]
|
||
- [[#install][Install]]
|
||
- [[#layer][Layer]]
|
||
- [[#configuration][Configuration]]
|
||
- [[#evil-tutor-ja][evil-tutor-ja]]
|
||
- [[#migemo][migemo]]
|
||
- [[#helm-with-migemo][helm-with-migemo]]
|
||
- [[#avy-migemo][avy-migemo]]
|
||
- [[#ddskk][ddskk]]
|
||
- [[#pangu-spacing][pangu-spacing]]
|
||
- [[#key-bindings][Key bindings]]
|
||
|
||
* Description
|
||
This Layer adds Japanese related packages.
|
||
|
||
** Features:
|
||
- [[https://github.com/kenjimyzk/evil-tutor-ja][evil-tutor-ja]]: Japanese Vimtutor adapted to Emacs+Evil and wrapped in a major mode
|
||
- [[https://github.com/emacs-jp/migemo][migemo]]: Japanese incremental search through dynamic pattern expansion
|
||
- [[https://github.com/emacs-helm/helm/wiki/Migemo][helm-migemo-mode]]: helm with migemo
|
||
- [[https://github.com/momomo5717/avy-migemo/blob/master/README.jp.org][avy-migemo]]: avy with migemo
|
||
- [[https://github.com/hsaito/ddskk][ddskk]]: Simple Kana to Kanji conversion program (SKK)
|
||
- [[https://github.com/emacs-jp/japanese-holidays][japanese-holidays]]: calendar functions for the Japanese calendar
|
||
- [[https://github.com/coldnew/pangu-spacing][pangu-spacing]]: emacs minor-mode to add space between Japanese and English
|
||
characters.
|
||
- Join consecutive Japanese lines into a single long line without unwanted space
|
||
when exporting org-mode to html.
|
||
|
||
* Install
|
||
** Layer
|
||
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
|
||
add =japanese= to the existing =dotspacemacs-configuration-layers= list in this
|
||
file.
|
||
|
||
** Configuration
|
||
For a basic configuration, add this to your =~/.spacemacs= inside ~dotspacemacs/user-config~:
|
||
|
||
*** evil-tutor-ja
|
||
By default, the variable ~evil-tutor-working-ja-directory~ is assigned =~/.emacs.d/.tutor-ja=.
|
||
|
||
*** migemo
|
||
By default, the variable ~migemo-dictionary~ is assigned
|
||
~/usr/local/share/migemo/utf-8/migemo-dict~ in MacOS, or ~/usr/local/cmigemo/utf-8/migemo-dict~ in linux.
|
||
If you want it to be another directory, you must re-set the variable.
|
||
For example, if you install [[https://www.kaoriya.net/software/cmigemo/][C/Migemo for Windows 64bit]] in the directory ~c:\app\cmigemo-default-win64~, you should add:
|
||
|
||
#+BEGIN_SRC emacs-lisp
|
||
(with-eval-after-load "migemo"
|
||
(setq migemo-dictionary "c:/app/cmigemo-default-win64/dict/utf-8/migemo-dict"))
|
||
#+END_SRC
|
||
|
||
inside ~dotspacemacs/user-config~, or
|
||
|
||
#+begin_src emacs-lisp
|
||
(japanese :variables
|
||
migemo-dictionary "c:/app/cmigemo-default-win64/dict/utf-8/migemo-dict")
|
||
#+end_src
|
||
|
||
inside ~dotspacemacs-configuration-layers~.
|
||
|
||
*** helm-with-migemo
|
||
If you want to use helm with migemo, you should add:
|
||
|
||
#+BEGIN_SRC emacs-lisp
|
||
(with-eval-after-load "migemo"
|
||
(helm-migemo-mode 1))
|
||
#+END_SRC
|
||
|
||
inside ~dotspacemacs/user-config~, or
|
||
|
||
#+begin_src emacs-lisp
|
||
(japanese :variables
|
||
helm-migemo-mode 1)
|
||
#+end_src
|
||
|
||
inside ~dotspacemacs-configuration-layers~. Note that you may find in a package called
|
||
~helm-migemo.el~ in MELPA. However, this package is deprecated and not supported
|
||
by helm.
|
||
|
||
*** avy-migemo
|
||
Note that ~avy-migemo~ in MELPA does not work
|
||
currently, so you had better use a [[https://github.com/tam17aki/avy-migemo][forked version]] alternatively.
|
||
|
||
By default, you can use ~avy-migemo~ for ~helm-mode~. For ~ivy-mode~, you should add:
|
||
|
||
#+BEGIN_SRC emacs-lisp
|
||
(with-eval-after-load "migemo"
|
||
(require 'avy-migemo-e.g.ivy)
|
||
(require 'avy-migemo-e.g.swiper)
|
||
(require 'avy-migemo-e.g.counsel))
|
||
#+END_SRC
|
||
|
||
inside ~dotspacemacs/user-config~.
|
||
|
||
*** ddskk
|
||
You can write a configuration file ~~/.skk~. For detailed configuration, see
|
||
some [[https://skk-dev.github.io/ddskk/skk.html][documents]].
|
||
|
||
*** pangu-spacing
|
||
By default, ~pangu-spacing-mode~ is applied to ~text-mode~. If you prefer the
|
||
mode globally, add:
|
||
|
||
#+BEGIN_SRC emacs-lisp
|
||
(global-pangu-spacing-mode 1)
|
||
#+END_SRC
|
||
|
||
inside ~dotspacemacs/user-config~.
|
||
|
||
* Key bindings
|
||
By default, ~C-x j~ toggles ~skk-mode~.
|