#+TITLE: Chrome layer

[[file:img/chrome.png]]

* Table of Contents                                         :TOC_4_gh:noexport:
 - [[#description][Description]]
   - [[#features][Features]]
 - [[#install][Install]]
   - [[#layer][Layer]]
   - [[#chrome-extension][Chrome extension]]
 - [[#configuration][Configuration]]

* Description
This layer provides some integration with the Google Chrome browser.

** Features
- Edit text boxes with Emacs using [[http://melpa.org/#/edit-server][edit-server]]

* Install
** Layer
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =chrome= to the existing =dotspacemacs-configuration-layers= list in this
file.

** Chrome extension
[[http://melpa.org/#/edit-server][edit-server]] is a server that responds to edit requests sent Chrome via the
Google Chrome extension [[https://chrome.google.com/webstore/detail/edit-with-emacs/ljobjlafonikaiipfkggjbhkghgicgoh][Edit with Emacs]]. You have to install this extension.

More information can be found on [[http://www.emacswiki.org/emacs/Edit_with_Emacs][Emacs Wiki]].
The edit server is configured to start automatically when Spacemacs starts.

* Configuration
Use =edit-server-url-major-mode-alist= to choose a major mode initialization
function based on =edit-server-url=, or fall back to
=edit-server-default-major-mode= that has a current value of =markdown-mode=.

#+BEGIN_SRC emacs-lisp
  (defun dotspacemacs/user-config ()
  ;; Open github text areas as org buffers
  ;; currently they are opened as markdown
    (setq edit-server-url-major-mode-alist
        '(("github\\.com" . org-mode))))
#+END_SRC

To change frame defaults (width, height, etc. use =edit-server-new-frame-alist=)

#+BEGIN_SRC emacs-lisp
  (add-to-list 'edit-server-new-frame-alist '(width  . 140))
  (add-to-list 'edit-server-new-frame-alist '(height . 60))
#+END_SRC

If you want Emacs to switch focus to Chrome after done editing, you can utilize =edit-server-done-hook=.
Emacs cannot control focus of windows for external apps, so you need to use some sort of command line window manager like =wmctrl=.
The following example works on OS X:

#+BEGIN_SRC emacs-lisp
  (add-hook 'edit-server-done-hook (lambda () (shell-command "open -a \"Google Chrome\"")))
#+END_SRC
