Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/anegg0/mydoomconfig

My Doom Emacs Config
https://github.com/anegg0/mydoomconfig

doom-emacs linear-emacs org-roam technical-writing

Last synced: 5 days ago
JSON representation

My Doom Emacs Config

Awesome Lists containing this project

README 

          
# This is my Doom Emacs Config



I customized this config mostly around Software Technical Writing, which is my day job. 

If you like to work with Vim and Orgmode, you might find elements to work with.



Note that it integrates with:

- Linear.app (you will need to clone https://github.com/anegg0/linear-emacs for that feature to be available)

- Jethro Kuan's fabulous https://github.com/org-roam/org-roam

- Alvaro Ramirez's perfect solution for accentuated characters on Emacs/MacOS: https://xenodium.com/an-accentuated-emacs-experiment/ 



## Key Features

- **Enhanced Org-mode**: Org-roam integration, custom export templates, Linear.app synchronization

- **Development Tools**: LSP support (Eglot), Copilot integration, syntax highlighting for multiple languages

- **UI/UX**: Leuven-dark theme, Vertico completion, visual enhancements with Treemacs

- **Productivity**: GTD workflows, custom keybindings, Emacs Everywhere for system-wide editing



## Core Modules



### Completion & UI

- Corfu with orderless for code completion

- Vertico for minibuffer completion

- Doom modeline with icons

- Treemacs for project navigation



### Languages & Tools

- Emacs Lisp, JavaScript, Python, Rust, Solidity

- LaTeX with custom templates

- Markdown/MDX support

- Magit for Git integration



### Org Ecosystem

- Org-roam for knowledge management

- Custom capture templates

- Linear.app two-way sync

- HTML/PDF export configurations



## Notable Packages



- `copilot`: GitHub Copilot integration

- `claudemacs`: Claude AI integration

- `linear-emacs`: Linear issue tracking

- `eat`: Terminal emulator

- `evil`: Vim emulation



## Configuration Files



- `init.el`: Module declarations and feature toggles

- `config.el`: Main configuration with keybindings and settings

- `packages.el`: Package declarations and custom recipes



## Custom Configuration Details



### EDITOR

- **French Accent Support**: Integrated `accent` package with custom configuration for French diacritics (à, â, é, è, ê, ë, î, ï, ô, ù, û, ü, ç). **Disabled by default** - must be manually enabled.

  - **Usage**: When enabled, double-tap keys quickly (within 0.17s) to insert accented characters

  - **Toggle Commands**:

    - `SPC t a`: Toggle accent menu globally (all text/org/markdown buffers)

    - `SPC t A`: Toggle accent menu for current buffer only

  - **Example**: Type "ee" quickly → menu appears with (é è ê ë) options

  - Includes org-mode cache fix to prevent conflicts

  - Special thank you to Alvaro Ramirez from xenodium.com!

- **Project-wide Search**: Custom `my/smart-project-occur` function for efficient regex searches across project files using projectile

- **Eglot Modeline**: Custom status indicator `+modeline-eglot-status` showing LSP connection state

- **Enhanced Undo Limits**: Increased to 64MB/96MB/960MB for handling large operations

- **Copilot Chat**: Extended configuration with leader key shortcuts for code review, documentation, and fixes



**Custom Functions:**

- `my/smart-project-occur`: Project-wide occur search with file filtering

- `my/toggle-accent-menu-global`: Toggle accent menu in all supported buffers

- `my/toggle-accent-menu-buffer`: Toggle accent menu in current buffer only

- `my/drag-n-drop-handler`: Handle files dropped onto Emacs frame

- `my/eat-popup`: Open eat terminal in popup window

- `my/setup-custom-font-fallbacks-mac`: Configure font fallbacks for symbols and emojis on macOS



### ORGMODE

- **Custom TODO States**: Extended workflow states (IN-PROGRESS, IN-REVIEW, BACKLOG, BLOCKED, NEXT, HOLD, WAITING-ON) with color-coded faces

- **Letter-style LaTeX Class**: Custom document class with modified title handling, removes default title page for clean letter format

- **Visible-only Markdown Export**: `my/org-md-export-to-markdown-visible-only` exports only visible content, removes anchor tags and TOC

- **HTML Hot-reload**: `my/org-hot-reload-toggle` enables auto-export on save with live browser preview

- **Custom Export Functions**: `my/org-export-pdf-and-open` and `my/org-export-html-and-open` with leader key bindings

- **Jethro's GTD Capture**: Inbox and slipbox templates with quick capture keybindings (C-c TAB, C-c SPC)

- **ProtonDrive Integration**: Org directory configured to sync with ProtonDrive cloud storage



**Custom Functions:**

- `my/org-md-export-to-markdown-visible-only`: Export visible content to markdown, remove anchor tags and TOC

- `my/org-hot-reload-html-export`: Enable hot-reload for HTML export

- `my/org-hot-reload-toggle`: Toggle HTML auto-export on save

- `my/org-export-html-and-open`: Export to HTML and open in browser (SPC 7)

- `my/org-export-pdf-and-open`: Export to PDF and open viewer (SPC e p)

- `my/org-todo-list-all-by-tag`: Display all TODO states filtered by tag

- `my/auto-save-org-files-on-todo-change`: Auto-save linear.org and inbox.org on TODO changes



### ORGROAM

- **ProtonDrive Sync**: Database and notes stored in cloud-synced ProtonDrive folder

- **Custom Capture Templates**: 

  - Quote notes with :quote: filetag

  - CATB project notes in dedicated folder

  - OCL documentation with OCL_ prefix

  - Prompts with twai_ prefix

  - Hugo-compatible article template with export settings

- **Tag-based Node Finder**: `my/org-roam-node-find-by-tag` function with leader key binding (SPC r F)

- **Missing ID Scanner**: `my/org-roam-find-files-without-id` generates report of org files without roam IDs

- **Enhanced Node Display**: Shows node type (directory) and tags in completion interface



**Custom Functions:**

- `my/org-roam-node-has-tag`: Filter function to check if node has specified tag

- `my/org-roam-node-find-by-tag`: Find and open nodes based on tag (SPC r F)

- `my/org-roam-find-files-without-id`: Generate report of org files missing roam IDs (SPC r m)



### LINEAR

- **Auth-source API Storage**: `my/linear-load-api-key-from-auth-source` loads API key securely from .authinfo

- **Single-issue Sync**: `my/linear-sync-single-issue-at-point` updates only the changed issue to minimize API calls

- **Toggle Auto-sync**: `my/toggle-linear-auto-sync` controls whether Linear updates before todo list display

- **Auto-save on State Change**: Hooks automatically save linear.org and inbox.org when TODO states change

- **Custom Leader Keys**: 

  - SPC l s: Sync all Linear issues

  - SPC l t: Toggle auto-sync

  - SPC l n: Create new issue

  - SPC l c: Test connection

  - SPC l d: Toggle debug mode



**Custom Functions:**

- `my/linear-load-api-key-from-auth-source`: Load Linear API key from auth-source

- `my/linear-sync-single-issue-at-point`: Sync only current issue to Linear API

- `my/toggle-linear-auto-sync`: Toggle automatic Linear sync before todo list

- `my/run-linear-emacs-list-issues-before-todo`: Run Linear sync before org-todo-list

- `my/enable-linear-org-sync`: Auto-enable sync when linear.org is opened

- `my/auto-save-org-files-on-todo-change`: Auto-save linear.org and inbox.org on TODO state changes

- `my/magit-submodule-update-init-recursive`: Run git submodule update (SPC 6)

- `my/magit-checkout-advice`: Invalidate projectile cache after git checkout