Skip to content
convert between simplified and traditional chinese
Emacs Lisp
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
chinese-conv.el

README.md

chinese-conv

A front end in emacs to convert between simplified and traditional Chinese with opencc or cconv.

Author: Cong Gu

Install

Prerequisite

Have either opencc or cconv installed in your system.

Use MELPA

M-x package-install RET chinese-conv RET

Put the following into init file (e.g. ~/.emacs)

(require 'chinese-conv)

Manual

Put chinese-conv.el into desired location (e.g. ~/.emacs/site-lisp/) and put the following into init file (e.g. ~/.emacs)

(add-to-list 'load-path "~/.emacs.d/site-lisp")
(require 'chinese-conv)

Configuration

Chinese-conv comes with support for opencc and cconv as backends.

Use opencc as backend (Default)

To change opencc program path, set chinese-conv-opencc-program (default: "opencc"),

(setq chinese-conv-opencc-program "/PATH/TO/BIN/opencc")

To change opencc data directory, set chinese-conv-opencc-data (default: "/usr/share/opencc/"),

(setq chinese-conv-opencc-data "/PATH/TO/DATA/")

Use cconv as backend

Set the backend to cconv,

(setq chinese-conv-backend "cconv")

To change cconv program path, set chinese-conv-cconv-program (default: "cconv"),

(setq chinese-conv-cconv-program "/PATH/TO/BIN/cconv")

Usage

Interactive query

Example:

M-x chinese-conv RET 后天 RET traditional RET

后天 is the string to convert. The interactive command will guess it from marked region or current word.

traditional is the conversion type. It is read with completion among all the available types. Hit TAB for a complete list of available types.

The result will be displayed in minibuffer.

Interactive replace

Example: Mark the region to be converted in the buffer, then

M-x chinese-conv-replace RET traditional RET

The marked region will be converted to traditional characters.

Non-interactive API

(chinese-conv "后天" "traditional")
=> "後天"

Backend can be explicitly specified,

(chinese-conv "后天" "traditional" "opencc")
=> "後天"
You can’t perform that action at this time.