From 016c36fac81d6e456a0d1bd227e6706d242c4717 Mon Sep 17 00:00:00 2001 From: James Cherti <60946298+jamescherti@users.noreply.github.com> Date: Thu, 6 Mar 2025 19:42:26 -0500 Subject: [PATCH] Update README.md --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/README.md b/README.md index 2eea4a5..d377d6d 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,7 @@ The author uses *minimal-emacs.d* as his `early-init.el` and `init.el`, alongsid - [Code completion with corfu](#code-completion-with-corfu) - [Configuring Vertico, Consult, and Embark](#configuring-vertico-consult-and-embark) - [Code folding](#code-folding) + - [Changing the default theme](#changing-the-default-theme) - [Configuring vterm](#configuring-vterm) - [Configuring Vim keybindings using Evil?](#configuring-vim-keybindings-using-evil) - [Configuring LSP Servers with Eglot (built-in)](#configuring-lsp-servers-with-eglot-built-in) @@ -447,6 +448,48 @@ In addition to code folding, *outline-indent* also allows: moving indented block ![](https://raw.githubusercontent.com/jamescherti/outline-indent.el/main/.screenshot2.png) +### Changing the default theme + +For instance, to switch to a darker theme, add the following to the `~/.emacs.d/post-init.el` file: + +```emacs-lisp +(mapc #'disable-theme custom-enabled-themes) ; Disable all active themes +(load-theme 'tango-dark t) ; Load the built-in tango-dark theme +``` + +Emacs includes several built-in themes that you can use without installing additional packages: + +- `tango-dark`: Face colors using the Tango palette (dark background). +- `tango`: Face colors using the Tango palette (light background). +- `modus-operandi` +- `modus-operandi-deuteranopia` +- `modus-operandi-tinted` +- `modus-operandi-tritanopia` +- `modus-vivendi` +- `modus-vivendi-deuteranopia` +- `modus-vivendi-tinted` +- `modus-vivendi-tritanopia` +- `tsdh-dark`: A dark theme used and created by Tassilo Horn. +- `tsdh-light`: A light Emacs theme. +- `adwaita`: Face colors similar to the default theme of Gnome 3 (Adwaita). +- `deeper-blue`: Face colors using a deep blue background. +- `dichromacy`: Face colors suitable for red/green color-blind users. +- `leuven-dark`: Face colors with a dark background. +- `leuven`: Face colors with a light background. +- `light-blue`: Face colors utilizing a light blue background. +- `manoj-dark`: Very high contrast faces with a black background. +- `misterioso`: Predominantly blue/cyan faces on a dark cyan background. +- `wheatgrass`: High-contrast green/blue/brown faces on a black background. +- `whiteboard`: Face colors similar to markers on a whiteboard. +- `wombat`: Medium-contrast faces with a dark gray background. + +(To experiment with different themes, use `M-x customize-themes`.) + +If you're interested in exploring third-party Emacs themes, consider the following: +- `ef-themes` (available on MELPA): A collection of light and dark themes for GNU Emacs, designed to offer colorful yet highly legible options. They are aimed at users seeking something with more visual flair compared to the more minimalist *modus-themes*. +- `doom-themes` (available on MELPA): An extensive collection of high-quality, visually appealing themes for Emacs, designed to offer a sleek and modern aesthetic, while drawing inspiration from popular community themes. +- `tomorrow-night-deepblue-theme` (available on MELPA): A beautiful deep blue variant of the Tomorrow Night theme, which is renowned for its elegant color palette. It features a deep blue background color that creates a calming atmosphere. This theme is a great choice for those who miss the blue themes that were trendy a few years ago. (The theme was inspired by classic text editors such as QuickBASIC, RHIDE, and Turbo Pascal, as well as tools such as Midnight Commander.) + ### Configuring vterm The `emacs-libvterm` package is a terminal emulator integrated into GNU Emacs. Built on libvterm, a C library, it offers superior performance compared to Elisp-based alternatives. This compiled code approach enables `emacs-libvterm` to handle large outputs efficiently, providing a fast and feature-complete terminal experience within Emacs. @@ -457,6 +500,10 @@ To configure `emacs-vterm`, add the following to `~/.emacs.d/post-init.el`: :ensure t :defer t :commands vterm + :custom + ;; Important: Ensure the following dependencies are installed: + ;; A 'C' compiler, cmake, libtool-bin, and libvterm + (vterm-always-compile-module t) ; Auto-compile libvterm :config ;; Speed up vterm (setq vterm-timer-delay 0.01))