• Curated defaults and “sane” settings, rather than fight generic GNU defaults and learn simultaneously.
  • Corfu Text completion back-end (pop-down for spelling, etc)
  • Magit Amazing Git integration for Emacs. Worthy of its own tutorial…
  • Projectile
  • Which Key Your gateway to finding the shortcuts you can never remember. “Level II C-h”
  • Treemacs
  • Flycheck Needs to be enabled in init.el, then run doom sync.
  • Many themes
  • Evil Mode
• Install packages directly from GitHub (if desired)

• emulation Vim (Extensible VI Layer)

  As a Linux guru and Systems Engineer, I highly recommend learning vi anyway, since it’s the de-facto standard on every server implementation of Linux. You can count on Vi being present on the machine.

• LSP integration
• doom doctor assists with possible configuration issues
• Designed with repeatability in mind (i.e. backup to your own Git repo)

“Learn how to help yourself.”

“Self-documenting means that at any time you can use special commands, known as help commands, to find out what your options are, or to find out what any command does, or to find all the commands that pertain to a given topic.”

• Emacs Docs

FAIR DISCLAIMER: you’ll spend several days/weeks learning to navigate and remember where things are by using C-h… As you use it, you’ll learn where the things you use and depend on are. (I don’t think anyone knows it all…) This underscores the importance of first learning where to find what you need. Remembering it will come automatically in time.

Also… <SPC> h-b-b to discover all the current bindings (for wherever you are)

Unfortunately, the default terminal(s) that Emacs and Doom ship with are awful. Fix that right away…

And in your Doom Emacs init.el file:

;;init.el

:term
;;eshell            ; the elisp shell that works everywhere
;;shell             ; simple shell REPL for Emacs
;;term              ; basic terminal emulator for Emacs
vterm             ; the best terminal emulation in Emacs

While you’re here, you might also enable additional language support, which Doom makes easy…

sudo apt install libvterm libvterm-dev libtool

• Doom Emacs Tips - yusbk@GitHub
• Mastering Emacs- Mastering Emacs (PDF Book)
• Avoiding Emacs Pinky
• Conquering Kubernetes with Emacs + Org Mode
• Writing a Book in Org Mode

I was asked to use large text and not use dark backgrounds when presenting, because of smartphones. What a great example for a practical elisp example…

How do we do this? I have no example, but luckily, emacs is self-documenting…

<SPC> h t shows that consult-theme is responsible for changing THEME… Ok…

;; Cool, so that wasn't bad...
(consult-theme 'doom-flatwhite)

How is this done? Well, I know the scroll wheel enlarges text Let’s find out how to automate that… <SPC> h k <CTRL> <Scroll> Signature

---

(mouse-wheel-text-scale EVENT)

Documentation Adjust font size of the default face according to EVENT.

See also text-scale-adjust.

This wasn’t that helpful

---

<SPC> : “text…”

Ah, text-scale-set <– Let’s fiddle with this…

<SPC> ; (text-scale-set 5) <– HERE WE ARE…

Let’s put it into some elisp code…

(text-scale-set 4)

However… We’ll see that switching to a different buffer has old text the same default size. Hm…

<SPC> : big-font…

— Documentation Globally resizes your fonts for streams, screen-sharing or presentations.

Uses doom-big-font if its set, otherwise uses doom-font (falling back to your system font).

Also resizees doom-variable-pitch-font and doom-serif-font.

This is a global minor mode. If called interactively, toggle the Doom-BIG-Font mode mode. If the prefix argument is positive, enable the mode, and if it is zero or negative, disable the mode.

If called from Lisp, toggle the mode if ARG is toggle. Enable the mode if ARG is nil, omitted, or is a positive number. Disable the mode if ARG is a negative number. —

This looks better… Let’s see how it works… <SPC> h f doom-big-font-mode Reveals that it seems to operate based on doom-adjust-font-size… So, we can set that…

(doom-adjust-font-size 5)

;; This gets us back to square one...
(doom/reset-font-size)

(defun +presentation-mode (&optional arg)
  "Custom function to ready Emacs for presenting. Enables if ARG is non-nil, else disables."
  (if arg
      (progn
        (message "Enabling presentation mode!")
        (consult-theme 'doom-flatwhite)
        (doom-adjust-font-size 4))
    (progn
      (message "Disabling presentation mode!")
      (doom/reset-font-size)
      (consult-theme 'doom-one))))

And, we can try calling it: <SPC> ; "(+presentation-mode t)"

Basic functionality achieved…

Maybe there are some other things we’d like to have it do, i.e. clean up our == ~~ ** __ stuff… with org-pretty-mode?

(defun +presentation-mode (&optional arg)
  "Custom function to ready Emacs for presenting. Enables if ARG is non-nil, else disables."
  (if arg
      (progn
        (message "Enabling presentation mode!")
        (consult-theme 'doom-flatwhite)  ;;Load a more readable theme
        (doom-adjust-font-size 4) ;; Adjust font size for smartphones
        (+org-pretty-mode) ;; Formatting niceities
        (org-indent-mode -1))
    (progn
      (message "Disabling presentation mode!")
      (doom/reset-font-size)
      (consult-theme 'doom-one)
      (+org-pretty-mode -1)
      (org-indent-mode))
      )))

• In an nutshell

  Org mode is here to help you realize the power of plaintext in document creation. It’s a different philosophy that emphasizes storing your document’s content not as encoded information in a proprietary format, such as .docx, .pdf, Google Sheets, etc, but as simple text in a file.

  It’s similar to, but also distinct from Markdown (although most of its features, Git(Hub) recognizes and works with). Org content is more dynamic and integrates well with other Emacs features (agendas, timestamping, etc), and is more of a living document than Markdown (which is basically static).

  Org mode has excellent exporting abilities, HTML, TeX, PDF, and others (extensible with ox framework)

• Official Quickstart Guide
• Emacs major mode
  • Notes
  • Documents
  • Literate programming & computational notebooks
  • To-do lists
  • Project Planning
• GTD Guide

• Worg - Inspiration for using…

  The trouble seems to be finding effective ways to use it. Suffice it to say, Org is useful from everything from task management to coding and publishing… Decide on your use case for it and focus your efforts there. Patience…

• Mobile Compatibility

  There are varrious tools to extend Org mode to Android and IOS, and to narrow it to a particular use case, if defaults are too broad for your liking.

• Definition: “The practice of using multiple programming languages in a single project, system, or file, for the purpose of leveraging the strengths of each language for different tasks. This technique leverages the strengths of multiple programming languages and often yields greater efficiency in solving complex problems.”
• Live example

Setting up Babel correctly takes some tweaking… First, head over to your init.el file and tune that for the languages and things you plan to use:

;;init.el
;;Filtered for relevance...
:lang
...
emacs-lisp        ; drown in parentheses
ess               ; emacs speaks statistics
markdown          ; writing docs for people to ignore
nix               ; I hereby declare "nix geht mehr!"
org               ; organize your plain life in plain text
python            ; beautiful is better than ugly
sh                ; she sells {ba,z,fi}sh shells on the C xor
...

Check out this handy guide for way more in-depth examples.