Convert book to org-mode and add GitHub Pages deployment

- Convert all 14 markdown chapters to proper org-mode format
  (headings, bold/italic/code, fenced blocks, blockquotes, links)
- README.md → README.org (repo landing page with link to Pages site)
- README.md index content → index.org (org-publish entry point)
- Add publish.el: Emacs org-publish config with sidebar nav,
  prev/next chapter navigation, and custom HTML preamble/postamble
- Add book.css: book-quality typography using IBM Plex font family,
  fixed sidebar nav, syntax highlighting, responsive layout
- Add setup.org: shared #+SETUPFILE for font loading and CSS
- Add .github/workflows/deploy.yml: GitHub Actions workflow that
  installs Emacs, runs org-publish, and deploys to GitHub Pages
- Add .gitignore: exclude public/ build output

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: DavidLiedle

.github/workflows/deploy.yml

@@ -0,0 +1,74 @@
+name: Build and Deploy Book
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+# Allow only one concurrent deployment
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Emacs and dependencies
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y --no-install-recommends \
+            emacs-nox \
+            elpa-htmlize
+
+      - name: Install Emacs packages (org, htmlize)
+        run: |
+          emacs --batch --eval "
+            (require 'package)
+            (add-to-list 'package-archives
+              '(\"melpa\" . \"https://melpa.org/packages/\") t)
+            (add-to-list 'package-archives
+              '(\"gnu\" . \"https://elpa.gnu.org/packages/\") t)
+            (package-initialize)
+            (package-refresh-contents)
+            (unless (package-installed-p 'htmlize)
+              (package-install 'htmlize))
+            (unless (package-installed-p 'org)
+              (package-install 'org))"
+
+      - name: Build HTML book
+        run: |
+          mkdir -p public
+          emacs --batch \
+            --eval "(setq package-user-dir (expand-file-name \"~/.emacs.d/elpa\"))" \
+            --eval "(require 'package)" \
+            --eval "(package-initialize)" \
+            -l publish.el \
+            --funcall org-publish-all
+
+      - name: Setup GitHub Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: public/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,3 @@
+public/
+.org-timestamps/
+*.elc

01-introduction.md 01-introduction.org01-introduction.md renamed to 01-introduction.org

@@ -1,10 +1,15 @@
-# Chapter 1: Introduction - Welcome to the Org-Mode Rabbit Hole
+#+TITLE: Chapter 1: Introduction - Welcome to the Org-Mode Rabbit Hole
+#+AUTHOR: The Org-Mode with Emacs Authors
+#+LANGUAGE: en
+#+OPTIONS: toc:t num:t ^:nil H:4 html-style:nil
+#+SETUPFILE: setup.org
 
-You've probably heard whispers about Org-Mode. Perhaps you've seen that friend who seems oddly satisfied with their text-based life management system, or you stumbled upon a blog post claiming someone manages their entire existence in a `.org` file. Maybe you thought, "That can't be real."
+
+You've probably heard whispers about Org-Mode. Perhaps you've seen that friend who seems oddly satisfied with their text-based life management system, or you stumbled upon a blog post claiming someone manages their entire existence in a =.org= file. Maybe you thought, "That can't be real."
 
 Oh, but it is. And you're about to fall down one of the most productive rabbit holes in the computing world.
 
-## What is Org-Mode?
+* What is Org-Mode?
 
 Org-Mode is deceptively simple at first glance: it's a major mode for GNU Emacs that handles notes, TODO lists, and project planning using plain text files. But calling Org-Mode "just a note-taking system" is like calling the ocean "a bit damp."
 
@@ -23,38 +28,38 @@ Created by Carsten Dominik in 2003 (and now maintained by a dedicated community)
 
 The real magic? All of this happens in plain text files that will outlive whatever fancy proprietary tool is trending this year.
 
-## Why Org-Mode?
+* Why Org-Mode?
 
-### The Plain Text Advantage
+** The Plain Text Advantage
 
 Your notes from 1995 written in WordPerfect? Good luck opening those without archeological-level effort. Your notes from 2005 in that now-defunct web service? Gone when the startup folded. But plain text? Plain text is forever.
 
-Org-Mode embraces this permanence. Your `.org` files are readable with any text editor, searchable with grep, version-controllable with git, and will be accessible decades from now. This is information longevity at its finest.
+Org-Mode embraces this permanence. Your =.org= files are readable with any text editor, searchable with grep, version-controllable with git, and will be accessible decades from now. This is information longevity at its finest.
 
-### The Power of Text-Based Workflow
+** The Power of Text-Based Workflow
 
 Here's something magical: when your entire workflow lives in text, automation becomes trivial. Want to generate reports from your task lists? Parse them. Want to track patterns in your time logs? Analyze them. Want to build custom workflows? Script them.
 
 Try doing that with your favorite GUI task manager.
 
-### The Joy of Keyboard-Driven Efficiency
+** The Joy of Keyboard-Driven Efficiency
 
 Once you internalize Org-Mode's keybindings (and yes, there will be a learning curve), you'll find yourself managing complex information structures at the speed of thought. No clicking through menus, no reaching for the mouse—just pure keyboard-driven productivity.
 
-## Who Should Use Org-Mode?
+* Who Should Use Org-Mode?
 
 Org-Mode attracts a particular type of person:
 
-- **The Optimizer**: You enjoy tweaking your workflows until they purr like a well-tuned engine
-- **The Skeptic**: You've tried seventeen different productivity apps and they all disappointed you
-- **The Writer**: You value distraction-free writing with powerful organizational capabilities
-- **The Programmer**: You appreciate that your notes can contain executable code that actually runs
-- **The Long-Term Thinker**: You want your data in formats that will outlast commercial software
-- **The Control Enthusiast**: You want to own your tools, not rent them
+- *The Optimizer*: You enjoy tweaking your workflows until they purr like a well-tuned engine
+- *The Skeptic*: You've tried seventeen different productivity apps and they all disappointed you
+- *The Writer*: You value distraction-free writing with powerful organizational capabilities
+- *The Programmer*: You appreciate that your notes can contain executable code that actually runs
+- *The Long-Term Thinker*: You want your data in formats that will outlast commercial software
+- *The Control Enthusiast*: You want to own your tools, not rent them
 
 If you nodded along to any of these, welcome home.
 
-## What This Book Will Teach You
+* What This Book Will Teach You
 
 We'll start gentle—basic document structure, simple TODO lists, links—and progressively unveil Org-Mode's deeper powers. By the end, you'll be:
 
@@ -66,21 +71,21 @@ We'll start gentle—basic document structure, simple TODO lists, links—and pr
 - Creating capture templates that make note-taking frictionless
 - And perhaps most importantly: understanding the Org-Mode philosophy
 
-## A Word of Warning
+* A Word of Warning
 
 Org-Mode will spoil you. After you experience the power of plain-text organization with Emacs-level extensibility, other tools will feel constraining. You might find yourself trying to use Org keybindings in your web browser (they won't work, sadly). You may become insufferable at dinner parties, evangelizing about the virtues of plain text.
 
 Consider yourself warned.
 
-## The Philosophy: Your System, Your Rules
+* The Philosophy: Your System, Your Rules
 
 Here's what separates Org-Mode from prescriptive productivity systems: it doesn't tell you how to work. GTD enthusiast? Org-Mode can do that. Prefer Kanban? That too. Want to invent your own hybrid system? Go wild.
 
 Org-Mode provides powerful primitives—headings, timestamps, tags, properties, links—and lets you compose them into whatever structure matches your brain. It's LEGO blocks for information management.
 
-## Ready?
+* Ready?
 
-In the next chapter, we'll get Org-Mode running and write your first `.org` file. Don't worry—we'll start simple. The terrifyingly powerful features come later.
+In the next chapter, we'll get Org-Mode running and write your first =.org= file. Don't worry—we'll start simple. The terrifyingly powerful features come later.
 
 Take a deep breath. Save your work in whatever tool you're currently using (for nostalgia purposes—you won't be going back).