What is this

This is a literal programming for my own emacs configs and is an experimental emacs setup for my workflow. Furthermore, if I can, I will trying to make it flexible to be easily shaped for others people.

Installation

prerequisite

the following steps are specific for mac osx

some util tools

curl -Ls https://raw.githubusercontent.com/daipeihust/im-select/master/install_mac.sh | sh # install im-select
brew install ispell pngpaste ripgrep

install emacs-plus

brew install emacs-plus@30 --with-xwidgets --with-modern-papirus-icon

clone the repo

git clone https://github.com/sillygod/jemacs.git ~/.emacs.d

Then set up your personal configuration. Nothing machine-specific lives in a tracked file — there are two git-ignored hooks for it, and which one you want depends on when the value is needed:

cp example-personal_lp.org personal_lp.org   # loaded last; keys, keybindings, overrides
cp example-config.el       config.el         # loaded first; only values a module needs while loading

config.el is loaded from early-init, before straight.el and use-package exist, so it can hold plain setq / defvar only. personal_lp.org tangles to settings.el and is loaded at the end of init, where everything is available. example-personal_lp.org explains the split in detail, including which use-package keyword belongs where.

To produce the setup files of core, modules and your personal config:

bash lp.sh

Once you setup config completely, you can also produce those files by elisp function export-lp-configs

spawn the emacs

emacs # -debug-init is your friend helps you catch some errors

Run in docker

setup the XQuartz

https://gist.github.com/cschiewek/246a244ba23da8b9f0e7b11a68bf3285

then start xhost

xhost +localhost

pull docker image or you build it by your own.

docker pull ghcr.io/sillygod/jemacs/emacs:latest
docker run -it --rm --env="DISPLAY=docker.for.mac.host.internal:0" -v /tmp/.X11-unix:/tmp/.X11-unix -v [/your/workspace/]:[/mnt/workspace]ghcr.io/sillygod/jemacs/emacs

Misc

delete emacs packages’ cache

find . -type f -name "*.elc" -exec rm {} \;

Reference

dotfiles

• https://protesilaos.com/emacs/dotemacs (inspired)
• https://karthinks.com/

misc

• https://www.youtube.com/@SystemCrafters/streams (systemCrafter)
• https://github.com/p3r7/awesome-elisp
• a collection of emacs notes
• https://endlessparentheses.com/
• https://github.com/storvik/gomacro-mode (there are usages about emacs on ci)