In this repository will house my various configurations. Some things are currently still kept in a private repo elsewhere but as I get time I plan to move all my setups to this repository. It will likely end up including:
- Dot files in my home directory
- Configurations for software that does not use dot files
- My container setup
- Others that I haven't thought of
Pull requests are welcome, but keep in mind that this is my configuration and I reserve the right to reject a PR just because I don't like the changes :) Of course that doesn't mean the changes are not good for other people, so ideally I will move things in a direction that will allow easy customization for people.
The Emacs configuration installs itself, but first you should set a few options
in it. If you open the .emacs.el file you will be able to specify options for
some of the packages used, such as
EIN, whether to use Dvorak
bindings, and whether to enable Evil mode. You'll need to specify some paths,
but most of the configuration should work without any changes.
- Copy or symbolically link
.emacs.elto your home directory - Start Emacs
- Restart Emacs
- Delete
~/.emacs.elc - Restart Emacs three times
Everything except Jupyter, ClangFormat, Clang-Rename, and YouCompleteMeDaemon will have installed itself, as well as any completers for lsp-mode That is, everything that isn't an external-to-Emacs third party dependency is installed on startup.
Here is an overview of the packages I use:
- Ivy, Counsel, and Swiper instead of Helm and friends.
- projectile for navigating around projects
- window-numbering to easily navigate panes
- origami for code folding
- avy and zzz-to-char for quick navigation around the buffer
- visual-regexp-steroids for regexp-replacements
- Google Style Guide for C/C++ projects (you may need to change that for your projects :) )
- lsp-mode for code completion in Python, C/C++, and Rust (I currently don't use other languages).
- company for general completion (hooking into LSP)
- flycheck for syntax checking
- string-inflection for changing the case of the word-at-point
- multiple-cursors because editing with many cursors is faster
- ein for Jupyter notebooks
- flyspell for spell-check
- magit, git-timemachine, gitgutter, and gitignore-mode for git
- hydra for reducing modifier presses
- evil-mode for vi users (I personally am not one, but figured others might find it useful, plus I might learn some day :) )
- evil-collection is used to supplement evil-mode
- selectrum for improving search without the extra overhead of Ivy or helm
- prescient for better sorting of results
I've added an option to the change some of the packages' default shortcuts to be better-suited for fellow Dvorak users.
Here are some of the shortcuts I use a lot. Note that I abbreviate control with
C and meta/option/alt with M. so C-c M-n would mean control-c followed
by meta-n.
| Shortcut | Description |
|---|---|
M-p |
Add cursor above matching currently highlighted region. |
M-n |
Add cursor below matching currently highlighted region. |
C-c m a |
Multiple cursors all like the selected region. |
M-? |
Mark paragraph. |
C-/ |
Undo |
C-h |
Backspace |
M-h |
Kill previous word |
C-c ; |
Comment or uncomment region |
C-m |
Enter/newline and indent |
C-c g |
Use Counsel to do a git grep |
C-c r |
Use Counsel to do a ripgrep |
M-. |
Find tag at point/LSP goto definition |
M-t |
Grep for symbol at point |
C-x M-f |
Projectile find file to find file in project. |
M-s |
Avy go to visible word that starts with character. |
M-c |
Avy go to visible two characters. |
C-M-s |
Visual regexp forward search. |
C-M-r |
Visual regexp reverse search. |
M-1, M-2 |
Used to go to windows 1, 2, 3, 4, etc. |
C-c h |
A hydra dispatch to other hydras |
| Shortcut | Description |
|---|---|
C-c C-w |
Cut to clipboard. |
C-c M-w |
Copy to clipboard. |
C-c C-y |
Paste from clipboard. |
M-z |
Kill from cursor to character. |
C-c v r |
Visual regexp query replace. |
C-c v m |
Visual regexp multiple cursors. |
C-c c i |
Cycle the string inflection between cases. |
C-c c l |
String inflection to lowerCamelCase. |
C-c c c |
String inflection to CamelCase. |
C-c c s |
String inflection to snake_case. |
C-c c u |
String inflection to SCREAMING_SNAKE_CASE. |
M-g M-s |
Open Magit status. |
M-g M-c |
Magit checkout. |
M-g M-t |
Start git-timemachine. |
<f7> |
Run FlySpell over buffer. |
<f8> |
Jump to previous FlySpell error. |
<f9> |
Jump to next FlySpell error. |
| Shortcut | Description |
|---|---|
C-c C-c |
Bring up the compilation command to run. |
C-c C-k |
Abort running compilation. |
C-c p |
Prefix for the projectile command map. E.g. C-c p b. |
C-c o |
Prefix for Origami commands. |
C-c y |
Prefix for LSP commands. |
C-c C-f |
ClangFormat region. |
C-c c p |
Clang-Rename symbol at point. |
C-c c q |
Clang-Rename qualified identifier. |
One of the most reliable ways of fixing weird configuration states that I've
found is deleting ~/.emacs.d and ~/.emacs.elc and then starting and
restarting Emacs as described in the Installation section.
If that does not fix the issue and you can reliable reproduce it, please check
if there already is an issue (possibly closed) or discussion on the blog
post about what you're seeing. If
there isn't an issue, please feel free to file an issue or add a comment on the
blog post with steps to
reproduce.
This setup uses YouCompleteMe (ycm) for code completion in C++. clangd is also
supported via LSP-mode if one wants to use that instead. I have also included my
.ycm_extra_conf.py file that I use to preprocess compilation flags to deal
with things like precompiled headers that break YCM. It also sets up the default
flags for compilation. I've had to symlink the file into various project
directories because I haven't managed to get emacs-ycmd to tell ycm to load the
conf file from ~/.
The GNU package signature changed with Emacs 26.3, so Emacs 26.1 and 26.2 cannot authenticate the GNU package repo giving the following error:
Failed to verify signature archive-contents.sig:
No public key for 066DAFCB81E42C40 created at 2020-02-10T14:05:02-0800 using RSA
Command output:
gpg: Signature made Mon 10 Feb 2020 02:05:02 PM PST
gpg: using RSA key C433554766D3DDC64221BFAA066DAFCB81E42C40
gpg: Can't check signature: No public key
One simple workaround for this is to temporarily disable the archive signature checking by adding:
(setq package-check-signature nil)to your Emacs init file. Remember to remove or comment it out after you've done the core installation! Other options are discussed here.
Unless stated otherwise the code in this repository will be distributed under the Boost Software License v1. Third party code that I store here will have the copyright and license added to the beginning of the files.