GNU Emacs / N Λ N O (developers edition)

GNU Emacs / N Λ N O (developers edition) is a set of configuration files for GNU Emacs based on nano-emacs such as to provide a nice and consistent look and feel for developers. The dark theme is based on Nord colors.

The philosophy of nano-emacs is to stick as much as possible to vanilla Emacs without introducing too much dependencies (or none if possible) and to keep it modular enough. The idea is for users to copy the part they are interested in such as to include them in their own configuration.

Supported programming languages and formats

• Bash
• C++
• Elisp
• Golang
• JSON
• LaTeX
• Lua
• Makefile
• Python
• Raku
• TOML
• YAML

Limitations

• Only dark theme is supported.
• The configuration is tested on Mac OS and Linux.

Mandatory requirements

• GNU Emacs >= 30 with enabled tree-sitter. In case of Mac OS, emacs-plus is strongly recommended, e.g.:

  brew tap d12frosted/emacs-plus
  brew install emacs-plus@30 \
    --with-imagemagick \
    --with-savchenkovaleriy-big-sur-icon \
    --with-xwidgets \
    --with-poll

• Additional fonts

  brew install \
    homebrew/cask/font-roboto \
    homebrew/cask/font-roboto-slab \
    homebrew/cask/font-jetbrains-mono \
    homebrew/cask/font-jetbrains-mono-nerd-font

• coreutls (Mac OS only) for better listing in Dired

  brew install coreutls

• The fd utility (to search files with consult):

  brew install fd

• The enchant library to check spelling with Jinx:

  On Mac OS:

  brew install enchant pkg-config

  On Linux:

  apt-get install libenchant-2-dev pkgconf

Optional requirements

• Clangd for LSP in C++.

• Golangci-lint for linting in Golang.

• Gopls for LSP in Golang.

• Hunspell for spellchecking.

• Jsonlint - to lint JSON files.

• Markdownlint for markdown linting.

• Pandoc for markdown preview.

• Poetry for vitual environment management in Python.

• Pyright for LSP in Python.

• LaTeX for formulas support in org mode, e.g.:

  brew install --cask mactex

• LuaCheck to lint Lua files.

Recommended Pyright setup

To provide automatic activation of virtual environments create pyrightconfig.json file in the root of your project with the following content:

{
  "venvPath": "<path-to-the-folder-containing-venv",
  "venv": "<name of the venv folder, e.g. .venv"
}

Common clipboard in Linux

To use common clipboard on Linux running under Wayland one needs to install xsel:

sudo apt-get install xsel

Installation

To install the project execute the following command:

make install