Tweak thangs

kaycebasques · Jan 23, 2024 · ed6006f · ed6006f
1 parent 6496dfa
commit ed6006f
Show file tree

Hide file tree

Showing 8 changed files with 55 additions and 30 deletions.
diff --git a/_static/biodigitaljazz.css b/_static/biodigitaljazz.css
@@ -47,3 +47,7 @@ nav ul {
     margin: 0;
     padding: 0;
 }
+
+.toctree-l1 {
+    padding-bottom: 1em;
+}
diff --git a/blog/asm.rst b/blog/asm.rst
@@ -47,8 +47,8 @@ Create the repository
    touch ~/uno/blink.asm
    touch ~/uno/Makefile
 
-Install avra
-============
+Install ``avra``
+================
 
 .. code-block:: console
 
@@ -58,8 +58,8 @@ Install avra
 
 ``avra`` (AVR Assembler) will be your `assembler`_.
 
-Install avrdude
-===============
+Install ``avrdude``
+===================
 
 .. code-block::
 
@@ -76,8 +76,8 @@ Create the assembly program
 
 Copy-paste the following code into each respective file.
 
-~/uno/blink.asm
-===============
+``~/uno/blink.asm``
+===================
 
 
 .. code-block::
@@ -153,8 +153,8 @@ Resources for figuring out how the ``blink.asm`` code works:
   is a comprehensive, approachable, and delightfully old school walkthrough
   of AVR Assembly programming
 
-~/uno/Makefile
-==============
+``~/uno/Makefile``
+==================
 
 .. code-block:: make
 

diff --git a/blog/index.rst b/blog/index.rst
@@ -1,5 +1,6 @@
 .. _blog:
 
+====
 Blog
 ====
 

diff --git a/blog/littlebraincell.rst b/blog/littlebraincell.rst
@@ -1,5 +1,6 @@
 .. _littlebraincell:
 
+================================================
 Transistor first reported as "Little Brain Cell"
 ================================================
 
@@ -11,14 +12,13 @@ Transistor first reported as "Little Brain Cell"
 
 Last week I listened to the Latent Space `interview`_ with "That
 SemiAnalysis Guy". His name is Dylan Patel but I'm going to keep calling him
-That SemiAnalysis Guy because it tickles my brain for some reason.
-The interview was great! It motivated me to finally learn more about the
-hardware industry. At the end of the interview That SemiAnalysis Guy
-recommends `Chip War`_ by Chris Miller, who will hereby be called "That Chip War
-Guy". The book was on my radar but I never got around to reading it because I
-was pretty turned off by the clickbaity title. I'm only 50 pages in but it
-seems like the book is just a well-researched history of the semiconductor
-industry...?
+That SemiAnalysis Guy because it tickles my brain. The interview was great! It
+motivated me to finally learn more about the hardware industry. At the end of
+the interview That SemiAnalysis Guy recommends `Chip War`_ by Chris Miller, who
+will hereby be called "That Chip War Guy". The book was on my radar but I never
+got around to reading it because I was pretty turned off by the clickbaity
+title. I'm only 50 pages in but it seems like the book is just a
+well-researched history of the semiconductor industry...?
 
 I love it when historians mention their primary sources. That Chip War Guy
 mentions some of the earliest reporting on the transistor, back in 1948:
@@ -69,17 +69,9 @@ save you a click and reproduce it here in full:
 It's fascinating to me that we were thinking of this stuff as "electronic
 nervous systems" and "little brain cells" from the `git-go`_.
 
-(I just looked up the etymology of "get-go" and found that original "git-go"
-spelling. Someone in the git community should totally create some kind of git
-tool in Go and call it git-go.)
-
 .. _scan: https://time.com/vault/issue/1948-07-12/page/56/
 
 I was also able to find a `scan`_ of the magazine. The web is a vast treasure
 trove of historical content.
 
 .. image:: littlebraincell.png
-
-P.S. I also learned from That Chip War Guy that vacuum-tube-powered missiles
-and bombs were comically inaccurate. "Comical" isn't the right word because
-we're talking about war, but you get the idea. A post for another day, perhaps.
diff --git a/blog/picam.rst b/blog/picam.rst
@@ -1,5 +1,6 @@
 .. _picam:
 
+============================================================
 The eleventh circle of hell: setting up an RPi camera module
 ============================================================
 
@@ -12,7 +13,10 @@ docs. And make sure that whatever you're reading was written for the
 specific HW/SW permutation that you're using. In my case (RPi4 + RPi OS
 Bookworm + RPi Camera Module 3) the correct doc is `The Picamera2 Library`_. 
 
-Once I found the right doc it was trivial to get everything working. The ``picamera2`` repo has an extensive collection of examples. It's downright magical that I can get started with computer vision in a matter of minutes. OpenCV is really cool stuff.
+Once I found the right doc it was trivial to get everything working. The
+``picamera2`` repo has an extensive collection of examples. It's downright
+magical that I can get started with computer vision in a matter of minutes.
+OpenCV is really cool stuff.
 
 This gem of a `quote`_ from an RPi engineer sums up the situation:
 

diff --git a/blog/systemantics.rst b/blog/systemantics.rst
@@ -1,8 +1,29 @@
 .. _systemantics:
 
+======================
 Axioms of Systemantics
 ======================
 
 *2024 Jan 23*
 
-* `Systemantics <https://en.wikipedia.org/wiki/Systemantics>`_
+TODO: Explain `Systemantics <https://en.wikipedia.org/wiki/Systemantics>`__
+
+----------------------------------------------
+*Systems In General Work Poorly Or Not At All*
+----------------------------------------------
+
+-------------------------------
+*New Systems Mean New Problems*
+-------------------------------
+
+------------------------------------------
+*Systems Operate By Redistributing Anergy*
+------------------------------------------
+
+---------------------------------------------------
+*Systems Tend To Expand To Fill The Known Universe*
+---------------------------------------------------
+
+----------------------------------------------
+*A System Will Behave As It Damn Well Pleases*
+----------------------------------------------
diff --git a/blog/systems.rst b/blog/systems.rst
@@ -1,5 +1,6 @@
 .. _systems:
 
+===================
 Books about systems
 ===================
 

diff --git a/blog/www.rst b/blog/www.rst
@@ -9,7 +9,9 @@ The ``www`` in ``www.biodigitaljazz.net``
 The ``www`` in ``https://www.biodigitaljazz.net`` means that you're now surfing
 the world wide web. This is how people in the 90s talked. Those were simpler
 times. No one was worried about the fact that "surfing the web" is a mixed
-metaphor. Anyways, I wanted the domain for this site to just be
-``https://biodigitaljazz.net`` but I couldn't figure out how to get the
-DNS working. So let's just all pretend that I intentionally chose the ``www``
-in the domain name as a form of 90s nostalgia.
+metaphor.
+
+Anyways, I wanted the domain for this site to just be
+``https://biodigitaljazz.net`` but I couldn't figure out how to get the DNS
+working. So let's all just pretend that I intentionally chose the ``www`` in
+the domain name as a form of 90s nostalgia.
-Original file line number
+Diff line change
@@ -1,5 +1,6 @@
     .. _blog:
+    ====
     Blog
     ====
@@ Expand Down @@