Eng | 中文

pinyin-isearch - Emacs package for toneless pinyin search in pinyin and Chinese characters.

Allow to search with pinyin without diacritical marks in pinyin text. With few characters you will find all variants.

Emacs Isearch "submode" that replace isearch-regexp-function to generate regex for search.

For example: to find "Shànghǎi" and "上海" in text you just type: C-s shanghai.

Files

pinyin-isearch.el
 ├─ pinyin-isearch-pinyin.el (→ pinyin-isearch-loaders.el)
 ├─ pinyin-isearch-chars.el (→ pinyin-isearch-loaders.el)
 └─ pinyin-isearch-loaders.el

Demonstation

Featurs

• should not conflict with other isearch modes
• fix isearch jumping without return.
• fallback to search for normal latin text if strict mode is not enabled.

Features of Chinese characters search

• search from the first character entered.
• punctulation Chinese search with ascii charactes: .,[]<>()$-"` and much more.
• accurate dissasemble to all possible variants.

Features of pinyin search

• white spaces are ignored between syllables
• tone or diacritical mark required only in first syllable in text: Zhēn de ma

Installation

from MELPA

1. Add to ~/.emacs

(require 'package)
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
(add-to-list 'package-archives '("melpa-stable" . "https://stable.melpa.org/packages/") t)
(package-initialize)

2. Install via M-x package-install RET cui RET~ or ~M-x package-list-packages

from GitHub or Codeberg

1. git clone https://repo/user/pinyin-isearch

2. Add to ~/.emacs

(add-to-list 'load-path "/path-to/pinyin-isearch/")
(require 'pinyin-isearch)
(pinyin-isearch--load) ;; force loading (optional) before mode

Usage

After C-s/r in isearch mode:

• M-s p to activate pinyin isearch submode.
• M-s h to activate Chinese characters isearch submode.
• M-s s to activate strict Chinese characters isearch submode.
• M-s r to activate standard search.

or with M-x pinyin-isearch-forward/backward

You can set this mode by default per file with:

;-*- mode: pinyin-isearch; -*-

Configuration

M-x customize-group pinyin-isearch

Todo

• Upperacase for pinyin.
• Cangjie search