Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fgallina/dotemacs

My GNU/Emacs configuration
https://github.com/fgallina/dotemacs

Last synced: 13 days ago
JSON representation

My GNU/Emacs configuration

Awesome Lists containing this project

README 

        
fgallina's Emacs configuration.



* Info



  + Author: Fabián Ezequiel Gallina

  + Contact: fabian at anue dot biz

  + My Blog: http://www.from-the-cloud.com



* Introduction



  This is just my Emacs configuration. It auto-installs all packages

  using mostly elpa and some from el-get.



  For a glance of all installed packages check all `user-package'

  declarations.



* Requirements



These are the necessary packages for all enabled plugins.



  + Emacs 24.x

  + Bazaar: for package downloads.

  + CVS: for package downloads.

  + Git: for package downloads and magit.

  + Mercurial: for package downloads.

  + SVN: for package downloads.

  + leiningen 2.x: for nrepl and friends.

  + python (2.6 or 2.7): for building jedi.



See "Disabling packages" section for a way to avoid some requirements.



** Arch GNU/Linux

Installation of all requirements in Arch is quite simple.



#+BEGIN_SRC sh

sudo pacman -S bzr cvs git mercurial subversion emacs python2

#+END_SRC



** Ubuntu



#+BEGIN_SRC sh

sudo apt-get install bzr cvs git mercurial subversion emacs python

#+END_SRC



* Installation



When you meet all requirements, everything should install

automatically after you launch Emacs. If some package fail because

of a network connection failure or anything, restarting Emacs will

continue installation from that point.



There are 3 non-required important files you might want to check out:

  + ~/.emacs.d/secrets.el: This is a file I'm using to store my IRC

    password and other sensible stuff.

  + ~/.emacs.d/pre-startup.el: This file might contain any lisp

    that's intended to be run *before* all packages are loaded and

    initialized.

  + ~/.emacs.d/post-startup.el: This file might contain any lisp

    that's intended to be run *after* all packages are loaded and

    initialized.



If you are using jedi, you need to install a python environment for it

to use. You can do so like this:



#+BEGIN_SRC sh

cd ~/.emacs.d/elpa/jedi-*

make requirements PYTHON=python2  # or the python interpreter of your preference.

#+END_SRC



If you plan to use the clojure related packages you need to install

leiningen. Generally you want to do this manually by adding the

executable in your =$PATH=. See http://leiningen.org/ for

instructions.



* Disabling packages



If you don't want to install some packages you can use

the *pre-startup.el* file to modify the =my:disabled-packages=

variable.



#+BEGIN_SRC emacs-lisp

;;; pre-startup.el

;; Avoid installing/loading some packages.

(setq my:disabled-packages '(ace-jump-mode jedi clojure-mode))

#+END_SRC



If you plan byte-compiling the init file (which is recommended) via

the =byte-compile-file= or =emacs-lisp-byte-compile= command (i.e. not

in batch mode), be sure to eval =my:disabled-packages= new value and

then eval the whole init.el buffer, so the =user-package= macro is

expanded properly for newly enabled/disabled packages.



* Confusing stuff



While this dotemacs is maintained with the idea that it could be

reused by anyone, it's still my dotemacs and it's configured the way I

like it. This means that there may be some stuff you could consider

weird, so here is a non extensive listing of those and the ways you

can prevent them.



** God mode



God mode is awesome, it brings the modal bindings paradigm to Emacs

without trying to change the bindings you've learned during all this

time. The thing is that `god-mode` can be confusing, especially if you

haven't set it up yourself and are using this config out of the

box. You can disable it by adding `god-mode` to your

`my:disabled-packages` in the `pre-startup.el` file.



** Smartparens



If you feel some bindings are doing weird things when working with

parens or sexps, please check the `smartparens` configuration. If you

are still not convinced about smartparens just add the following to

You can disable it by adding `smartparens` to your

`my:disabled-packages` in the `pre-startup.el` file.



** Errors when copying or pasting stuff



I use Emacs on the terminal for the most part, and I have integrated

it with the `xsel` utility to make it populate my X system clipboard

when sending doing copy/cut/paste.



If you are experiencing errors with this: either install xsel, change

the integration to use whatever utility you'd like or just disable the

feature completely and let Emacs behave by default by adding this code

in your `post-startup.el` file:



#+BEGIN_SRC emacs-lisp

(setq interprogram-cut-function nil

      interprogram-paste-function nil)

#+END_SRC



** Menu bar, scroll bar and tool bar



If you are new to Emacs you will probably want to have these things

activated again, to restore then add the following in your

`post-startup.el`:



#+BEGIN_SRC emacs-lisp

(menu-bar-mode 1)

(scroll-bar-mode 1)

(tool-bar-mode 1)

#+END_SRC



* Bug Reports



  If you find a configuration bug please report it in the github

  tracker. Any package bugs must be reported in their upstream bug

  tracker.



* License



  See each package located at =~/.emacs.d/el-get/= and

  =~/.emacs.d/elpa/= for their licenses.  The =~/.emacs.d/init.el=

  file is on the public domain.