Homepage: https://github.com/cute-jumper/pinyinlib.el
Author: Junpeng Qiu
Updated:
Convert first letter of Pinyin to Simplified/Traditional Chinese characters
______________
PINYINLIB.EL
Junpeng Qiu
______________
Table of Contents
_________________
1 Functions
.. 1.1 `pinyinlib-build-regexp-char'
.. 1.2 `pinyinlib-build-regexp-string'
2 Packages that Use This Library
3 Acknowledgment
4 Contribute
[[file:https://melpa.org/packages/pinyinlib-badge.svg]]
[[file:https://stable.melpa.org/packages/pinyinlib-badge.svg]]
Library for converting first letter of Pinyin to Simplified/Traditional
Chinese characters.
[[file:https://melpa.org/packages/pinyinlib-badge.svg]]
https://melpa.org/#/pinyinlib
[[file:https://stable.melpa.org/packages/pinyinlib-badge.svg]]
https://stable.melpa.org/#/pinyinlib
1 Functions
===========
1.1 `pinyinlib-build-regexp-char'
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
`pinyinlib-build-regexp-char' converts a letter to a regular
expression containing all the Chinese characters whose pinyins start
with the letter. It accepts five parameters:
,----
| char &optional no-punc-p tranditional-p only-chinese-p mixed-p
`----
The first parameter `char' is the letter to be converted. The latter
four parameters are optional.
- If `no-punc-p' is `t': it will not convert English punctuations to
Chinese punctuations.
- If `traditional-p' is `t': traditional Chinese characters are used
instead of simplified Chinese characters.
- If `only-chinese-p' is `t': the resulting regular expression doesn't
contain the English letter `char'.
- If `mixed-p' is `t': the resulting regular expression will mix
traditional and simplified Chinese characters. This parameter will take
precedence over `traditional-p'.
When converting English punctuactions to Chinese/English punctuations,
it uses the following table:
English Punctuation Chinese & English Punctuations
-----------------------------------------------------
. 。.
, ，,
? ？?
: ：:
! ！!
; ；;
\\ 、\\
( （(
) ）)
< 《<
> 》>
~ ～~
' ‘’「」'
" “”『』\"
* ×*
$ ￥$
1.2 `pinyinlib-build-regexp-string'
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
It is same as `pinyinlib-build-regexp-char', except that its first
parameter is a string so that it can convert a sequence of letters to
a regular expression.
2 Packages that Use This Library
================================
- [ace-pinyin]
- [evil-find-char-pinyin]
- [find-by-pinyin-dired]
- [pinyin-search]
[ace-pinyin] https://github.com/cute-jumper/ace-pinyin
[evil-find-char-pinyin]
https://github.com/cute-jumper/evil-find-char-pinyin
[find-by-pinyin-dired]
https://github.com/redguardtoo/find-by-pinyin-dired
[pinyin-search] https://github.com/xuchunyang/pinyin-search.el
3 Acknowledgment
================
- The ASCII char to Chinese character
table(`pinyinlib--simplified-char-table' in code) is from
[https://github.com/redguardtoo/find-by-pinyin-dired].
- @erstern adds the table for traditional Chinese characters.
4 Contribute
============
Contributions are always welcome. If you want to add some common
pinyin related functions that might be useful for other packages,
please send me a PR.