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

* Table of Contents                                         :TOC_4_org:noexport:
 - [[Description][Description]]
 - [[Install][Install]]
 - [[Key bindings][Key bindings]]
   - [[Typo Mode][Typo Mode]]
   - [[Tildify Mode][Tildify Mode]]

* Description
This layer provides support for typographic text editing in Spacemacs.  It
provides modes to automatically insert and cycle among typographic characters:

- [[https://github.com/jorgenschaefer/typoel][Typo Mode]] automatically inserts and cycles among typographic Unicode
  characters on some keys.
- Tildify Mode automatically inserts non-breaking spaces where required. (Only
  available on Emacs 25).

* Install
To use this contribution add it to your =~/.spacemacs=

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

Typographic editing however is disabled by default.  To enable it by default set
=typography-enable-typographic-editing= to =t=:

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers
                '(typography :variables typography-enable-typographic-editing t))
#+END_SRC

This setting enables automatic insertion of non-breaking spaces where required
and automatic insertion and cycling among of typographic quotes and dashes.

* Key bindings

| Key Bindings | Description                                                      |
|--------------+------------------------------------------------------------------|
| ~SPC t T~    | Toggle Typo Mode (automatic insertion of typographic characters) |
| ~SPC t ~~    | Toggle Tildify Mode (automatic insertion of non-breaking spaces) |
| ~SPC x ~~    | Insert non-breaking spaces in the current region                 |

The following keybindings are available in insert state.

** Typo Mode

| Key Bindings | Description                              |
|--------------+------------------------------------------|
| ~"~          | Cycle among quotation marks              |
| ~`~          | Cycle among left single quotation marks  |
| ~'~          | Cycle among right single quotation marks |
| ~-~          | Cycle among dashes                       |
| ~.~          | Cycle among ellipsis                     |
| ~<~          | Cycle among left angle brackets          |
| ~>~          | Cycle among right angle brackets         |

** Tildify Mode

| Key bindings | Description                             |
|--------------+-----------------------------------------|
| ~SPC~        | Insert non-breaking space when required |