~zge/kaomoji

easily insert kamoiis (eastern emoticons) in emacs
d18423f7 — Philip K 6 months ago
fixed melpa link in readme
b943fe73 — Philip K 8 months ago
added missing subr-x dependency
0c52e126 — Philip K 10 months ago
removed trailing whitespace

clone

read-only
https://git.sr.ht/~zge/kaomoji
read/write
git@git.sr.ht:~zge/kaomoji

You can also use your local clone with git send-email.

#insert-kaomoji.el

This packages collects and categorises eastern emoticons, called "kaomojis", as to make it easy to insert them into text within Emacs.

All the kaomojis are stored in a secondary file, which should be placed in the same directory as insert-kaomoji.el. The file format itself is described below.

#How to use

Using MELPA and use-package, a minimal setup might look something like this:

(use-package insert-kaomoji
  :bind ("C-x 8 k" . insert-kaomoji))

#KAOMOJIS format

The KAOMOJIS file has to use a slightly peculiar format, since usual delimiters such as newlines, tabs, commas, etc. all can appear in a emoticon. For that reason, the format instead uses special ASCII control characters, code 29 to 31.

These designate:

  • 29 (group separator): A category of emoticons ("Happy", "Sad", etc.)
  • 30 (record separator): Divide a category into labels (first part) and content (latter part). Only one record separator is allowed per group.
  • 31 (unit separator): Within the labels part, it separates synonyms, and in the content the single emoticons. Note that all synonyms are stripped of surrounding white spaces, allowing new categories to start on new lines.

Bug reports and patches should be sent to my public inbox.

#Copying

bang.el is distributed under the CC0 1.0 Universal (CC0 1.0) Public Domain Dedication license.