From 2ab0e23eca3c5cac82d948e506b3f1cb81bedd18 Mon Sep 17 00:00:00 2001 From: t Date: Sat, 11 Jul 2026 12:08:14 -0600 Subject: Migrate site pages to Weft templates and Markdown --- notes/_plain-html.html | 70 -------------------------------------------------- notes/_plain-html.md | 28 ++++++++++++++++++++ notes/index.html | 11 ++++---- notes/index.html.tmpl | 31 ++++++++++++++++++++++ 4 files changed, 64 insertions(+), 76 deletions(-) delete mode 100644 notes/_plain-html.html create mode 100644 notes/_plain-html.md create mode 100644 notes/index.html.tmpl (limited to 'notes') diff --git a/notes/_plain-html.html b/notes/_plain-html.html deleted file mode 100644 index d60275e..0000000 --- a/notes/_plain-html.html +++ /dev/null @@ -1,70 +0,0 @@ - - - - - -The case for plain HTML — notes — tjp.lol - - - - -
- -
-

~tjp $_

- -
- -
-
-
-

← notes  /  tended · planted

-

The case for plain HTML

-
- -
-

A note, not an essay — expect it to change. This page shows how a wiki note reads: internal [[wiki links]] render as underlined-dotted links, and a backlinks panel sits at the bottom.

- -

A hand-written HTML page is the most durable document format I know of that still looks like a document. It has no runtime, no dependencies, and no version that can go out of date. A file I wrote in 2004 opens today, pixel-for-pixel, in a browser that didn't exist then.

- -

This connects to Gemtext & the small web — both are bets that constraint outlives capability. See also How I take notes for why I keep the source in plain text.

- -

Things I no longer do

-
    -
  • Reach for a framework before there's a second page.
    • -
  • Add a build step to save five keystrokes.
    • -
  • Load a web font when the reader already owns a good one.
    • -
- -

The test

-

Turn JavaScript off. If the page is worse, I've added fragility I have to maintain forever. If it's identical, I'm done. This whole site passes that test — see the colophon.

-
- -
-

Linked from

- -
-
-
- - - -
- - diff --git a/notes/_plain-html.md b/notes/_plain-html.md new file mode 100644 index 0000000..6d6e078 --- /dev/null +++ b/notes/_plain-html.md @@ -0,0 +1,28 @@ +--- +description: A note on writing plain, durable HTML. +planted: 2024-08-11 +tended: 2026-05-30 +--- +# The case for plain HTML + +*A note, not an essay — expect it to change. This page shows how a wiki note reads: internal wiki links render as underlined-dotted links, and a backlinks panel sits at the bottom.* + +A hand-written HTML page is the most durable document format I know of that still looks like a document. It has no runtime, no dependencies, and no version that can go out of date. A file I wrote in 2004 opens today, pixel-for-pixel, in a browser that didn't exist then. + +This connects to [Gemtext & the small web](index.html) — both are bets that *constraint outlives capability*. See also [How I take notes](index.html) for why I keep the source in plain text. + +## Things I no longer do + +- Reach for a framework before there's a second page. +- Add a build step to save five keystrokes. +- Load a web font when the reader already owns a good one. + +## The test + +Turn JavaScript off. If the page is worse, I've added fragility I have to maintain forever. If it's identical, I'm done. This whole site passes that test — see the [colophon](../about/index.html). + +## Linked from + +- [Gemtext & the small web](index.html) +- [Home-lab & self-hosting](index.html) +- [Moving my weblog off Gemini (without leaving it)](../weblog/moving-off-gemini.html) diff --git a/notes/index.html b/notes/index.html index 1a8db13..ea988cf 100644 --- a/notes/index.html +++ b/notes/index.html @@ -14,7 +14,7 @@

~tjp $_