Add gopher documentation to README and execution notes

- Update README with gopher/phlog section, publishing commands, URLs,
  and first-time SDF setup instructions
- Add gopher workflow documentation to execution-notes.txt
- Include planning docs in docs/ directory
This commit is contained in:
mnw
2026-01-14 16:24:42 -06:00
parent b7ac21093a
commit 69d6b370b2
4 changed files with 1019 additions and 4 deletions
+43
View File
@@ -98,4 +98,47 @@ To block a reply:
- "https://tilde.zone/@someone/123456789"
GOPHER / PHLOG (SDF Gopherspace)
--------------------------------
Posts can be published to gopher by adding `phlog: true` to frontmatter.
Deploy to gopher (after --gopher-only for first run, then use --gopher):
./scripts/remote_publish.sh --gopher # Hugo + Gopher
./scripts/remote_publish.sh --gopher-only # Gopher only
What it does:
1. Converts posts with `phlog: true` to plain text (70 char wrap)
2. Generates gophermaps for each category
3. Rsyncs to ~/gopher/blog/ on SDF
URLs after deployment:
- Gopher root: gopher://sdf.org/1/users/mnw/
- Blog index: gopher://sdf.org/1/users/mnw/blog/
- Frank's Couch: gopher://sdf.org/1/users/mnw/blog/franks-couch/
- Fun Center: gopher://sdf.org/1/users/mnw/blog/fun-center/
- Web proxy: https://gopher.floodgap.com/gopher/gw?a=gopher://sdf.org/1/users/mnw/
Gopher scripts (in scripts/gopher/):
- convert_to_gopher.py Markdown → gopher plain text
- generate_gophermaps.py Build category menus
- ascii_art.py Headers/footers
- update_root_gophermap.py Update main gophermap (one-time)
References:
- SDF Gopher Setup: https://wiki.sdf.org/doku.php?id=gopher_site_setup_and_hosting_features
- Tilde.town Guide: https://tilde.town/wiki/editing-your-homepage/gopher.html
PUBLISHING / REMOTE DEPLOY
--------------------------
Push changes to SDF and build:
./scripts/remote_publish.sh # Hugo only
./scripts/remote_publish.sh --gopher # Hugo + Gopher
./scripts/remote_publish.sh --gopher-only # Gopher only
The script handles git commit/push prompts automatically.
================================================================================