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:
@@ -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.
|
||||
|
||||
|
||||
================================================================================
|
||||
|
||||
Reference in New Issue
Block a user