Docs: about theme related variables

1 files changed, 16 insertions, 1 deletions

diff --git a/shoshin-config.org b/shoshin-config.org
index d762b3f..b91f6bd 100644
--- a/shoshin-config.org
+++ b/shoshin-config.org
@@ -606,15 +606,30 @@ add other hooks to ~lin-mode-hooks~
   (lin-global-mode)
 #+end_src
 ** Themes
+*** theme packages / installation
+
+to keep it concise, i'll define a special variable to hold the theme packages
+i'd like to install anytime this config is loaded on a system where they are
+not there. then i can ~mapc~ #'package-install over the list of themes.
 
 #+begin_src emacs-lisp
   (defvar my-themes-to-install
     '(alect-themes cyberpunk-theme dracula-theme nano-theme)
     "List of themes to install when loading shoshimacs config.")
   (mapc #'package-install my-themes-to-install)
+#+end_src
+
+*** chosen theme list and random loading on init
 
+i generally haven't used built-in themes much, but there's a few i like,
+and the ones i specifically install i'd like to keep in a list of "chosen"
+ones. i can load one at random if i please, and perhaps provide it as
+candidates to ~consult-themes~.
+
+#+begin_src emacs-lisp
   (defvar my-chosen-themes
-    '(cyberpunk dracula nano-dark nano-light tango tango-dark)
+    '(cyberpunk dracula modus-operandi modus-vivendi
+      nano-dark nano-light tango tango-dark)
     "List of themes I prefer for narrowing and random selection.")
   (load-theme (seq-random-elt my-chosen-themes))
 #+end_src