diff --git a/README.org b/README.org index dde051c..8471948 100644 --- a/README.org +++ b/README.org @@ -28,7 +28,8 @@ Portable *GNU/Emacs*[fn:1] dotfiles. Built for Life, Liberty, and the Open Road. * Overview -These is my personal configuration(s) for *GNU/Linux*[fn:2], and *GNU/Emacs*[fn:1] software. It enables a consistent experience and computing environment across all of my machines. The entire experience is controlled with *GNU/Emacs*[fn:1], leveraging it's capabilities for *Literate Programming*[fn:3]. +These is my personal configuration(s) for *GNU/Linux*[fn:2], and *GNU/Emacs*[fn:1] software. It enables a consistent experience and computing environment across all of my machines. The entire experience is controlled with +*GNU/Emacs*[fn:1], leveraging it's capabilities for *Literate Programming*[fn:3]. * Footnotes diff --git a/elisp/options.el b/elisp/options.el index dfb999f..186d82a 100644 --- a/elisp/options.el +++ b/elisp/options.el @@ -19,7 +19,7 @@ capture projects development - interface + interface themes modeline dashboard) "All of the available modules.") diff --git a/modules/interface.org b/modules/interface.org index 6a22219..c4d4538 100644 --- a/modules/interface.org +++ b/modules/interface.org @@ -210,46 +210,15 @@ Gotta have those emojis, first class support for Emacs via the *Emacs-emojify*[f * Describe with =d= #+begin_src emacs-lisp -(dotfiles/leader - "f" '(:ignore t :which-key "Emojify") - "fl" '(emojify-list-emojis :which-key "List") - "fs" '(emojify-apropos-emoji :which-key "Search") - "fi" '(emojify-insert-emoji :which-key "Insert") - "fd" '(emojify-describe-emoji :which-key "Describe")) -#+end_src - -* Modern themes - -#+ATTR_ORG: :width 420px -#+ATTR_HTML: :width 420px -#+ATTR_LATEX: :width 420px -[[../docs/images/what-is-emacs-customizable.gif]] - -High quality and modern colour themes are provided in the *Doom Themes*[fn:9] package. - -#+begin_src emacs-lisp -(use-package doom-themes - :init (load-theme 'doom-moonlight t)) -#+end_src - -Load a theme with =SPC t t=. - -#+begin_src emacs-lisp -(dotfiles/leader - "tt" '(counsel-load-theme t t :which-key "Theme")) -#+end_src - -** Status bar - -*Doom modeline*[fn:10] provides an elegant and modern status bar / modeline. - -#+begin_src emacs-lisp -(use-package doom-modeline - :custom (doom-modeline-height 16) - :config (doom-modeline-mode 1)) +;; (dotfiles/leader +;; "f" '(:ignore t :which-key "Emojify") +;; "fl" '(emojify-list-emojis :which-key "List") +;; "fs" '(emojify-apropos-emoji :which-key "Search") +;; "fi" '(emojify-insert-emoji :which-key "Insert") +;; "fd" '(emojify-describe-emoji :which-key "Describe")) #+end_src -** Line numbering +* Line numbering Relative line numbers are important when using VI emulation keys. You can prefix commands with a number, allowing you to perform that action that number of times. Useful when navigating around pages that are hundreds, or even thousands of lines long. @@ -281,7 +250,7 @@ Toggle line numbers with =SPC t l=. "tl" '(linum-relative-global-mode :which-key "Lines")) #+end_src -** Parenthesis +* Parenthesis Colourize nested parenthesis with *Rainbow delimeters*[fn:11]. @@ -290,7 +259,7 @@ Colourize nested parenthesis with *Rainbow delimeters*[fn:11]. :hook (prog-mode . rainbow-delimiters-mode)) #+end_src -** Superstar +* Superstar Make headline stars *super* with *Org superstar mode*[fn:12]. diff --git a/modules/modeline.org b/modules/modeline.org new file mode 100644 index 0000000..bc81828 --- /dev/null +++ b/modules/modeline.org @@ -0,0 +1,19 @@ +#+TITLE: Modeline +#+AUTHOR: Christopher James Hayward +#+EMAIL: chris@chrishayward.xyz + +Extend the usability of the Emacs modeline. + +* Config + +Implement and elegant and modern status bar, fully customizable and compatible with our themes with the ~doom-modeline~[fn:1] package. + +#+begin_src emacs-lisp +(use-package doom-modeline + :custom (doom-modeline-height 16) + :config (doom-modeline-mode 1)) +#+end_src + +* Footnotes + +[fn:1] https://github.com/seagle0128/doom-modeline diff --git a/modules/themes.org b/modules/themes.org new file mode 100644 index 0000000..f7df5d0 --- /dev/null +++ b/modules/themes.org @@ -0,0 +1,46 @@ +#+TITLE: Themes +#+AUTHOR: Christopher James Hayward +#+EMAIL: chris@chrishayward.xyz + +#+PROPERTY: header-args:emacs-lisp :tangle themes.el :comments org +#+PROPERTY: header-args:shell :tangle no +#+PROPERTY: header-args :results silent :eval no-export :comments org + +#+OPTIONS: num:nil toc:nil todo:nil tasks:nil tags:nil +#+OPTIONS: skip:nil author:nil email:nil creator:nil timestamp:nil + +Configure a unified look and feel across the system with modern themes. + +* Setup + +Easily swap between system themes using the ~lxappearance~[fn:1] tool. I tend to default to the ~arc-theme~[fn:2] as it looks really good with most themes. + +#+begin_src shell +RUN apt install -y lxappearance +#+end_src + +* Config + +High quality and modern colour themes are provides inside of Emacs via the ~doom-themes~[fn:3] package. Some of the themes can be further configured, see the documentation for more details. + +#+begin_src emacs-lisp +(use-package doom-themes + :init (load-theme 'doom-modeline t)) +#+end_src + +* Shortcuts + +Create a custom keybinding for loading a theme with =SPC t t=: + +#+begin_src emacs-lisp +(dotfiles/leader + "tt" '(counsel-load-theme t t :which-key "Theme")) +#+end_src + +* Footnotes + +[fn:1] https://packages.debian.org/sid/lxappearance + +[fn:2] https://packages.debian.org/sid/arc-theme + +[fn:3] https://github.com/hlissner/emacs-doom-themes