bodil / ohai-emacs

The finest hand crafted artisanal emacs.d for your editing pleasure

Ohai Emacs

While it is certainly true that Emacs is the most powerful text editor in the world, your first impression of it may be less favourable, because its default configuration really just isn’t all that great.

But now there is Ohai Emacs! Simply install Ohai Emacs as your emacs.d, and you will be ready to bask in the full radiance of Holy Emacs in no time at all.

There is even a configuration wizard!

Installation

If you don’t have it installed already, go get a copy of GNU Emacs version 24.4 or later.

If you have an emacs.d already, move it out of the way (mv ~/.emacs.d ~/.emacs.d.bak) or get rid of it (rm -rf ~/.emacs.d) first.

To download Ohai Emacs as your new emacs.d:

$ git clone https://github.com/bodil/ohai-emacs.git ~/.emacs.d

That’s it! Now, the next time you start Emacs, Ohai Emacs will ask you a few questions about how you like things to be, and go on the internets and download some fresh packages for you. In a little while, it will be ready for your emacsing.

Usage

A full feature list is pending. A quick overview:

• Carefully styled for a fashionable look.
• Improved navigation, editing and code style settings.
• Use-package macro to isolate package configurations.
• Magit, the premier git frontend.
• Smart autocomplete with company-mode.
• Flycheck.
• Yasnippet.
• Paredit for Emacs Lisp.
• Improved JS and HTML modes with powerful refactoring tools.
• Nyan Cat.

Learning From Emacs Lisp

While Ohai Emacs helps you get started quickly and without frustration, you must eventually learn Emacs Lisp in order to become an Emacs Master. The Ohai Emacs source code contains numerous comments designed to explain, often in detail, what it’s doing. The best (if not the fastest) way to learn what Ohai Emacs can do for you is to read the source.

Start at .emacs.d/init.el. This sets up the basic environment, and loads each Ohai Emacs module from the .emacs.d/modules directory in turn. Read through the .el file in the module directory that are of interest to you, and you will find they explain the changes they make, often pointing you to useful documentation for the more powerful features.

License

Copyright 2015 Bodil Stokke

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

ohai-emacs's Issues

New haskell-mode needs a `package-refresh-contents`

Just a heads-up: the new haskell-mode wouldn't install without a package-refresh-contents first. Maybe add one before trying to download the selected packages? Thanks!

Error on loading

Hi and thanks!
Paradox doesn't load automatically - fails because it can't find spinner.

Package ‘spinner-1.7.3’ is unavailable

But load paradox manually with M-x packages-list-packages etc, and the rest loads fine
Might be a problem with elpa not respoding?
Anyway - thanks for the work - it's great!

Error: Company-quickhelp doesn't work in terminal - On OS X 10.10/Emacs 24.5.1 (using tmux)

DISCLAIMER: I'm normally a Vim user, but with my increasing usage of Lisps lately I wanted to commit to learning Emacs. Maybe the problem is utterly stupid. As I don't have any clue what could be the culprit, the issue could get unreasonably lengthy.

While using your nice little bootstrapping on OS X 10.10 I encountered the following problem (I am editing from the commandline, using zsh and tmux):
I selected all modules on the Ohai Module Selection view. I selected save and after some time compiling, I am stuck with the following error message:

Company-quickhelp doesn't work in terminal!

And that's it.

It seems like the last file that was compiled is the Clang module. After looking at its source for a moment, I am guessing the culprit is not this, but the next module?!

Please tell me if you need more info.

Cheers

Package unavailable

On Windows I get:

Warning (initialization): An error occurred while loading ‘homedir/.emacs.d/init.el’:
error: Package ‘paradox-’ is unavailable

when I start emacs 25.1.1

Most of the "starter kits" (on https://github.com/emacs-tw/awesome-emacs#starter-kit) that I tried return same error, different packages.

psci-mode with a pulp project

When entering psci-mode I'd like it with a pulp project. I.e. it should launch psci with pulp psci in the correct folder.

conventions/hooks for customization

This is light years beyond my old .emacs. Thanks! But what is the best way to add my own customizations while still being able to pull new versions of ohai-emacs? Should I just add stuff to the ends of the various module files and rely on git-merge to do the right thing?

emacs <filename> will open scratch buffer instead of the file

Emacs terminal unusable on OSX when Line Visual Mode in use

I'm a Emacs beginner and love your concept of having a configuration startup with modules to select.

I'm on OSX and for some reason, I've been liking more Emacs terminal mode than window mode. It feels faster and forces me to learn the shortcuts instead of just using the mouse.

Is there any specific reason why you use window mode instead of terminal mode?

Anyway, the problem is that in terminal mode Visual Line Mode breaks. The terminal freezes and you can't do anything but kill -9. It works fine when working in window mode, but I love the speed and wombat themes look and feel on iTerm2 and I'd rather stick to Terminal mode unless there's any good reasons to use Window mode instead.

I do love the idea of having Visual Line Mode, but instead I had been thinking of using FillColumnIndicator (http://www.emacswiki.org/emacs/FillColumnIndicator). That might be more portable between Window and Terminal mode?

Thanks!!!

Flycheck error

Thanks for the Emacs quickstart.

I got an error from Flycheck, having run through the setup and done nothing else. This is what I get with --debug-init:

Debugger entered--Lisp error: (void-function with-eval-after-load)
  (with-eval-after-load "flycheck" (setq flycheck-highlighting-mode (quote symbols)) (add-hook (quote flycheck-mode-hook) (quote flycheck-color-mode-line-mode)))
  eval-buffer(#<buffer  *load*-807660> nil "/home/ctford/.emacs.d/modules/ohai-flycheck.el" nil t)  ; Reading at buffer position 1539
  load-with-code-conversion("/home/ctford/.emacs.d/modules/ohai-flycheck.el" "/home/ctford/.emacs.d/modules/ohai-flycheck.el" nil t)
  require(ohai-flycheck)
  (let ((module (car --dolist-tail--))) (require module) (setq --dolist-tail-- (cdr --dolist-tail--)))
  (while --dolist-tail-- (let ((module (car --dolist-tail--))) (require module) (setq --dolist-tail-- (cdr --dolist-tail--))))
  (let ((--dolist-tail-- ohai-module-list)) (while --dolist-tail-- (let ((module (car --dolist-tail--))) (require module) (setq --dolist-tail-- (cdr --dolist-tail--)))))
  eval-buffer(#<buffer  *load*> nil "/home/ctford/.emacs.d/init.el" nil t)  ; Reading at buffer position 3191
  load-with-code-conversion("/home/ctford/.emacs.d/init.el" "/home/ctford/.emacs.d/init.el" t t)
  load("/home/ctford/.emacs.d/init" t t)
  #[0 "�\205\262

Will post the answer if/when I figure it out.

(file-error "Cannot open load file" "package")

require(package)
eval-buffer(#<buffer load<3>> nil "/home/l2/svirchevsky/.emacs.d/ohai/ohai-package.el" nil t) ; Reading at buffer position 1578
load-with-code-conversion("/home/l2/svirchevsky/.emacs.d/ohai/ohai-package.el" "/home/l2/svirchevsky/.emacs.d/ohai/ohai-package.el" nil t)
require(ohai-package)
eval-buffer(#<buffer load<2>> nil "/home/l2/svirchevsky/.emacs.d/ohai/ohai-lib.el" nil t) ; Reading at buffer position 846
load-with-code-conversion("/home/l2/svirchevsky/.emacs.d/ohai/ohai-lib.el" "/home/l2/svirchevsky/.emacs.d/ohai/ohai-lib.el" nil t)
require(ohai-lib)
eval-buffer(#<buffer load> nil "/home/l2/svirchevsky/.emacs.d/init.el" nil t) ; Reading at buffer position 2146
load-with-code-conversion("/home/l2/svirchevsky/.emacs.d/init.el" "/home/l2/svirchevsky/.emacs.d/init.el" t t)
load("/home/l2/svirchevsky/.emacs.d/init" t t)
#[nil "^H\205\264^@ \306=\203^Q^@\307^H\310Q\2027^@ \311=\2033^@\312\307\313\314#\203#^@\315\2027^@\312\307\313\316#\203/^@\317\2027^@\315\202$
command-line()
normal-top-level()

any ideas what is going on ?
I have just git cloned the depot to ~/.emacs.d
and removed my ~/.emacs

ido redundancy

Love your setup.

FYI, I'm getting this each time I load. Looks like an easy fix...

Warning (ido-ubiquitous): The ido-ubiquitous package is now redundant. All functionality, including ido-ubiquitous-mode, has been merged into the ido-completing-read+ package. You should replace ido-ubiquitous with ido-completing-read+ in your Emacs config.
Warning (iedit): Iedit default key "C-;" is occupied by avy-goto-word-1.

Something's wrong with the puppies!

It seems like something is not loading the images of the puppies!

On the Mac, I'm seeing this error:
web/http-post-sentinel unexpected evt: killed: 9

error in process filter: open-network-stream: make client process failed: connection refused, :name, web-http-post-localhost:80/, :buffer, localhost:80/, :host, localhost, :service, 80, :nowait, nil
error in process filter: make client process failed: connection refused, :name, web-http-post-localhost:80/, :buffer, localhost:80/, :host, localhost, :service, 80, :nowait, nil

On Arch Linux, this is the error:
error in process filter: image-type: Cannot determine image type

It looks like something is failing in the ohai-splash/load-image function call.

This is only reproducible when selecting "puppies" during the ohai-startup-wizard. It works fine for "I hate animals" or "The noble otter".

Hope this was useful! Thanks for this project.

Where to find `psc-ide-command-rebuild`?

I'm going through the psc-ide + flycheck integration, and to invoke the check a psc-ide-command-rebuild command is sent to psc-server, but I can't find where it is defined (nor can emacs). Should it be defined somehow locally, or is this some temporary setup?

Thanks!

Consider smart-parens instead of paredit.

It's pretty darn good.

`(helm-projectile-on)` is not called

This will make all projectile command work in helm way

Intro popups don't render nicely on mac

Now you made me look into Emacs again.

This is not that big of a deal, but on a Mac with Emacs 24.4 the popups with 'I am ready' and the puppy selection show up like this

Name your repo "dotemacs"

makes it more retrievable and comparable.
Thanks.
Like:
https://github.com/search?o=desc&p=6&q=dotemacs&s=forks&type=Repositories