mirror of
https://github.com/ryan4yin/nix-config.git
synced 2026-05-20 13:36:51 +02:00
Ryan Yin
128 lines
4.7 KiB
Markdown
128 lines
4.7 KiB
Markdown
# Emacs Editor
|
||
|
||
- Framework: <https://github.com/doomemacs/doomemacs>
|
||
- key bindings:
|
||
- source code: <https://github.com/doomemacs/doomemacs/blob/master/modules/config/default/%2Bevil-bindings.el>
|
||
- docs: <https://github.com/doomemacs/doomemacs/blob/master/modules/editor/evil/README.org>
|
||
- module index: <https://github.com/doomemacs/doomemacs/blob/master/docs/modules.org>
|
||
- Chinese(rime) support: <https://github.com/DogLooksGood/emacs-rime>
|
||
- modal editing:
|
||
- <https://github.com/emacs-evil/evil>: evil mode, enabled by default in doom-emacs.
|
||
- <https://github.com/meow-edit/meow>
|
||
- LSP Client: <https://github.com/manateelazycat/lsp-bridge>
|
||
- Emacs Wiki: <https://www.emacswiki.org/emacs/SiteMap>
|
||
- Awesome Emacs: <https://github.com/emacs-tw/awesome-emacs#lsp-client>
|
||
|
||
Emacs daemon:
|
||
|
||
- <https://github.com/nix-community/home-manager/blob/master/modules/services/emacs.nix>
|
||
- <https://github.com/LnL7/nix-darwin/blob/1a41453cba42a3a1af2fff003be455ddbd75386c/modules/services/emacs.nix>
|
||
|
||
## Install or Update
|
||
|
||
After deploying this nix flake, run the following command to install or update emacs:
|
||
|
||
```bash
|
||
doom sync
|
||
```
|
||
|
||
when in doubt, run `doom sync`!
|
||
|
||
## Why emacs?
|
||
|
||
1. Explore the unknown, just for fun!
|
||
2. Better support for Lisp-like Languages.
|
||
3. Org Mode
|
||
|
||
## Terminal Related
|
||
|
||
zellij provides a more powerful and stable terminal experience, so here is zellij's terminal shortcuts I use frequently now:
|
||
|
||
| Action | Zellij's Shortcut |
|
||
| ------------------------- | ------------------ |
|
||
| Floating Terminal | `Ctrl + <p> + <w>` |
|
||
| Horizontal Split Terminal | `Ctrl + <p> + <d>` |
|
||
| Vertical Split Terminal | `Ctrl + <p> + <n>` |
|
||
| Open file tree sidebar | `SPC + o + p` |
|
||
| Exit | `M-x C-c` |
|
||
|
||
## Visual Modes
|
||
|
||
The same as neovim/vim:
|
||
|
||
| Action | Shortcut |
|
||
| ------------------------ | ---------------------------------------- |
|
||
| Toggle visual mode | `v` |
|
||
| Toggle visual block mode | `<Ctrl> + v` (select a block vertically) |
|
||
|
||
## Text Manipulation
|
||
|
||
- Add at the end of multiple lines: `:normal A<text>`
|
||
|
||
- Execublock: `:A<text>`
|
||
|
||
- visual block mode(ctrl + v)
|
||
- Append text at the end of each line in the selected block
|
||
- If position exceeds line end, neovim adds spaces automatically
|
||
|
||
- Delete the last char of multivle lines: `:normal $x`
|
||
|
||
- Execute `$x` on each line
|
||
- visual mode(v)
|
||
- `$` moves cursor to the end of line
|
||
- `x` deletes the character under the cursor
|
||
|
||
- Delete the last word of multiple lines: `:normal $bD`
|
||
- Execute `$bD` on each line
|
||
- visual mode(v)
|
||
- `$` moves cursor to the end of line
|
||
- `b` moves cursor to the beginning of the last word
|
||
- `D` deletes from cursor to the end of line
|
||
|
||
## Splitting and Buffers
|
||
|
||
| Action | Shortcut |
|
||
| ----------------------- | ----------------- |
|
||
| Next Buffer (Tab) | `]b` |
|
||
| Previous Buffer (Tab) | `[b` |
|
||
| Buffer List | `<Space> + ,` |
|
||
| Save all buffers(Tab) | `<Space> + b + S` |
|
||
| Kill the current buffer | `<Space> + b + k` |
|
||
| Kill all buffers | `<Space> + b + K` |
|
||
|
||
## Editing and Formatting
|
||
|
||
| Action | Shortcut |
|
||
| ---------------------------------------- | ------------------- |
|
||
| Format Document | `<Space> + cf` |
|
||
| Code Actions | `<Space> + ca` |
|
||
| Rename | `<Space> + cr` |
|
||
| Opening LSP symbols | `<Space> + cS` |
|
||
| Show all LSP Errors | `<Space> + c + x/X` |
|
||
| Jump to Definition | `gd` |
|
||
| Jump to References | `gD` |
|
||
| (Un)Comment the selected context | `gc` |
|
||
| (Un)Comment the current line | `gcc` |
|
||
| Open filepath/URL at cursor | `gf` |
|
||
| Find files by keyword in path | `<Space> + <Space>` |
|
||
| Grep string in files (vertico + ripgrep) | `<Space> + sd` |
|
||
|
||
## Text Manipulation
|
||
|
||
| Action | |
|
||
| ---------------------------------- | --- |
|
||
| Join Selection of Lines With Space | `J` |
|
||
|
||
## Search & replace
|
||
|
||
```bash
|
||
SPC s p foo C-; E C-c C-p :%s/foo/bar/g RET Z Z
|
||
```
|
||
|
||
1. `SPC s p`: search in project
|
||
1. `foo`: the keyword to search
|
||
1. `C-; E`: exports what you’re looking at into a new buffer in grep-mode
|
||
1. `C-c C-p` to run wgrep-change-to-wgrep-mode to make the search results writable.
|
||
1. `:%s/foo/bar/g RET`: replace in the current buffer(just like neovim/vim)
|
||
1. `Z Z`: to write all the changes to their respective files
|