additional changes

.gitignore

@@ -0,0 +1,20 @@
+# Hugo build output
+/public/
+/resources/_gen/
+.hugo_build.lock
+hugo_stats.json
+
+# Node (if a toolchain is ever added)
+node_modules/
+
+# Local environment
+.env
+.env.*
+
+# OS / editor
+.DS_Store
+Thumbs.db
+*.swp
+*~
+.idea/
+.vscode/

content/_index.md

@@ -18,7 +18,7 @@ sections:
     videoLabel: "A CoreDesktop screen on an ultrawide monitor: three tiled windows side by side, a zoom out to the GNOME overview with the dock, and back."
 
   - type: text
-    body: "CoreDesktop is *some scripts*, not a distribution, yet. Arch Linux does the heavy lifting, so you get upstream fixes as they land, and a *flexible tiling* desktop that makes the most of any screen, *ultrawides* included."
+    body: "CoreDesktop is *some scripts*, not a distribution, yet. [Arch Linux](https://archlinux.org) does the heavy lifting, so you get upstream fixes as they land, and a *flexible tiling* desktop that makes the most of any screen, *ultrawides* included."
 
   - type: features
     id: included
@@ -27,7 +27,7 @@ sections:
     lede: "One install script, safe to run again. If something fails, run it again. It skips what's already done."
     items:
       - label: "A tiling desktop you drive from the keyboard"
-        body: "GNOME with the Tiling Shell extension: a flexible tiling system you can lay out however you like, Super + arrow keys to move windows, and the full mouse-friendly desktop when you want it."
+        body: "[GNOME](https://www.gnome.org) with the Tiling Shell extension: a flexible tiling system you can lay out however you like, Super + arrow keys to move windows, and the full mouse-friendly desktop when you want it."
       - label: "The software you'd install anyway"
         body: "From pacman, the AUR, Flathub and mise: browsers, messaging, office, media, notes, remote desktop, database clients and local AI, plus a full developer toolchain."
       - label: "Sandboxed AI agents"
@@ -114,6 +114,8 @@ sections:
         a: "Run the command again. It skips what's already done and picks up where it stopped."
       - q: "Does it work on ultrawide monitors?"
         a: "That's what it's best at. The tiling system adapts to any screen: pick a layout from the tiling icon in the top-right corner, or make your own."
+      - q: "Can I use KDE or some other window manager?"
+        a: "Yes, but you won't be happy. CoreDesktop is meant to be an opinionated installation that leans into GNOME and everything it provides. In our opinion, GNOME offers the best combination of keyboard window management with the traditional mouse options for dragging things around, including windows. If you want another window manager like KDE, there are fantastic distributions such as [CachyOS](https://cachyos.org)."
       - q: "Can I add my own tools on top?"
         a: "Yes. A sibling project is any git repository with an optional `install.sh` and `update.sh`. Install it with `sibling`, and every `update` keeps it current."
     ctas:

content/install.md

@@ -30,7 +30,7 @@ sections:
       - title: "Pick the right GPU driver"
         body: "**If you have an NVIDIA GPU, choose the proprietary NVIDIA option.** Choose the AMD option for AMD cards."
       - title: "Choose desktop and GNOME"
-        body: "When asked what type of system you want, choose **Desktop**, and **GNOME** as the desktop environment."
+        body: "When asked what type of system you want, choose **Desktop**, and [**GNOME**](https://www.gnome.org) as the desktop environment."
       - title: "Choose pipewire, then reboot"
         body: "Pipewire is strongly recommended for sound; it works well with Jitsi, Element and the other Federated Core apps. Reboot and log in."
 

content/software.md

@@ -19,7 +19,7 @@ sections:
     lede: "Each source has its own list in the repository, so you can see exactly what's installed."
     headers: ["Source", "What it installs", "Where it's listed"]
     rows:
-      - ["pacman", "Arch's own packages: neovim, tmux, Go, Rust, Docker, Tailscale, Element, LibreOffice and more", "[packages.conf](https://gitea.federated.computer/Federated_Computer/coredesktop/src/branch/main/packages.conf)"]
+      - ["pacman", "[Arch's own packages](https://archlinux.org/packages/): neovim, tmux, Go, Rust, Docker, Tailscale, Element, LibreOffice and more", "[packages.conf](https://gitea.federated.computer/Federated_Computer/coredesktop/src/branch/main/packages.conf)"]
       - ["AUR", "Community packages, built and kept up to date with yay: Helium Browser, Winboat and more", "[packages.conf](https://gitea.federated.computer/Federated_Computer/coredesktop/src/branch/main/packages.conf)"]
       - ["Flathub", "48 desktop apps in their own sandboxes", "[install-flatpaks.sh](https://gitea.federated.computer/Federated_Computer/coredesktop/src/branch/main/install-flatpaks.sh)"]
       - ["mise", "Ruby and Rails", "[install-mise-ruby-rails.sh](https://gitea.federated.computer/Federated_Computer/coredesktop/src/branch/main/install-mise-ruby-rails.sh)"]
@@ -53,7 +53,7 @@ sections:
         body: "Remmina and RustDesk for remote desktops, LocalSend to send files to nearby devices, and Trayscale for Tailscale."
       - label: "Utilities"
         title: "The useful little things"
-        body: "Boxes for virtual machines, Impression to write ISOs to USB sticks, Warehouse to manage Flatpaks, Extension Manager for GNOME, and Helvum for audio routing."
+        body: "Boxes for virtual machines, Impression to write ISOs to USB sticks, Warehouse to manage Flatpaks, Extension Manager for [GNOME](https://www.gnome.org), and Helvum for audio routing."
       - label: "And more"
         title: "Downtime included"
         body: "qBittorrent, RetroArch and others. See [install-flatpaks.sh](https://gitea.federated.computer/Federated_Computer/coredesktop/src/branch/main/install-flatpaks.sh) for the full list."

content/system.md

@@ -13,7 +13,7 @@ sections:
     kicker: "Tiling"
     headline: "Flexible tiling, all from the keyboard."
     body: |
-      You end up with a GNOME system with a flexible tiling setup that works on any screen and really shines on widescreens. Hold <kbd>Super</kbd> (the Windows key or equivalent) and use the arrow keys to move windows around the screen.
+      You end up with a [GNOME](https://www.gnome.org) system with a flexible tiling setup that works on any screen and really shines on widescreens. Hold <kbd>Super</kbd> (the Windows key or equivalent) and use the arrow keys to move windows around the screen.
 
       To change the tiling, use the icon in the top right of your screen. You can set it up however you want.
 
@@ -54,7 +54,7 @@ sections:
     body: |
       If `/` is btrfs (the archinstall default), Snapper takes a snapshot of `/` before every `update` and keeps the last 5. `/home` is a separate subvolume and isn't included, so rolling back never touches your files. `sudo snapper -c root list` shows the snapshots.
 
-      These snapshots can't be picked from the boot menu. To roll back, boot the Arch ISO and replace the `@` subvolume with a snapshot:
+      These snapshots can't be picked from the boot menu. To roll back, boot the [Arch ISO](https://archlinux.org/download/) and replace the `@` subvolume with a snapshot:
 
       ```
       mount -o subvolid=5 /dev/{root partition} /mnt

content/utilities.md

@@ -31,7 +31,7 @@ sections:
     items:
       - label: "update"
         title: "Keep everything current"
-        body: "Snapshots your system, then updates Arch, GNOME, AUR packages, Flatpaks, Ruby, extensions and firmware."
+        body: "Snapshots your system, then updates [Arch](https://archlinux.org), [GNOME](https://www.gnome.org), AUR packages, Flatpaks, Ruby, extensions and firmware."
         link: "/utilities/#update"
         linktext: "How update works"
       - label: "refresh"

layouts/partials/footer.html

@@ -25,7 +25,7 @@
     </div>
 
     <div class="foot-legal">
-      <span class="foot-copy">© {{ now.Format "2006" }} Federated Computer, Inc. CoreDesktop is not a distribution, yet — with gratitude to Arch Linux and to <a href="https://www.youtube.com/@typecraft_dev">Typecraft</a>.</span>
+      <span class="foot-copy">© {{ now.Format "2006" }} Federated Computer, Inc. CoreDesktop is not a distribution, yet — with gratitude to <a href="https://archlinux.org">Arch Linux</a> and to <a href="https://www.youtube.com/@typecraft_dev">Typecraft</a>.</span>
       <a class="foot-top" href="#top">Back to top<span class="foot-up" aria-hidden="true">↑</span></a>
     </div>
   </div>

layouts/partials/head.html

@@ -3,9 +3,9 @@
 <title>{{ if .IsHome }}{{ .Site.Title }} — {{ .Site.Params.tagline }}{{ else }}{{ .Title }} · {{ .Site.Title }}{{ end }}</title>
 <meta name="description" content="{{ if .Description }}{{ .Description }}{{ else }}{{ .Site.Params.tagline }}{{ end }}">
 <meta name="theme-color" content="#001a2b">
-<link rel="icon" href="{{ "favicon.ico" | relURL }}" sizes="32x32">
-<link rel="icon" href="{{ "favicon.svg" | relURL }}" type="image/svg+xml">
-<link rel="apple-touch-icon" href="{{ "apple-touch-icon.png" | relURL }}">
+<link rel="icon" href="{{ "favicon.ico" | relURL }}?v=2" sizes="32x32">
+<link rel="icon" href="{{ "favicon.svg" | relURL }}?v=2" type="image/svg+xml">
+<link rel="apple-touch-icon" href="{{ "apple-touch-icon.png" | relURL }}?v=2">
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">

static/css/style.css

@@ -898,3 +898,11 @@ pre.has-copy code { display: block; padding-right: 64px; }
 .video-window .log-bar { justify-content: flex-start; gap: 14px; }
 .video-screen { display: block; width: 100%; height: auto; aspect-ratio: 32 / 9; background: #000; }
 @media (max-width: 1000px) { .hero-video { margin-top: 48px; } }
+
+/* links in a statement: ink with a magenta underline, so they don't read as the magenta *phrases* */
+.section-text .wrap:not(:has(> .section-head)) .prose a {
+  color: inherit; font-weight: inherit;
+  text-decoration: underline; text-decoration-color: var(--magenta);
+  text-decoration-thickness: 2px; text-underline-offset: .16em;
+}
+.section-text .wrap:not(:has(> .section-head)) .prose a:hover { color: var(--magenta); }