spacemacs/layers/+fun/emoji/README.org

#+TITLE: Emoji contribution layer for Spacemacs
#+HTML_HEAD_EXTRA: <link rel="stylesheet" type="text/css" href="../../../css/readtheorg.css" />

#+HTML: :blue_heart::green_heart::heart::gift_heart::heartbeat::heartpulse::purple_heart::sparkling_heart::yellow_heart:

* Table of Contents                                         :TOC_4_org:noexport:
 - [[Description][Description]]
   - [[Features:][Features:]]
 - [[Install][Install]]
 - [[Key bindings][Key bindings]]
   - [[Emoji dedicated buffer][Emoji dedicated buffer]]

* Description
This layer adds support for Emoji emoticons from [[http://www.emoji-cheat-sheet.com/][emoji-cheat-sheet.com]].

** Features:
- Browse Emoji in a dedicated buffer
- Display Emoji images in buffer
- Insert one or several Emoji with an helm front-end
- Completion of Emojis using [[https://github.com/dunn/company-emoji][company-emoji]]
  
* Install
To use this contribution add it to your =~/.spacemacs=

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers '(emoji))
#+END_SRC

* Key bindings

| Key Binding | Description                             |
|-------------+-----------------------------------------|
| ~SPC a E~   | open a dedicated buffer to browse Emoji |
| ~SPC i e~   | insert Emoji via an helm buffer         |

** Emoji dedicated buffer

| Key Binding | Description             |
|-------------+-------------------------|
| ~RET~       | copy current Emoji code |
| ~q~         | quit                    |