Fork this repo, and then add it as upstream.
git clone [your-fork]
git remote add upstream https://github.com/ocodo/emacs.d
You can add packages from Elpa, and customisations to local/init.el,
these will run after init.el has finished.
Note: extended downstream customisation options are being added soon.
Another Note: your local color theme choice will not be overwritten by
updates from upstream - pick one with M-x helm-themes
git pull --all
Make sure we're in our own master branch
git checkout master
Grab all the upstream changes
git rebase upstream/master
If you've modified shared resources, you'll have conflicts to deal with.
If you wish to maintain upstream complete update compatibility, only
update your ./local/.. (which is ignored by git, so you can make it
a separate git repository if you want to.)
I suggest you break away from upstream as soon as you are comfortable installing your own packages.
This config is intended to be used to make Emacs a highly useful editor, and give it some minimalist UI touches. (no Menu, no Toolbar, etc.) It also includes a huge library of pre-installed extensions.
To add localised config, create and use the folder ./local/
Add general config to ./local/init.el
Customize will write to (and load from) ./local/custom.el if you add
it before startup.
Copy ./custom/custom.el to ./local/custom.el if you want to start
from the same state as the general config.
You color-theme selection is always stored locally, in ~/.emacs-theme - initially this will be non-existent or empty.
After first running Emacs with this config, simply run:
M-x helm-themes
Now select a theme from the list.
Your selection will be saved, and untouched by upstream.
This deserves special mention. Tuhdo has done great work here, and managed to cover many many modern extensions to Emacs. Reading the entire set of articles will give you a lot of valuable info. Especially when it comes to making Emacs feel like a modern editor.
This config, has most of the extensions mentiond installed already,
and every week (or even more frequently) they're updated in this
upstream.
And of course, the official emacs tour and manual...
As you may know, Lisp is the backbone of Emacs, and although emacs-lisp isn't quite up there with Common Lisp or Clojure, it's still extremely powerful as a programming tool.
If you have a chance, read Paul Graham's OnLisp, it is the most extraordinary book, when it comes to revealing the true power of Lisp it's in a class of it's own.
It's available as a free PDF download from http://www.paulgraham.com/onlisp.html
Emacs is often jokingly called an OS, really though, it's a Lisp programming scratchpad, quite similar to the old Symbolics Lisp Machines, Smalltalk, IPython, IJulia etc. albeit without much attention paid to GUI features.
Just 30+ years focussed on editing features... thousands of them, just
take a look at M-x package-list-packages.
I've added scores of editing features tailored to my own tastes, I'm sure you'll find it relatively easy to add your own once you get over parenthesiophobia (the fear of Lisp.)
If you use Iterm2, you may be a little sad that there's no Emacs entry
in the Open With Editor.. "Semantic History" option. (If you don't
know of it, you'll find it in Advanced preferences)
There's a few solutions dotted around in different gists and other places around the web. Personally I didn't have too much luck with the scripts I found, so I've added one to my config which works better for me.
Set Semantic History to Run coprocess... and paste in the following:
~/.emacs.d/iterm-emacsclient +\2 \1
Then you're able to Cmd click on filenames in iTerm2
and it will open up an Emacs buffer (or start Emacs from
/Applications)
To open the file at line number. Cmd clicking on a
filename printed in the terminal with a number suffix,
e.g. README.md:130 would open README.md at line 130.