README.md

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
• Makefile
• Python
• TOML
• YAML

Limitations

• Only dark theme is supported.
• The configuration is tested mostly on Mac OS and rarely on 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

• Cargo and Rust to compile lspce.

  brew install rust

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

  brew install coreutls

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

  brew install fd

Optional requirements

• Clangd for LSP in C++.
• Golangci-lint for linting in Golang.
• Gopls for LSP in Golang.
• Hunspell for spellchecking.
• Markdownlint for markdown linting.
• Pandoc for markdown preview.
• Poetry for virtual environment management in Python
• Pylsp for LSP in Python.

Recommended Pylsp setup

1. Install Pylsp with pipx:

pipx install python-lsp-server

1. Install memestra plugin:

pipx inject python-lsp-server pyls-memestra

1. Install rope plugin:

pipx inject python-lsp-server pylsp-rope

Recommended Pylsp per-project setup

((python-ts-mode
  (lspce-workspace-configuration .
      (:pylsp (:plugins (:jedi_completion (:include_params t :fuzzy t)
                         :jedi (:environment "/<path-to-project>/.venv/bin/python")
                         :flake8 (:enabled :json-false)
                         :rope_completion (:enabled :json-true)))))))

Installation

To install the project execute the following command:

make install