Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/orzechowskid/duomacs
dan's usability-oriented Emacs config files
https://github.com/orzechowskid/duomacs
emacs emacs-configuration
Last synced: 3 months ago
JSON representation
dan's usability-oriented Emacs config files
- Host: GitHub
- URL: https://github.com/orzechowskid/duomacs
- Owner: orzechowskid
- License: gpl-3.0
- Created: 2022-06-19T03:38:51.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-25T16:33:16.000Z (9 months ago)
- Last Synced: 2024-02-25T17:40:14.570Z (9 months ago)
- Topics: emacs, emacs-configuration
- Language: Emacs Lisp
- Homepage:
- Size: 1.13 MB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# emacs 28 users
[click here](https://github.com/orzechowskid/duomacs/tree/emacs-28)
# duomacs
dan's usability-oriented Emacs config files
## What is it
it's emacs for people new to emacs. an opinionated set of config files which aim to bring extra consistency, familiarity, and discoverability to the stock emacs experience. there are some extra goodies related to the major modes I use most often for personal and work projects (Typescript) but otherwise it's pretty barebones.
### What is it really
it's emacs, but with:
- use-package and straight.el for package management
- cua-mode for keybindings which make sense to the rest of the world
- consult, vertico, orderless, corfu, and marginalia for enhancing emacs' built-in completing-read, incremental narrowing, list sorting, etc
- embark for keyboard-controlled context-menu functionality
- a custom menu bar, disabled tool-bar, and heavily delight'd modeline for getting rarely-used junk out of the user's face
- a nord theme and vscode-like light and dark themes for a look and feel that doesn't party like it's 1989
if you know what all of that stuff means, then this set of config files is probably not for you! you probably already know how to configure emacs to your liking.
## Installation
### The easy way
clone this repository and symlink `duomacs-early-init.el` and `duomacs-init.el` into your `~/.emacs.d` directory as `early-init.el` and `init.el` respectively
### The other easy eay
clone this repository and add `(load-file "")` somewhere to your existing init file
### The hard way
copy whatever you want from the various source files into your own init file. go nuts!
## Configuration
the only custom configuration option exposed by duomacs is `duomacs-theme`; all other features are controlled by, and configured via, the packages which provide them. no layers, no duomacs-specific macros, just plain vanilla emacs. an exhaustive list of the packages which power duomacs can be found by running `git grep -A 1 use-package` in your favorite shell, but here are some of the important ones:
- [consult](https://github.com/minad/consult)
- [corfu](https://github.com/minad/corfu)
- [magit](https://magit.vc/)
- [orderless](https://github.com/oantolin/orderless)
- [vertico](https://github.com/minad/vertico)
you can configure these packages (as well as any other built-in or third-party emacs feature) by selecting an item in the Options menu, or by entering `M-x customize-` and choosing one of the items in the resulting list.