spacemacs/layers/typography/README.org

56 lines
2.3 KiB
Org Mode
Raw Normal View History

#+TITLE typography contribution layer for Spacemacs
* Table of Contents
* 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.
* 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 y~ | Toggle Typo Mode (automatic insertion of typographic characters) |
| ~SPC t T d~ | Toggle Tildify Mode (automatic insertion of non-breaking spaces) |
| ~SPC x T t~ | Insert non-breaking spaces in the current region |
** Typo Mode
| Key Bindings (insert mode) | 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 (insert mode) | Description |
| ~SPC~ | Insert non-breaking space when required |