|
|
@ -52,9 +52,9 @@ $ cp -r /usr/local/Cellar/emacs/HEAD/Emacs.app /Applications/ |
|
|
|
|
|
|
|
|
The second step is optional, but it's recommended if you like to start |
|
|
The second step is optional, but it's recommended if you like to start |
|
|
Emacs from the launchpad or from Spotlight. Personally I prefer to |
|
|
Emacs from the launchpad or from Spotlight. Personally I prefer to |
|
|
start Emacs in daemon mode (emacs --daemon), so that I could share a |
|
|
|
|
|
single Emacs instance between several Emacs clients (emacsclient |
|
|
|
|
|
-c/t). |
|
|
|
|
|
|
|
|
start Emacs in daemon mode (`emacs --daemon`), so that I could share a |
|
|
|
|
|
single Emacs instance between several Emacs clients (`emacsclient |
|
|
|
|
|
-c/t`). |
|
|
|
|
|
|
|
|
That's all folk! You may now proceed to the configuration section. |
|
|
That's all folk! You may now proceed to the configuration section. |
|
|
|
|
|
|
|
|
@ -110,6 +110,7 @@ The following list will be expanded greatly in the future. |
|
|
|
|
|
|
|
|
* Clojure |
|
|
* Clojure |
|
|
* CoffeeScript |
|
|
* CoffeeScript |
|
|
|
|
|
* Groovy |
|
|
* Haskell |
|
|
* Haskell |
|
|
|
|
|
|
|
|
### Additional markup languages support |
|
|
### Additional markup languages support |
|
|
@ -123,12 +124,21 @@ The following list will be expanded greatly in the future. |
|
|
### Enhanced configuration |
|
|
### Enhanced configuration |
|
|
|
|
|
|
|
|
* C |
|
|
* C |
|
|
|
|
|
* Clojure |
|
|
|
|
|
* CoffeeScript |
|
|
* Common Lisp |
|
|
* Common Lisp |
|
|
|
|
|
* ERC |
|
|
|
|
|
* JavaScript |
|
|
|
|
|
* Python |
|
|
* Ruby |
|
|
* Ruby |
|
|
* Scheme |
|
|
* Scheme |
|
|
|
|
|
* XML |
|
|
|
|
|
|
|
|
## Enhanced productivity |
|
|
## Enhanced productivity |
|
|
|
|
|
|
|
|
|
|
|
* Projectile |
|
|
|
|
|
* yasnippet |
|
|
|
|
|
|
|
|
## Bundled packages |
|
|
## Bundled packages |
|
|
|
|
|
|
|
|
* auctex (LaTeX editing) |
|
|
* auctex (LaTeX editing) |
|
|
@ -136,12 +146,14 @@ The following list will be expanded greatly in the future. |
|
|
* coffee-mode |
|
|
* coffee-mode |
|
|
* deft (note taking) |
|
|
* deft (note taking) |
|
|
* gist (snippet sharing on github.com) |
|
|
* gist (snippet sharing on github.com) |
|
|
|
|
|
* groovy-mode |
|
|
* haml-mode |
|
|
* haml-mode |
|
|
* haskell-mode |
|
|
* haskell-mode |
|
|
* magit (enhanced git integration) |
|
|
* magit (enhanced git integration) |
|
|
* markdown-mode |
|
|
* markdown-mode |
|
|
* paredit |
|
|
* paredit |
|
|
* projectile (project management mode) |
|
|
* projectile (project management mode) |
|
|
|
|
|
* python.el (improved Python mode) |
|
|
* sass-mode |
|
|
* sass-mode |
|
|
* scss-mode |
|
|
* scss-mode |
|
|
* yaml-mode |
|
|
* yaml-mode |
|
|
@ -150,8 +162,14 @@ The following list will be expanded greatly in the future. |
|
|
|
|
|
|
|
|
## Installation |
|
|
## Installation |
|
|
|
|
|
|
|
|
git clone git://github.com/bbatsov/emacs-prelude.git path/to/local/repo |
|
|
|
|
|
ln -s path/to/local/repo ~/.emacs.d |
|
|
|
|
|
|
|
|
```bash |
|
|
|
|
|
$ git clone git://github.com/bbatsov/emacs-prelude.git path/to/local/repo |
|
|
|
|
|
$ ln -s path/to/local/repo ~/.emacs.d |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
You'd do well to replace `~/.emacs.d` with the value of |
|
|
|
|
|
`user-emacs-directory` for your OS. You can check the value by doing |
|
|
|
|
|
`C-h v user-emacs-directory` inside Emacs. |
|
|
|
|
|
|
|
|
You might have to install the `make` and `makeinfo` packages if you |
|
|
You might have to install the `make` and `makeinfo` packages if you |
|
|
don't have them already, since the build of some packages obtained via |
|
|
don't have them already, since the build of some packages obtained via |
|
|
@ -162,19 +180,37 @@ don't have them already, since the build of some packages obtained via |
|
|
Nothing fancy here. Just start Emacs as usual. Personally I run Emacs |
|
|
Nothing fancy here. Just start Emacs as usual. Personally I run Emacs |
|
|
in daemon mode: |
|
|
in daemon mode: |
|
|
|
|
|
|
|
|
`emacs --daemon` |
|
|
|
|
|
|
|
|
`$ emacs --daemon` |
|
|
|
|
|
|
|
|
Afterwards I connect to the server with either a terminal or a GUI |
|
|
Afterwards I connect to the server with either a terminal or a GUI |
|
|
client like this: |
|
|
client like this: |
|
|
|
|
|
|
|
|
emacsclient -t |
|
|
|
|
|
emacsclient -c |
|
|
|
|
|
|
|
|
```bash |
|
|
|
|
|
$ emacsclient -t |
|
|
|
|
|
$ emacsclient -c |
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
## Color Themes |
|
|
|
|
|
|
|
|
|
|
|
Emacs 24 ships with a new theming facility that effectively renders |
|
|
|
|
|
the old color-theme package obsolete. Emacs 24 provides a dozen of |
|
|
|
|
|
built-in themes you can use out-of-the-box by invoking the `M-x |
|
|
|
|
|
load-theme` command. Emacs Prelude adds two more popular themes to the |
|
|
|
|
|
mix - zenburn and solarized (I'm the maintainer of the Emacs ports |
|
|
|
|
|
included). |
|
|
|
|
|
|
|
|
|
|
|
Zenburn is the default color theme in Prelude, but you can change it |
|
|
|
|
|
at your discretion. Why Zenburn? I (and lots of hackers around the |
|
|
|
|
|
world) find it pretty neat for some reason. Personally I find the |
|
|
|
|
|
default theme pretty tiresome for the eyes, that's why I took that |
|
|
|
|
|
"controversial" decision to replace it. You can, of course, easily go |
|
|
|
|
|
back to the default (or select another theme entirely). |
|
|
|
|
|
|
|
|
## Personalizing |
|
|
## Personalizing |
|
|
|
|
|
|
|
|
If you'd like to change some of the setting in Prelude (or simply add |
|
|
If you'd like to change some of the setting in Prelude (or simply add |
|
|
more) the proper way to do so would be to create Emacs Lisp files |
|
|
more) the proper way to do so would be to create Emacs Lisp files |
|
|
under the **personal** directory in ~/.emacs.d. They will be loaded |
|
|
|
|
|
|
|
|
under the **personal** directory in `prelude-dir`. They will be loaded |
|
|
automatically be Prelude on startup. |
|
|
automatically be Prelude on startup. |
|
|
|
|
|
|
|
|
Avoid modifying the Prelude config itself - this will make it hard for |
|
|
Avoid modifying the Prelude config itself - this will make it hard for |
|
|
@ -190,25 +226,25 @@ far as navigation is concerned at least). That's why I've disabled all |
|
|
movement commands with arrows - to prevent you from being tempted to |
|
|
movement commands with arrows - to prevent you from being tempted to |
|
|
use them. |
|
|
use them. |
|
|
|
|
|
|
|
|
### What is this terrible default theme? |
|
|
|
|
|
|
|
|
### Windows compatibility |
|
|
|
|
|
|
|
|
It's called Zenburn and I (and lots of hackers around the world) find it |
|
|
|
|
|
pretty neat (I also happen to be the maintainer of its Emacs port). I |
|
|
|
|
|
find the default theme pretty tiresome for the eyes, that's why I took |
|
|
|
|
|
that "controversial" decision to replace it. You can, of course, |
|
|
|
|
|
easily go back to the default (or select another theme entirely). |
|
|
|
|
|
|
|
|
While everything in Prelude should work fine in Windows I test it only |
|
|
|
|
|
with Linux & OSX so there are Windows related problems from time to |
|
|
|
|
|
time. This situation will probably improve over time. |
|
|
|
|
|
|
|
|
## Known issues |
|
|
## Known issues |
|
|
|
|
|
|
|
|
None so far. |
|
|
|
|
|
|
|
|
Check out the project's issue list for that. :-) |
|
|
|
|
|
|
|
|
## Bugs & Improvements |
|
|
## Bugs & Improvements |
|
|
|
|
|
|
|
|
Bug reports and suggestions for improvements are always |
|
|
Bug reports and suggestions for improvements are always |
|
|
welcome. github pull requests are even better! ;-) |
|
|
|
|
|
|
|
|
welcome. github pull requests are even better! :-) |
|
|
|
|
|
|
|
|
I'd like to include a nice variety of Emacs 24 themes into Prelude - |
|
|
I'd like to include a nice variety of Emacs 24 themes into Prelude - |
|
|
so if you've developed (or simply found) one - give me a shout and |
|
|
so if you've developed (or simply found) one - give me a shout and |
|
|
I'll take a look at it. |
|
|
I'll take a look at it. |
|
|
|
|
|
|
|
|
|
|
|
Cheers, |
|
|
Bozhidar |
|
|
Bozhidar |
|
|
|
|
|
|