2015-12-02 14:23:39 +00:00
#+TITLE : OSX layer
2015-11-08 18:04:44 +00:00
#+HTML_HEAD_EXTRA : <link rel="stylesheet" type="text/css" href="../../css/readtheorg.css" />
2015-06-10 16:44:30 +00:00
[[file:img/apple.png ]]
2015-10-30 11:20:58 +00:00
* Table of Contents :TOC_4_org:noexport:
- [[Description ][Description ]]
- [[Philosophy ][Philosophy ]]
- [[Install ][Install ]]
- [[Layer ][Layer ]]
- [[Use with non-US keyboard layouts ][Use with non-US keyboard layouts ]]
- [[Coreutils ][Coreutils ]]
- [[Key Bindings ][Key Bindings ]]
- [[Future Work ][Future Work ]]
2015-06-10 16:44:30 +00:00
* Description
Spacemacs is not just emacs+vim. It can have OSX keybindings too!
This layer globally defines common OSX keybindings. ~⌘~ is set to
2015-06-12 01:23:07 +00:00
~super~ and ~⌥~ is set to ~meta~ . Aside from that, there's nothing
2015-06-10 16:44:30 +00:00
much, really.
While in =dired= this layer will try to use =gls= instead of =ls= .
* Philosophy
While this layer enables common OSX bindings, it does not implement
OSX navigation keybindings. Spacemacs is meant to be used with evil,
and we encourage you to do so :)
* Install
** Layer
2016-01-05 17:38:25 +00:00
To use this configuration layer, add it to your =~/.spacemacs= . You will need to add `osx` to the existing list of `dotspacemacs-configuration-layers` in this file.
2015-06-10 16:44:30 +00:00
2015-06-12 17:25:20 +00:00
*** Use with non-US keyboard layouts
If you need the ~⌥~ key to type common characters such as `{[]}~` which is usual
for e.g. Finnish and Swedish keyboard layouts, you'll probably want to leave the
~⌥~ key unchanged by setting the =osx-use-option-as-meta= variable to =nil= :
#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '(
(osx :variables osx-use-option-as-meta nil)))
#+END_SRC
2015-06-10 16:44:30 +00:00
** Coreutils
To get =gls= install coreutils homebrew:
#+BEGIN_SRC sh
brew install coreutils
#+END_SRC
* Key Bindings
| Key Binding | Description |
|-------------+-------------------|
2015-11-11 18:40:39 +00:00
| ~⌘ =~ | Scale up text |
2015-06-10 16:44:30 +00:00
| ~⌘ -~ | Scale down text |
| ~⌘ q~ | Quit |
| ~⌘ v~ | Paste |
| ~⌘ c~ | Copy |
| ~⌘ x~ | Cut |
| ~⌘ a~ | Select all |
| ~⌘ w~ | Close window |
| ~⌘ W~ | Close frame |
| ~⌘ n~ | New frame |
| ~⌘ z~ | Undo |
| ~⌘ Z~ | Redo |
| ~⌃ ⌘ f~ | Toggle fullscreen |
* Future Work
2015-06-12 01:23:07 +00:00
- Allow user to choose from either ~hyper~ or ~super~ as ~⌘~ . This is an option
2015-06-10 16:44:30 +00:00
that is supported cross-platform.
- Configurable option to keep the OSX and spacemacs clipboards separate