nix/docs/emacs.md

177 lines
3.8 KiB
Markdown

# Emacs Configuration
## Notes & Org
### Directory Structure
- `~/NPersonal/agenda.org` - All tasks (Inbox, Tasks, Meetings)
- `~/NPersonal/archive.org` - Completed/archived items
- `~/NPersonal/*.md` - Denote markdown notes
### agenda.org Structure
```org
* Inbox <- quick captures
* Tasks <- organized tasks
* Meetings <- meetings
```
### Org Agenda
| Key | Action |
|-----|--------|
| `C-c a` | Open agenda dispatcher |
| `C-c c` | Capture (quick note/todo) |
#### In Agenda View
| Key | Action |
|-----|--------|
| `n` / `p` | Next / previous item |
| `t` | Cycle TODO state |
| `RET` | Go to item |
| `q` | Quit agenda |
### Org Mode
| Key | Action |
|-----|--------|
| `C-c C-t` | Cycle TODO state |
| `C-c C-s` | Schedule |
| `C-c C-d` | Set deadline |
| `C-c C-w` | Refile to another file/heading |
| `C-c C-x C-a` | Archive subtree |
| `C-c l s` | Store link |
| `C-c l i` | Insert link |
### Capture Templates (`C-c c`)
| Key | Action |
|-----|--------|
| `c` | Quick capture to Inbox |
| `r` | Capture with reference |
| `t` | Task |
| `m` | Meeting |
| `e i` | Email to Inbox |
| `e t` | Email to Tasks |
| `e f` | Email follow-up with deadline |
### Denote (Markdown Notes)
Notes are saved as: `20241226T123456--title__keyword1_keyword2.md`
| Key | Action |
|-----|--------|
| `C-c n n` | Create new note |
| `C-c n f` | Find or create note |
| `C-c n i` | Insert link to note |
| `C-c n l` | Show backlinks |
| `C-c n r` | Rename file |
| `C-c n k` | Add keyword |
| `C-c n K` | Remove keyword |
| `C-c n b` | Backlinks for org heading |
| `C-c n h` | Link to org heading |
### Archive
Completed tasks go to `archive.org` under `* Archived` heading.
- `C-c C-x C-a` - Archive current subtree
- `C-c C-w` then select `archive.org` - Refile to archive
---
## Email (mu4e)
### Launch
| Key | Action |
|-----|--------|
| `C-c e` | Open mu4e |
### Main View
| Key | Action |
|-----|--------|
| `U` | Update mail (run mbsync) |
| `j` | Jump to maildir |
| `s` | Search |
| `b` | Bookmarks |
| `C` | Compose new message |
| `;` | Switch context (account) |
| `q` | Quit mu4e |
### Headers View (Message List)
| Key | Action |
|-----|--------|
| `n` / `p` | Next / previous message |
| `RET` | View message |
| `d` | Mark for trash |
| `D` | Mark for delete |
| `t` | Mark for action (prompts) |
| `u` | Unmark |
| `m` | Move to folder |
| `e` | Refile (archive) |
| `+` / `-` | Mark / unmark flag |
| `!` | Mark as read |
| `?` | Mark as unread |
| `r` | Reply |
| `R` | Reply all |
| `F` | Forward |
| `x` | Execute marked actions |
| `U` | Unmark all |
| `%` | Mark by pattern |
| `T` | Mark thread |
| `g` | Rerun search |
| `q` | Quit to main view |
### Message View
| Key | Action |
|-----|--------|
| `n` / `p` | Next / previous message |
| `SPC` / `DEL` | Scroll down / up |
| `r` | Reply |
| `R` | Reply all |
| `F` | Forward |
| `o` | Open attachment |
| `e` | Save attachment |
| `a` | View action (open in browser, etc.) |
| `#` | Toggle citation folding |
| `.` | Raw view |
| `h` | Toggle headers |
| `q` | Return to headers |
### Compose
| Key | Action |
|-----|--------|
| `C-c C-c` | Send message |
| `C-c C-k` | Kill (discard) message |
| `C-c C-d` | Save as draft |
| `C-c C-a` | Attach file |
| `C-c C-s` | GPG sign message |
| `C-c C-e` | GPG encrypt message |
### Bookmarks (from main view, press `b`)
| Key | Action |
|-----|--------|
| `u` | Unread messages |
| `t` | Today's messages |
| `w` | Last 7 days |
| `i` | UChicago Inbox |
| `p` | Personal Inbox |
### Search Tips
- `from:john` - messages from john
- `to:jane` - messages to jane
- `subject:meeting` - subject contains meeting
- `flag:unread` - unread messages
- `flag:attach` - messages with attachments
- `date:today..now` - today's messages
- `date:7d..now` - last 7 days
- `maildir:/uchicago/Inbox` - specific maildir
- `AND`, `OR`, `NOT` - boolean operators