jmcbray/basic-emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
A very basic emacs config
33 commits 1 branch 0 tags 56 KiB
  • Emacs Lisp 100%
Find a file
Exact
Jason McBrayer a30107a8f2 Run ’quick-help-toggle for new users.
2022-12-31 11:45:59 -05:00
startup Some fixups related to loading all package sets by default 2022-12-31 11:34:09 -05:00
.gitignore Some fixups related to loading all package sets by default 2022-12-31 11:34:09 -05:00
early-init.el Load everything by default, don't mess with package archives list 2022-12-31 11:20:51 -05:00
init.el Run ’quick-help-toggle for new users. 2022-12-31 11:45:59 -05:00
README.org Some fixups related to loading all package sets by default 2022-12-31 11:34:09 -05:00

README.org

basic-emacs.d

This is a very basic emacs setup that is intended as an alternative set of "defaults" for Emacs in 2022, for new users, or for anyone declaring ".emacs bankruptcy".

It has options to install packages of decreasing "purity" — built-in packages only, from GNU ELPA only, or from non-GNU ELPA. Installing the GNU ELPA packages provides what I would consider a completely modern GNU Emacs experience, but missing a few packages many would consider essential, like Magit. Enabling the non-GNU option will install these. By default, they are all used, but if you want a smaller Emacs, you may comment out the extra packages.

It is intended that users of this setup modify it to their own preferences. This setup does not provide everything a typical Emacs user will need, only better quality-of-life defaults and very common needs. This is not my personal day-to-day config, which is much blingier and has many things installed from MELPA. But it is extracted from my personal config, more or less.

Usage

Clone this repository to a directory on your computer.

In Emacs 29, run emacs --init-directory <basic-emacs-directory> from a shell.

If you have problems, you may wish to instead start with emacs --init-directory <basic-emacs-directory> --debug-init.

If you are using an older Emacs (27.1 and newer should be basically supported), rename your existing ~/.emacs.d to ~/.emacs.d.mine. Create a symbolic link ~/.emacs.d pointing to the basic-emacs directory, then start Emacs with: emacs --debug-init.

Fonts

This setup uses your default monospace and sans-serif fonts for the default and variable-pitch faces. Those may not be the best for you, but at least they won't cause startup errors. Please change them as you see fit.

It does, however, expect either or both of the NotoEmoji or Symbola fonts to be installed, for emoji support. If you get an error on startup related to either of these fonts, either install them or comment out the configuration line mentioning them. If you prefer color emoji, make sure a color emoji font is installed, and change the NotoEmoji line to refer to it.

Contributing

Please send patches or pull requests by email to jmcbray-simple-emacs@carcosa.net. Patches should preferably be formatted with git-format-patch.