Add: readme html version for cgit

author: shoshin <shoshin@cicadas.surf> 2022-07-03 21:12:57 -0500
committer: shoshin <shoshin@cicadas.surf> 2022-07-03 21:12:57 -0500
commit: 7f36c9af0cda383a04a2f53bfb9eb7cf65cdae22 (patch)
tree: 745446b9524222ac981f969b8bc03fcdbaeecc3b /README.html
parent: 04c31d084627639068a481f1807ae1505e496cde (diff)
1 files changed, 1214 insertions, 0 deletions
diff --git a/README.html b/README.html
new file mode 100644
index 0000000..403c6e1
--- /dev/null
+++ b/README.html
@@ -0,0 +1,1214 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+<!-- 2022-07-03 Sun 21:12 -->
+<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>&lrm;</title>
+<meta name="generator" content="Org Mode" />
+<style>
+  #content { max-width: 60em; margin: auto; }
+  .title  { text-align: center;
+             margin-bottom: .2em; }
+  .subtitle { text-align: center;
+              font-size: medium;
+              font-weight: bold;
+              margin-top:0; }
+  .todo   { font-family: monospace; color: red; }
+  .done   { font-family: monospace; color: green; }
+  .priority { font-family: monospace; color: orange; }
+  .tag    { background-color: #eee; font-family: monospace;
+            padding: 2px; font-size: 80%; font-weight: normal; }
+  .timestamp { color: #bebebe; }
+  .timestamp-kwd { color: #5f9ea0; }
+  .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
+  .org-left   { margin-left: 0px;  margin-right: auto; text-align: left; }
+  .org-center { margin-left: auto; margin-right: auto; text-align: center; }
+  .underline { text-decoration: underline; }
+  #postamble p, #preamble p { font-size: 90%; margin: .2em; }
+  p.verse { margin-left: 3%; }
+  pre {
+    border: 1px solid #e6e6e6;
+    border-radius: 3px;
+    background-color: #f2f2f2;
+    padding: 8pt;
+    font-family: monospace;
+    overflow: auto;
+    margin: 1.2em;
+  }
+  pre.src {
+    position: relative;
+    overflow: auto;
+  }
+  pre.src:before {
+    display: none;
+    position: absolute;
+    top: -8px;
+    right: 12px;
+    padding: 3px;
+    color: #555;
+    background-color: #f2f2f299;
+  }
+  pre.src:hover:before { display: inline; margin-top: 14px;}
+  /* Languages per Org manual */
+  pre.src-asymptote:before { content: 'Asymptote'; }
+  pre.src-awk:before { content: 'Awk'; }
+  pre.src-authinfo::before { content: 'Authinfo'; }
+  pre.src-C:before { content: 'C'; }
+  /* pre.src-C++ doesn't work in CSS */
+  pre.src-clojure:before { content: 'Clojure'; }
+  pre.src-css:before { content: 'CSS'; }
+  pre.src-D:before { content: 'D'; }
+  pre.src-ditaa:before { content: 'ditaa'; }
+  pre.src-dot:before { content: 'Graphviz'; }
+  pre.src-calc:before { content: 'Emacs Calc'; }
+  pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
+  pre.src-fortran:before { content: 'Fortran'; }
+  pre.src-gnuplot:before { content: 'gnuplot'; }
+  pre.src-haskell:before { content: 'Haskell'; }
+  pre.src-hledger:before { content: 'hledger'; }
+  pre.src-java:before { content: 'Java'; }
+  pre.src-js:before { content: 'Javascript'; }
+  pre.src-latex:before { content: 'LaTeX'; }
+  pre.src-ledger:before { content: 'Ledger'; }
+  pre.src-lisp:before { content: 'Lisp'; }
+  pre.src-lilypond:before { content: 'Lilypond'; }
+  pre.src-lua:before { content: 'Lua'; }
+  pre.src-matlab:before { content: 'MATLAB'; }
+  pre.src-mscgen:before { content: 'Mscgen'; }
+  pre.src-ocaml:before { content: 'Objective Caml'; }
+  pre.src-octave:before { content: 'Octave'; }
+  pre.src-org:before { content: 'Org mode'; }
+  pre.src-oz:before { content: 'OZ'; }
+  pre.src-plantuml:before { content: 'Plantuml'; }
+  pre.src-processing:before { content: 'Processing.js'; }
+  pre.src-python:before { content: 'Python'; }
+  pre.src-R:before { content: 'R'; }
+  pre.src-ruby:before { content: 'Ruby'; }
+  pre.src-sass:before { content: 'Sass'; }
+  pre.src-scheme:before { content: 'Scheme'; }
+  pre.src-screen:before { content: 'Gnu Screen'; }
+  pre.src-sed:before { content: 'Sed'; }
+  pre.src-sh:before { content: 'shell'; }
+  pre.src-sql:before { content: 'SQL'; }
+  pre.src-sqlite:before { content: 'SQLite'; }
+  /* additional languages in org.el's org-babel-load-languages alist */
+  pre.src-forth:before { content: 'Forth'; }
+  pre.src-io:before { content: 'IO'; }
+  pre.src-J:before { content: 'J'; }
+  pre.src-makefile:before { content: 'Makefile'; }
+  pre.src-maxima:before { content: 'Maxima'; }
+  pre.src-perl:before { content: 'Perl'; }
+  pre.src-picolisp:before { content: 'Pico Lisp'; }
+  pre.src-scala:before { content: 'Scala'; }
+  pre.src-shell:before { content: 'Shell Script'; }
+  pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
+  /* additional language identifiers per "defun org-babel-execute"
+       in ob-*.el */
+  pre.src-cpp:before  { content: 'C++'; }
+  pre.src-abc:before  { content: 'ABC'; }
+  pre.src-coq:before  { content: 'Coq'; }
+  pre.src-groovy:before  { content: 'Groovy'; }
+  /* additional language identifiers from org-babel-shell-names in
+     ob-shell.el: ob-shell is the only babel language using a lambda to put
+     the execution function name together. */
+  pre.src-bash:before  { content: 'bash'; }
+  pre.src-csh:before  { content: 'csh'; }
+  pre.src-ash:before  { content: 'ash'; }
+  pre.src-dash:before  { content: 'dash'; }
+  pre.src-ksh:before  { content: 'ksh'; }
+  pre.src-mksh:before  { content: 'mksh'; }
+  pre.src-posh:before  { content: 'posh'; }
+  /* Additional Emacs modes also supported by the LaTeX listings package */
+  pre.src-ada:before { content: 'Ada'; }
+  pre.src-asm:before { content: 'Assembler'; }
+  pre.src-caml:before { content: 'Caml'; }
+  pre.src-delphi:before { content: 'Delphi'; }
+  pre.src-html:before { content: 'HTML'; }
+  pre.src-idl:before { content: 'IDL'; }
+  pre.src-mercury:before { content: 'Mercury'; }
+  pre.src-metapost:before { content: 'MetaPost'; }
+  pre.src-modula-2:before { content: 'Modula-2'; }
+  pre.src-pascal:before { content: 'Pascal'; }
+  pre.src-ps:before { content: 'PostScript'; }
+  pre.src-prolog:before { content: 'Prolog'; }
+  pre.src-simula:before { content: 'Simula'; }
+  pre.src-tcl:before { content: 'tcl'; }
+  pre.src-tex:before { content: 'TeX'; }
+  pre.src-plain-tex:before { content: 'Plain TeX'; }
+  pre.src-verilog:before { content: 'Verilog'; }
+  pre.src-vhdl:before { content: 'VHDL'; }
+  pre.src-xml:before { content: 'XML'; }
+  pre.src-nxml:before { content: 'XML'; }
+  /* add a generic configuration mode; LaTeX export needs an additional
+     (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
+  pre.src-conf:before { content: 'Configuration File'; }
+
+  table { border-collapse:collapse; }
+  caption.t-above { caption-side: top; }
+  caption.t-bottom { caption-side: bottom; }
+  td, th { vertical-align:top;  }
+  th.org-right  { text-align: center;  }
+  th.org-left   { text-align: center;   }
+  th.org-center { text-align: center; }
+  td.org-right  { text-align: right;  }
+  td.org-left   { text-align: left;   }
+  td.org-center { text-align: center; }
+  dt { font-weight: bold; }
+  .footpara { display: inline; }
+  .footdef  { margin-bottom: 1em; }
+  .figure { padding: 1em; }
+  .figure p { text-align: center; }
+  .equation-container {
+    display: table;
+    text-align: center;
+    width: 100%;
+  }
+  .equation {
+    vertical-align: middle;
+  }
+  .equation-label {
+    display: table-cell;
+    text-align: right;
+    vertical-align: middle;
+  }
+  .inlinetask {
+    padding: 10px;
+    border: 2px solid gray;
+    margin: 10px;
+    background: #ffffcc;
+  }
+  #org-div-home-and-up
+   { text-align: right; font-size: 70%; white-space: nowrap; }
+  textarea { overflow-x: auto; }
+  .linenr { font-size: smaller }
+  .code-highlighted { background-color: #ffff00; }
+  .org-info-js_info-navigation { border-style: none; }
+  #org-info-js_console-label
+    { font-size: 10px; font-weight: bold; white-space: nowrap; }
+  .org-info-js_search-highlight
+    { background-color: #ffff00; color: #000000; font-weight: bold; }
+  .org-svg { width: 90%; }
+</style>
+</head>
+<body>
+<div id="content" class="content">
+<div id="table-of-contents" role="doc-toc">
+<h2>Table of Contents</h2>
+<div id="text-table-of-contents" role="doc-toc">
+<ul>
+<li><a href="#orgdf5e4c2">1. A New Start</a>
+<ul>
+<li><a href="#org1b5827d">1.1. Overview</a></li>
+</ul>
+</li>
+<li><a href="#org2e40c73">2. Package Management</a>
+<ul>
+<li><a href="#org4ac5c97">2.1. ELPA and Non-GNU ELPA</a>
+<ul>
+<li><a href="#orged85165">2.1.1. Add non-gnu ELPA to Emacs &lt; 28</a></li>
+</ul>
+</li>
+<li><a href="#org2769506">2.2. Installing Packages</a></li>
+<li><a href="#org16d63c2">2.3. Packages not in the default repos</a></li>
+<li><a href="#org4215bb7">2.4. Emacs 28 native compilation</a></li>
+</ul>
+</li>
+<li><a href="#orgdeffb30">3. Keybinding</a>
+<ul>
+<li><a href="#org5621c19">3.1. xah-fly-keys</a></li>
+</ul>
+</li>
+<li><a href="#orgd7dd270">4. Completion</a>
+<ul>
+<li><a href="#org9b9dac8">4.1. Two kinds of completion</a></li>
+<li><a href="#orge1b4621">4.2. Emacs completion styles</a></li>
+<li><a href="#org5883ba7">4.3. consult - Consulting completing-read</a>
+<ul>
+<li><a href="#org64b8a2b">4.3.1. "Virtual Buffers"</a></li>
+<li><a href="#org403305c">4.3.2. consult keybindings</a></li>
+<li><a href="#org031cb06">4.3.3. consult-themes</a></li>
+<li><a href="#org7fbc5e7">4.3.4. <span class="todo TODO">TODO</span> consult-project-buffer</a></li>
+</ul>
+</li>
+<li><a href="#org7b55f29">4.4. embark</a></li>
+<li><a href="#org8e12307">4.5. marginalia</a></li>
+<li><a href="#orge6036f2">4.6. vertico</a>
+<ul>
+<li><a href="#orgba3f7f7">4.6.1. vertico-directory</a></li>
+</ul>
+</li>
+<li><a href="#org33ed736">4.7. corfu</a>
+<ul>
+<li><a href="#org3ebbe44">4.7.1. corfu-terminal enables in terminal interface</a></li>
+</ul>
+</li>
+<li><a href="#orge300cfc">4.8. which-key</a></li>
+</ul>
+</li>
+<li><a href="#org19750d2">5. Editing</a>
+<ul>
+<li><a href="#orgd49b424">5.1. electric pair mode</a></li>
+<li><a href="#orgf23fec9">5.2. markdown mode</a></li>
+<li><a href="#org709f02c">5.3. org mode</a>
+<ul>
+<li><a href="#orge7954c4">5.3.1. exporting</a></li>
+</ul>
+</li>
+<li><a href="#org4c2680d">5.4. recentf-mode</a></li>
+</ul>
+</li>
+<li><a href="#org6f22775">6. Programming</a>
+<ul>
+<li><a href="#org1a56e09">6.1. Languages</a>
+<ul>
+<li><a href="#orgea87347">6.1.1. Common Lisp</a></li>
+<li><a href="#org66f16ab">6.1.2. Javascript</a></li>
+<li><a href="#org9801164">6.1.3. Ruby</a></li>
+</ul>
+</li>
+<li><a href="#org3e1a4c8">6.2. Dev Docs</a></li>
+</ul>
+</li>
+<li><a href="#org7b5b481">7. Projects</a>
+<ul>
+<li><a href="#orgeb5a0f7">7.1. project.el</a></li>
+<li><a href="#org05ca46c">7.2. version control</a>
+<ul>
+<li><a href="#org7d03814">7.2.1. magit</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#org6d3c8fa">8. External Services</a>
+<ul>
+<li><a href="#orgd733e10">8.1. plz - http library</a></li>
+<li><a href="#org721adef">8.2. sourcehut</a></li>
+</ul>
+</li>
+<li><a href="#org7ba8dba">9. UI</a>
+<ul>
+<li><a href="#orgb0526ec">9.1. basic Emacs UI tweaks</a></li>
+<li><a href="#orga727260">9.2. darkroom - distraction free writing</a></li>
+<li><a href="#org99e1861">9.3. Fonts</a></li>
+<li><a href="#org033b480">9.4. Highlights</a>
+<ul>
+<li><a href="#org1aa916e">9.4.1. global-hl-mode</a></li>
+</ul>
+</li>
+<li><a href="#orgc642392">9.5. Themes</a></li>
+<li><a href="#orgb9e69a0">9.6. windresize</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+
+<div id="outline-container-orgdf5e4c2" class="outline-2">
+<h2 id="orgdf5e4c2"><span class="section-number-2">1.</span> A New Start</h2>
+<div class="outline-text-2" id="text-1">
+<p>
+To welcome in Emacs 28 I intend to re-aquaint myself with the application
+and its ecosystem. I've been perusing the packages available through the
+default ELPA and non-gnu ELPA repos and trying to put together the various
+things that I've grown accustomed to.
+</p>
+
+<p>
+However, with a beginner's mind, I've been trying to avoid going down the
+same old idiosyncratic paths. Courting a bit of discomfort in order to learn
+what newcomers might experience coming to Emacs in this current version.
+</p>
+</div>
+
+<div id="outline-container-org1b5827d" class="outline-3">
+<h3 id="org1b5827d"><span class="section-number-3">1.1.</span> Overview</h3>
+<div class="outline-text-3" id="text-1-1">
+<p>
+This document is a journal, manual, and a program at once. I'm no expert at
+writing a document like this. If you happen to be reading it, the journal
+nature may be confusing. Over time, the journal will be incorporated into the
+bits that are a manual, solidified knowledge gained through the experience.
+</p>
+
+<p>
+The program bits will be tangled into <a href="shoshin-config.el">shoshin-config.el</a>. As a program, it
+requires a certain structure from top to bottom. Here, the snippets may be
+scattered around. I'll attempt to have a system to keep them organized, but
+this is all an experiment.
+</p>
+
+<p>
+The following code block is the "table of contents" that determines what
+is tangled into the resulting elisp file:
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp"><span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">shoshimacs.el --- Beginner's Mind Config  -*- lexical-binding:t -*-</span>
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">Package Management</span>
+(<span style="color: #ff79c6; font-weight: bold;">when</span> (&lt; emacs-major-version 28)
+  (package-initialize)
+  (add-to-list 'package-archives '(<span style="color: #f1fa8c;">"nongnu"</span> . <span style="color: #f1fa8c;">"https://elpa.nongnu.org/nongnu/"</span>))
+  (package-refresh-contents))
+
+(<span style="color: #ff79c6; font-weight: bold;">when</span> (<span style="color: #ff79c6; font-weight: bold;">and</span> (functionp #'native-comp-available-p) (native-comp-available-p))
+  (<span style="color: #ff79c6; font-weight: bold;">setq</span> native-comp-always-compile t
+        package-native-compile t))
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">Major Keybinding</span>
+(package-install 'xah-fly-keys)
+(<span style="color: #ff79c6; font-weight: bold;">require</span> '<span style="color: #8be9fd;">xah-fly-keys</span>)
+(xah-fly-keys-set-layout <span style="color: #f1fa8c;">"qwerty"</span>)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> xah-fly-use-control-key nil
+      xah-fly-use-meta-key nil)
+(xah-fly-keys t)
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">Completion</span>
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> completion-styles '(flex basic partial-completion emacs22)
+      completion-cycle-threshold 3
+      tab-always-indent 'complete)
+
+(package-install 'consult)
+
+(global-set-key (kbd <span style="color: #f1fa8c;">"C-x b"</span>) #'consult-buffer)
+(define-key xah-fly-leader-key-map (kbd <span style="color: #f1fa8c;">"f"</span>) #'consult-buffer)
+(define-key xah-fly-command-map (kbd <span style="color: #f1fa8c;">"n"</span>) #'consult-line)
+
+(<span style="color: #ff79c6; font-weight: bold;">with-eval-after-load</span> 'consult
+  (<span style="color: #ff79c6; font-weight: bold;">consult-customize</span> consult-theme <span style="color: #ffb86c;">:preview-key</span> '(<span style="color: #ffb86c;">:debounce</span> 0.5 any)))
+
+(package-install 'embark)
+
+(package-install 'marginalia)
+(marginalia-mode)
+
+(package-install 'vertico)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> minibuffer-prompt-properties
+      '(read-only t cursor-intangible t face minibuffer-prompt))
+(add-hook 'minibuffer-setup-hook #'cursor-intangible-mode)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> read-extended-command-predicate
+      #'command-completion-default-include-p)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> enable-recursive-minibuffers t)
+(vertico-mode)
+
+(<span style="color: #ff79c6; font-weight: bold;">require</span> '<span style="color: #8be9fd;">vertico-directory</span>)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"RET"</span>) #'vertico-directory-enter)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"DEL"</span>) #'vertico-directory-delete-char)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"M-DEL"</span>) #'vertico-directory-delete-word)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"M-j"</span>) #'vertico-quick-insert)
+
+(package-install 'corfu)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> corfu-auto t
+      corfu-cycle t
+      corfu-quit-no-match t)
+(global-corfu-mode t)
+
+(package-install 'corfu-terminal)
+(<span style="color: #ff79c6; font-weight: bold;">unless</span> (display-graphic-p)
+    (corfu-terminal-mode +1))
+
+(package-install 'which-key)
+(which-key-mode)
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">Editing</span>
+(electric-pair-mode)
+
+(package-install 'markdown-mode)
+
+(package-install 'htmlize)
+
+(recentf-mode)
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">Programming</span>
+(package-install 'sly)
+
+(package-install 'json-mode)
+
+(package-install 'devdocs)
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">Projects</span>
+(package-install 'magit)
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">External Services</span>
+(package-install 'plz)
+
+(package-install 'srht)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> srht-username <span style="color: #f1fa8c;">"shoshin"</span>)
+
+<span style="color: #6272a4;">;;; </span><span style="color: #6272a4;">User Interface</span>
+(<span style="color: #ff79c6; font-weight: bold;">when</span> (display-graphic-p)
+  (scroll-bar-mode -1)
+  (fringe-mode '(8 . 0)))
+
+(tab-bar-mode t)
+(display-battery-mode t)
+
+(package-install 'darkroom)
+
+(set-frame-font <span style="color: #f1fa8c;">"Victor Mono"</span>)
+
+(global-hl-line-mode t)
+
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> my-chosen-themes
+      '(cyberpunk-theme dracula-theme))
+(mapc #'package-install my-chosen-themes)
+
+(package-install 'windresize)
+</pre>
+</div>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org2e40c73" class="outline-2">
+<h2 id="org2e40c73"><span class="section-number-2">2.</span> Package Management</h2>
+<div class="outline-text-2" id="text-2">
+<p>
+I've been using <a href="https://github.com/radian-software/straight.el#start-of-content">straight.el</a>
+as my package manager since 2019 when I moved away from Spacemacs as my
+main configuration for day-to-day work. While I definitely recommend it
+as a flexible yet minimal package manager, it is certainly more useful
+to experienced Emacs users.
+</p>
+
+<p>
+This configuration will stick to packages available through the built-in
+<code>package.el</code> system. As of Emacs 28, this is everything in the ELPA and
+non-gnu ELPA package repositories. 
+</p>
+</div>
+
+<div id="outline-container-org4ac5c97" class="outline-3">
+<h3 id="org4ac5c97"><span class="section-number-3">2.1.</span> ELPA and Non-GNU ELPA</h3>
+<div class="outline-text-3" id="text-2-1">
+<p>
+ELPA packages have their copyright assigned to the FSF, which is a requirement
+for any code to be included into Emacs itself. ELPA packages are thus the
+most likely to be merged into Emacs as a new feature. Some, like EMMS, are
+likely to continue as "add-on" optional features only some users may choose.
+</p>
+
+<p>
+Non-gnu ELPA is relatively new, and does not require copyright assignment
+to the FSF. Packages are added to both repositories through the emacs-devel
+mailing list and the maintainers there. It intends to extend the packages
+available to the base Emacs installation while providing a bridge to inclusion
+in ELPA or Emacs proper at some time in the future.
+</p>
+</div>
+
+<div id="outline-container-orged85165" class="outline-4">
+<h4 id="orged85165"><span class="section-number-4">2.1.1.</span> Add non-gnu ELPA to Emacs &lt; 28</h4>
+<div class="outline-text-4" id="text-2-1-1">
+<p>
+Emacs 28 is the first version to include non-gnu ELPA by default. Some
+distributions may not yet have it as an available package.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp" id="orge67d88c">(<span style="color: #ff79c6; font-weight: bold;">when</span> (&lt; emacs-major-version 28)
+  (package-initialize)
+  (add-to-list 'package-archives '(<span style="color: #f1fa8c;">"nongnu"</span> . <span style="color: #f1fa8c;">"https://elpa.nongnu.org/nongnu/"</span>))
+  (package-refresh-contents))
+</pre>
+</div>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org2769506" class="outline-3">
+<h3 id="org2769506"><span class="section-number-3">2.2.</span> Installing Packages</h3>
+<div class="outline-text-3" id="text-2-2">
+<p>
+<code>package.el</code> provides the <a href="package-install">package-install</a> command which can be used interactively
+or from Lisp code like this configuration. If a package is already installed,
+it won't try to install it again. When you install a package this way, Emacs will
+add its name to <a href="package-selected-packages">package-selected-packages</a>.
+</p>
+
+<p>
+You can also use <code>list-packages</code> to browse, install and upgrade packages as
+well.
+</p>
+</div>
+</div>
+
+<div id="outline-container-org16d63c2" class="outline-3">
+<h3 id="org16d63c2"><span class="section-number-3">2.3.</span> Packages not in the default repos</h3>
+<div class="outline-text-3" id="text-2-3">
+<p>
+Any elisp package that is in Emacs's <a href="load-path">load-path</a> can be <code>require</code>'d and used.
+<code>(add-to-list 'load-path (expand-file-name "some-package/" user-emacs-directory))</code>
+is an example of putting the directory <code>some-package/</code> into the load path.
+</p>
+</div>
+</div>
+
+<div id="outline-container-org4215bb7" class="outline-3">
+<h3 id="org4215bb7"><span class="section-number-3">2.4.</span> Emacs 28 native compilation</h3>
+<div class="outline-text-3" id="text-2-4">
+<p>
+<a href="https://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Native-Compilation">elisp#Native Compilation</a>
+</p>
+
+<p>
+This is a new feature in Emacs 28 that will compile all of the Elisp as native
+machine code, rather than byte-code, which can result in major performance boosts.
+Compilation will happen in the background and is logged to the
+<code>*Async-native-compile-log*</code> buffer if you are curious. Mostly you shouldn't
+have to worry about it, though you may see some compilation warnings at times.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(<span style="color: #ff79c6; font-weight: bold;">when</span> (<span style="color: #ff79c6; font-weight: bold;">and</span> (functionp #'native-comp-available-p) (native-comp-available-p))
+  (<span style="color: #ff79c6; font-weight: bold;">setq</span> native-comp-always-compile t
+        package-native-compile t))
+</pre>
+</div>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orgdeffb30" class="outline-2">
+<h2 id="orgdeffb30"><span class="section-number-2">3.</span> Keybinding</h2>
+<div class="outline-text-2" id="text-3">
+<p>
+Keybindings are the key to playing Emacs like an instrument. no matter
+what you choose, keep in mind that you can always bind keys to your
+most commonly used commands to make things convienient.
+</p>
+
+<p>
+I highly recommend creating a personal key map bound to a "leader key".
+You initiate it with the leader, and then bind following key sequences
+to commands you use. creating your own will make it easier to remember
+and keep organized.
+</p>
+</div>
+
+<div id="outline-container-org5621c19" class="outline-3">
+<h3 id="org5621c19"><span class="section-number-3">3.1.</span> xah-fly-keys</h3>
+<div class="outline-text-3" id="text-3-1">
+<p>
+This is what I adopted to combat RSI. my muscle memory is tied into it
+tightly right now. you may have other opinions about keybindings
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp" id="org6dcf623">(package-install 'xah-fly-keys)
+(<span style="color: #ff79c6; font-weight: bold;">require</span> '<span style="color: #8be9fd;">xah-fly-keys</span>)
+(xah-fly-keys-set-layout <span style="color: #f1fa8c;">"qwerty"</span>)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> xah-fly-use-control-key nil
+      xah-fly-use-meta-key nil)
+(xah-fly-keys t)
+</pre>
+</div>
+
+<p>
+i'm setting it up early in the config so that its keymaps are available
+to modify / integrate with other packages.
+</p>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orgd7dd270" class="outline-2">
+<h2 id="orgd7dd270"><span class="section-number-2">4.</span> Completion</h2>
+<div class="outline-text-2" id="text-4">
+<p>
+Completion is a huge part of my experience using Emacs. I have been on
+an evolving journey of from the basic type of terminal tab completion 
+to spaceship level UI implemented as almost a sub-application in Emacs.
+</p>
+
+<p>
+This configuration is aiming at using a new crop of completion enhancements
+that tie into Emacs's native completion API. This is a more modular approach
+that allows a sort of composition of extensions to completion behavior and
+its appearance in the user interface.
+</p>
+</div>
+
+<div id="outline-container-org9b9dac8" class="outline-3">
+<h3 id="org9b9dac8"><span class="section-number-3">4.1.</span> Two kinds of completion</h3>
+<div class="outline-text-3" id="text-4-1">
+<p>
+I want to point out that there are two distinct but similar features
+both grouped under the concept of "completion". The first is <b>Minibuffer</b>
+completion. Any time you use the minibuffer to enter commands or arguments,
+there is a completion system available to help you enter text there.
+The second is <b>Buffer</b> completion, offering candidates for text you are
+typing in any buffer. Code completion provided by a language server
+is one example. In vanilla Emacs, you get <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Symbol-Completion">Symbol Completion</a>
+for free, since Emacs itself is a running Lisp process with knowledge of
+all the defined symbols in the system.
+</p>
+
+<p>
+I've been confused by this in the past, because the features are so similar.
+However, completing text in an arbitrary buffer really depends on context,
+and it is much more complex than completing commands and arguments that are
+appropriate to a specific situation.
+</p>
+</div>
+</div>
+
+<div id="outline-container-orge1b4621" class="outline-3">
+<h3 id="orge1b4621"><span class="section-number-3">4.2.</span> Emacs completion styles</h3>
+<div class="outline-text-3" id="text-4-2">
+<p>
+Emacs has a quite sophisticated way of selecting candidates for completion.
+You can read about them here: <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Completion-Styles">emacs#Completion Styles</a>
+</p>
+
+<p>
+I've grown used to the <code>flex</code> style of completion where typing
+<code>pr/s/sho.o</code> at the find file prompt expands to
+<code>projects/shoshimacs/shoshin-config.org</code>. There are other alternatives
+and you can even write your own. The <code>completion-styles</code> is a list of
+all the styles you'd like to use. It starts at the front, and if no matches
+are found, moves to the next style of completion. In this config, I just
+added <code>flex</code> to the front of the default completion styles.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(<span style="color: #ff79c6; font-weight: bold;">setq</span> completion-styles '(flex basic partial-completion emacs22)
+      completion-cycle-threshold 3
+      tab-always-indent 'complete)
+</pre>
+</div>
+
+<p>
+<code>completion-cycle-threshold</code> defines when you want to just cycle through
+alternatives on each &lt;TAB&gt; (or whatever key you use) rather than presenting
+options. Setting it to 3 means if my options are "FOO, FOP, FOR" or less,
+hitting complete will change FOO-&gt;FOP, FOP-&gt;FOR, FOR-&gt;FOO.
+</p>
+
+<p>
+<code>tab-always-indent</code> changes the behavior of the TAB key:
+</p>
+
+<blockquote>
+<p>
+If ‘complete’, TAB first tries to indent the current line, and if the line
+was already indented, then try to complete the thing at point.
+</p>
+</blockquote>
+</div>
+</div>
+
+<div id="outline-container-org5883ba7" class="outline-3">
+<h3 id="org5883ba7"><span class="section-number-3">4.3.</span> <a href="consult.html#Top">consult</a> - Consulting <a href="https://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Minibuffer-Completion">completing-read</a></h3>
+<div class="outline-text-3" id="text-4-3">
+<p>
+consult offers enhanced completion similar to ivy and helm, but with the
+built in completing read functionality of the minibuffer.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'consult)
+</pre>
+</div>
+
+<p>
+main entry point would be <code>consult-buffer</code>. however, there are many consult
+commands that can enhance any completing read function.
+</p>
+</div>
+
+<div id="outline-container-org64b8a2b" class="outline-4">
+<h4 id="org64b8a2b"><span class="section-number-4">4.3.1.</span> "Virtual Buffers"</h4>
+<div class="outline-text-4" id="text-4-3-1">
+<p>
+it introduces this concept of "Virtual Buffers", but i'm not certain what
+it means. consult "supports &#x2026; narrowing to the virtual buffer types".
+</p>
+
+<p>
+perhaps a Virtual Buffer is a "grouping" of actual Emacs buffers or "things"
+that can be materialized in a buffer. For example, I can <code>consult-buffer</code>
+and press <code>m SPC</code> to narrow the "buffer list" to any bookmarks.
+</p>
+</div>
+</div>
+
+<div id="outline-container-org403305c" class="outline-4">
+<h4 id="org403305c"><span class="section-number-4">4.3.2.</span> consult keybindings</h4>
+<div class="outline-text-4" id="text-4-3-2">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(global-set-key (kbd <span style="color: #f1fa8c;">"C-x b"</span>) #'consult-buffer)
+(define-key xah-fly-leader-key-map (kbd <span style="color: #f1fa8c;">"f"</span>) #'consult-buffer)
+(define-key xah-fly-command-map (kbd <span style="color: #f1fa8c;">"n"</span>) #'consult-line)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org031cb06" class="outline-4">
+<h4 id="org031cb06"><span class="section-number-4">4.3.3.</span> consult-themes</h4>
+<div class="outline-text-4" id="text-4-3-3">
+<p>
+i had a bit of a mess with it at first, because i'd implemented my own
+solution to a quirk of theme loading. enabling themes is additive,
+and can cause unexpected results. so i added <a href="https://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Advising-Functions">advice</a>
+to <code>load-theme</code> to automatically disable the old one before enabling
+the new.
+</p>
+
+<p>
+it seems like <code>consult-theme</code> does this as well. additionally, as
+it will preview the theme as you are narrowing the selection. i did not
+expect this behavior and it got all kinds of wonky. the manual has a
+nice example of delaying the theme-switch-preview since it is slow.
+this way you can scroll / narrow your list of themes without the colors
+changing with every keypress.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(<span style="color: #ff79c6; font-weight: bold;">with-eval-after-load</span> 'consult
+  (<span style="color: #ff79c6; font-weight: bold;">consult-customize</span> consult-theme <span style="color: #ffb86c;">:preview-key</span> '(<span style="color: #ffb86c;">:debounce</span> 0.5 any)))
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org7fbc5e7" class="outline-4">
+<h4 id="org7fbc5e7"><span class="section-number-4">4.3.4.</span> <span class="todo TODO">TODO</span> consult-project-buffer</h4>
+<div class="outline-text-4" id="text-4-3-4">
+<p>
+how do project buffers get filtered? i'm seeing buffers assigned to a project
+that in my mind, shouldn't be.
+</p>
+
+<p>
+looks like it interfaces with <code>project-switch-to-buffer</code> which has its own
+logic about which project a buffer belongs to. some of the mistakes i was seeing
+earlier were simply due to starting a repl in a particular directory.
+</p>
+
+<p>
+it appears that "special" buffers may get assigned to a particular project as
+well. for example the EWW buffer is part of a project, but it is unclear as
+to why. appears likely to have to do with the behavior of the <code>default-directory</code>
+variable which is buffer-local.
+</p>
+
+<p>
+i may want to figure out ways to mark "special" buffers as having a non-project
+default-directory set so they don't show up, or just filter them out if it
+becomes annoying. i'm accustomed to <code>perspectives</code> provided by a MELPA package
+that hooked into <code>projectile</code>'s project definitions. it would keep a list of
+perspective-local buffers where the perspective was tied to a project.
+</p>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org7b55f29" class="outline-3">
+<h3 id="org7b55f29"><span class="section-number-3">4.4.</span> embark</h3>
+<div class="outline-text-3" id="text-4-4">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'embark)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org8e12307" class="outline-3">
+<h3 id="org8e12307"><span class="section-number-3">4.5.</span> marginalia</h3>
+<div class="outline-text-3" id="text-4-5">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'marginalia)
+(marginalia-mode)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orge6036f2" class="outline-3">
+<h3 id="orge6036f2"><span class="section-number-3">4.6.</span> vertico</h3>
+<div class="outline-text-3" id="text-4-6">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'vertico)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> minibuffer-prompt-properties
+      '(read-only t cursor-intangible t face minibuffer-prompt))
+(add-hook 'minibuffer-setup-hook #'cursor-intangible-mode)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> read-extended-command-predicate
+      #'command-completion-default-include-p)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> enable-recursive-minibuffers t)
+(vertico-mode)
+</pre>
+</div>
+</div>
+
+<div id="outline-container-orgba3f7f7" class="outline-4">
+<h4 id="orgba3f7f7"><span class="section-number-4">4.6.1.</span> vertico-directory</h4>
+<div class="outline-text-4" id="text-4-6-1">
+<p>
+i'd like to emulate the behavior in <code>find-file</code> that i'm used to from Ivy.
+basically, when i press DEL it should act normally until i hit a directory
+boundary, then it should jump up a dir with the following press.
+</p>
+
+<p>
+this is implemented with the <code>vertico-directory</code> extension.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(<span style="color: #ff79c6; font-weight: bold;">require</span> '<span style="color: #8be9fd;">vertico-directory</span>)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"RET"</span>) #'vertico-directory-enter)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"DEL"</span>) #'vertico-directory-delete-char)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"M-DEL"</span>) #'vertico-directory-delete-word)
+(define-key vertico-map (kbd <span style="color: #f1fa8c;">"M-j"</span>) #'vertico-quick-insert)
+</pre>
+</div>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org33ed736" class="outline-3">
+<h3 id="org33ed736"><span class="section-number-3">4.7.</span> corfu</h3>
+<div class="outline-text-3" id="text-4-7">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'corfu)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> corfu-auto t
+      corfu-cycle t
+      corfu-quit-no-match t)
+(global-corfu-mode t)
+</pre>
+</div>
+</div>
+
+<div id="outline-container-org3ebbe44" class="outline-4">
+<h4 id="org3ebbe44"><span class="section-number-4">4.7.1.</span> corfu-terminal enables in terminal interface</h4>
+<div class="outline-text-4" id="text-4-7-1">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'corfu-terminal)
+(<span style="color: #ff79c6; font-weight: bold;">unless</span> (display-graphic-p)
+    (corfu-terminal-mode +1))
+</pre>
+</div>
+</div>
+</div>
+</div>
+<div id="outline-container-orge300cfc" class="outline-3">
+<h3 id="orge300cfc"><span class="section-number-3">4.8.</span> which-key</h3>
+<div class="outline-text-3" id="text-4-8">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'which-key)
+(which-key-mode)
+</pre>
+</div>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org19750d2" class="outline-2">
+<h2 id="org19750d2"><span class="section-number-2">5.</span> Editing</h2>
+<div class="outline-text-2" id="text-5">
+</div>
+<div id="outline-container-orgd49b424" class="outline-3">
+<h3 id="orgd49b424"><span class="section-number-3">5.1.</span> <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Matching">electric pair mode</a></h3>
+<div class="outline-text-3" id="text-5-1">
+<p>
+I've been using smartparens -&gt; (bookmark-jump "smartparens package") in my
+main config. electric pair mode does some of what smartparens does out of
+the box. what i'm missing is the generalized <code>sp-hybrid-slurp</code> or
+whatever it was called. but using the built in is good for now. further
+config might get what i want with vanilla built ins.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(electric-pair-mode)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orgf23fec9" class="outline-3">
+<h3 id="orgf23fec9"><span class="section-number-3">5.2.</span> markdown mode</h3>
+<div class="outline-text-3" id="text-5-2">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'markdown-mode)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org709f02c" class="outline-3">
+<h3 id="org709f02c"><span class="section-number-3">5.3.</span> org mode</h3>
+<div class="outline-text-3" id="text-5-3">
+</div>
+<div id="outline-container-orge7954c4" class="outline-4">
+<h4 id="orge7954c4"><span class="section-number-4">5.3.1.</span> exporting</h4>
+<div class="outline-text-4" id="text-5-3-1">
+<pre class="example">
+(require 'ox-md)
+</pre>
+</div>
+<ol class="org-ol">
+<li><a id="org196310c"></a>htmilze<br />
+<div class="outline-text-5" id="text-5-3-1-1">
+<p>
+this seems to be required to fontify source blocks
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'htmlize)
+</pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+
+<div id="outline-container-org4c2680d" class="outline-3">
+<h3 id="org4c2680d"><span class="section-number-3">5.4.</span> recentf-mode</h3>
+<div class="outline-text-3" id="text-5-4">
+<p>
+this tracks recently operated on files (by default) and enables quick selection
+from them in various Emacs menus. <a href="#org5883ba7">consult</a> hooks into it as well.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(recentf-mode)
+</pre>
+</div>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org6f22775" class="outline-2">
+<h2 id="org6f22775"><span class="section-number-2">6.</span> Programming</h2>
+<div class="outline-text-2" id="text-6">
+</div>
+<div id="outline-container-org1a56e09" class="outline-3">
+<h3 id="org1a56e09"><span class="section-number-3">6.1.</span> Languages</h3>
+<div class="outline-text-3" id="text-6-1">
+</div>
+<div id="outline-container-orgea87347" class="outline-4">
+<h4 id="orgea87347"><span class="section-number-4">6.1.1.</span> Common Lisp</h4>
+<div class="outline-text-4" id="text-6-1-1">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'sly)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org66f16ab" class="outline-4">
+<h4 id="org66f16ab"><span class="section-number-4">6.1.2.</span> Javascript</h4>
+<div class="outline-text-4" id="text-6-1-2">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'json-mode)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org9801164" class="outline-4">
+<h4 id="org9801164"><span class="section-number-4">6.1.3.</span> Ruby</h4>
+</div>
+</div>
+
+<div id="outline-container-org3e1a4c8" class="outline-3">
+<h3 id="org3e1a4c8"><span class="section-number-3">6.2.</span> Dev Docs</h3>
+<div class="outline-text-3" id="text-6-2">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'devdocs)
+</pre>
+</div>
+</div>
+</div>
+</div>
+<div id="outline-container-org7b5b481" class="outline-2">
+<h2 id="org7b5b481"><span class="section-number-2">7.</span> Projects</h2>
+<div class="outline-text-2" id="text-7">
+</div>
+
+<div id="outline-container-orgeb5a0f7" class="outline-3">
+<h3 id="orgeb5a0f7"><span class="section-number-3">7.1.</span> project.el</h3>
+</div>
+<div id="outline-container-org05ca46c" class="outline-3">
+<h3 id="org05ca46c"><span class="section-number-3">7.2.</span> version control</h3>
+<div class="outline-text-3" id="text-7-2">
+</div>
+<div id="outline-container-org7d03814" class="outline-4">
+<h4 id="org7d03814"><span class="section-number-4">7.2.1.</span> magit</h4>
+<div class="outline-text-4" id="text-7-2-1">
+<p>
+its the best! 🪄
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'magit)
+</pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="outline-container-org6d3c8fa" class="outline-2">
+<h2 id="org6d3c8fa"><span class="section-number-2">8.</span> External Services</h2>
+<div class="outline-text-2" id="text-8">
+<p>
+Packages that enable communication via HTTP or connect with external APIs or other
+resources outside of Emacs and/or the local machine.
+</p>
+</div>
+
+<div id="outline-container-orgd733e10" class="outline-3">
+<h3 id="orgd733e10"><span class="section-number-3">8.1.</span> plz - http library</h3>
+<div class="outline-text-3" id="text-8-1">
+<p>
+this is an http library that intends to solve some of the "pain points" of url.el.
+i ran into some of them trying to download and install the Victor Mono font used
+by my configuration. the downside of <code>plz</code> is that it is dependent on <code>curl</code>, rather
+than being pure elisp. however, this is a non-issue for me, especially since my
+use case had devolved into using <code>make-process</code> to call <code>wget</code> and then implement
+a "callback" with a process sentinel. kinda neat, but maybe too much.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'plz)
+</pre>
+</div>
+
+<p>
+the sourcehut package in this config also depends on <code>plz</code>
+</p>
+</div>
+</div>
+
+<div id="outline-container-org721adef" class="outline-3">
+<h3 id="org721adef"><span class="section-number-3">8.2.</span> sourcehut</h3>
+<div class="outline-text-3" id="text-8-2">
+<p>
+there's a new package in GNU ELPA for some basic interaction with the sr.ht http api.
+i'm interested to try it out since i still pay for the account, plus the forge is
+free software and could be self-hosted if it comes to it.
+</p>
+
+<p>
+it also depends on <code>plz</code> which is another new package providing a nicer API for
+HTTP requests I was going 
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'srht)
+(<span style="color: #ff79c6; font-weight: bold;">setq</span> srht-username <span style="color: #f1fa8c;">"shoshin"</span>)
+</pre>
+</div>
+
+<p>
+an API token is stored in my <code>.authinfo</code> file.
+</p>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org7ba8dba" class="outline-2">
+<h2 id="org7ba8dba"><span class="section-number-2">9.</span> UI</h2>
+<div class="outline-text-2" id="text-9">
+</div>
+<div id="outline-container-orgb0526ec" class="outline-3">
+<h3 id="orgb0526ec"><span class="section-number-3">9.1.</span> basic Emacs UI tweaks</h3>
+<div class="outline-text-3" id="text-9-1">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(<span style="color: #ff79c6; font-weight: bold;">when</span> (display-graphic-p)
+  (scroll-bar-mode -1)
+  (fringe-mode '(8 . 0)))
+
+(tab-bar-mode t)
+(display-battery-mode t)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orga727260" class="outline-3">
+<h3 id="orga727260"><span class="section-number-3">9.2.</span> [BROKEN LINK: No match for fuzzy expression: ;;; Commentary:] - distraction free writing</h3>
+<div class="outline-text-3" id="text-9-2">
+<p>
+the notes suggest using <code>darkroom-tentative-mode</code> which auto switches
+depending on the window layout currently in use.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'darkroom)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org99e1861" class="outline-3">
+<h3 id="org99e1861"><span class="section-number-3">9.3.</span> Fonts</h3>
+<div class="outline-text-3" id="text-9-3">
+<p>
+For code, I've grown fond of Victor Mono.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(set-frame-font <span style="color: #f1fa8c;">"Victor Mono"</span>)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-org033b480" class="outline-3">
+<h3 id="org033b480"><span class="section-number-3">9.4.</span> Highlights</h3>
+<div class="outline-text-3" id="text-9-4">
+</div>
+<div id="outline-container-org1aa916e" class="outline-4">
+<h4 id="org1aa916e"><span class="section-number-4">9.4.1.</span> <a href="global-hl-line-mode">global-hl-mode</a></h4>
+<div class="outline-text-4" id="text-9-4-1">
+<p>
+i enjoy having the current line highighted as a visual cue. 
+</p>
+
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(global-hl-line-mode t)
+</pre>
+</div>
+
+<p>
+can be toggled with &lt;leader&gt; l 2 
+</p>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orgc642392" class="outline-3">
+<h3 id="orgc642392"><span class="section-number-3">9.5.</span> Themes</h3>
+<div class="outline-text-3" id="text-9-5">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(<span style="color: #ff79c6; font-weight: bold;">setq</span> my-chosen-themes
+      '(cyberpunk-theme dracula-theme))
+(mapc #'package-install my-chosen-themes)
+</pre>
+</div>
+</div>
+</div>
+
+<div id="outline-container-orgb9e69a0" class="outline-3">
+<h3 id="orgb9e69a0"><span class="section-number-3">9.6.</span> windresize</h3>
+<div class="outline-text-3" id="text-9-6">
+<div class="org-src-container">
+<pre class="src src-emacs-lisp">(package-install 'windresize)
+</pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="postamble" class="status">
+<p class="date">Created: 2022-07-03 Sun 21:12</p>
+<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
+</div>
+</body>
+</html>
author	shoshin <shoshin@cicadas.surf>	2022-07-03 21:12:57 -0500
committer	shoshin <shoshin@cicadas.surf>	2022-07-03 21:12:57 -0500
commit	7f36c9af0cda383a04a2f53bfb9eb7cf65cdae22 (patch)
tree	745446b9524222ac981f969b8bc03fcdbaeecc3b /README.html
parent	04c31d084627639068a481f1807ae1505e496cde (diff)