commit 91ca8f318f1e509da1ab3094a1c42579d5c99d6f (patch)
parent da283d1ec2818d150e0ebd26985564b0c44eac20
Author: Alex Karle <alex@alexkarle.com>
Date: Mon, 15 Nov 2021 00:16:38 -0500
gopher/blog: Merge gopher build recipe, announce on blog
So, if you can't tell by the slew of commits leading up to this one, the
gopher commits were *actually* in their own private repo. As discussed
in 009, I decided to merge it with alexkarle.com, and this commit
represents that.
Of course, that merge also warrants a post (and the deprecation of
text.alexkarle.com). So this commit bundles in the phlog and blog
announcements (can you tell which took 1hr+ to write and which took 5m?
:P -- here's to a brave new world of micro-phlogging).
Diffstat:
10 files changed, 158 insertions(+), 319 deletions(-)
diff --git a/.gitignore b/.gitignore
@@ -1,8 +1,6 @@
# generated html from man pages
-*.html
-*.txt
-!jam-tuesday/index.html
-!welcome.txt
+/*.html
+/*.txt
# atom feed is generated by ./bin/genatom.sh
atom.xml
diff --git a/LINKS b/LINKS
@@ -5,4 +5,7 @@ pass.1 https://www.passwordstore.org
newsboat.1 https://newsboat.org
stagit.1 https://git.codemadness.org/stagit/
git-daemon.1 https://git-scm.com/docs/git-daemon
-gophernicus.8 https://gophernicus.org
+gophernicus.8 https://gophernicus.org
+bombadillo.1 https://bombadillo.colorfield.space/
+lynx.1 https://lynx.invisible-island.net/
+sacc.1 https://git.fifth.space/sacc
diff --git a/Makefile b/Makefile
@@ -2,7 +2,7 @@
#
# a tale of two builds
#
-# This Makefile builds both text.alexkarle.com (text-only) and
+# This Makefile builds both gopher://alexkarle.com (text-only) and
# alexkarle.com (html) from the same mdoc(7) by leveraging inference
# rules. Since this generates a LOT of derived files, it's recommended
# to run BSD make and run `make obj` first to get an out-of-tree build.
@@ -12,7 +12,7 @@
# build [default] -- generates html and text in obj (OpenBSD) or $PWD
# obj -- makes the obj/ directory for out-of-tree build on OpenBSD
# clean -- deletes html and text artifacts
-# install -- install to $DESTDIR/{www,text} (default: /var/www/htdocs)
+# install -- install to $DESTDIR/{www,gopher} (default: /var/www/htdocs)
# jams -- regenerate jam-tuesday index and stats files
# gmake defines CURDIR, OpenBSD defines .CURDIR -- one should work
@@ -23,11 +23,13 @@ DESTDIR = /var/www/htdocs
HTML != echo $(DIR)/*.[1-9] | sed 's@$(DIR)/\([^\.]*\)\.[1-9]@\1.html@g'
TEXT != echo $(DIR)/*.[1-9] | sed 's@$(DIR)/\([^\.]*\)\.[1-9]@\1.txt@g'
SETS != find $(DIR)/jam-tuesday -name '[0-9][0-9][0-9][0-9]-*'
+NOTES != find $(DIR)/gopher/notes/all
BUILT = $(HTML) \
$(TEXT) \
atom.xml \
- index.html
+ index.html \
+ gopher/notes/index.gph
# Top level targets
@@ -38,17 +40,27 @@ build: $(BUILT)
jams: jam-tuesday/stats jam-tuesday/index.html
obj:
- mkdir -p obj/jam-tuesday obj/bin
+ mkdir -p obj/jam-tuesday obj/bin obj/gopher/notes
.PHONY: install
install: build
- install -m 755 -Dd $(DESTDIR)/text/jam-tuesday $(DESTDIR)/www/jam-tuesday
- install -m 444 $(SETS) $(DIR)/jam-tuesday/stats $(DESTDIR)/text/jam-tuesday
+ # HTML to DESTDIR/www
+ install -m 755 -Dd $(DESTDIR)/www/jam-tuesday
install -m 444 $(SETS) $(DIR)/jam-tuesday/index.html $(DESTDIR)/www/jam-tuesday
install -m 444 *.html atom.xml $(DIR)/LICENSE $(DIR)/style.css $(DESTDIR)/www
- install -m 444 $(DIR)/LICENSE $(DESTDIR)/text
+ # Text + gopher exclusives to DESTDIR/gopher
+ cd $(DIR) && pax -rw gopher $(DESTDIR)
+ pax -rw gopher $(DESTDIR) # for out-of-tree builds
+ install -m 444 $(SETS) $(DESTDIR)/gopher/jam-tuesday
+ install -m 444 $(DIR)/LICENSE $(DESTDIR)/gopher
for f in *.txt; do \
- install -m 444 $$f $(DESTDIR)/text/$$(grep $$f $(DIR)/ORDER); \
+ install -m 444 $$f $(DESTDIR)/gopher/blog/$$(grep $$f $(DIR)/ORDER); \
+ done
+ cp $(DIR)/gopher/bin/* $(DESTDIR)/gopher/code
+ for d in jam-tuesday blog code; do \
+ (cat $(DIR)/gopher/$$d/index.gph; \
+ $(DIR)/gopher/bin/dirlist $(DESTDIR)/gopher/$$d)\
+ > $(DESTDIR)/gopher/$$d/index.gph; \
done
.PHONY: clean
@@ -75,6 +87,8 @@ bin/fixlinks: LINKS
awk '{ printf " \\\n -e s#https://man.openbsd.org/%s#%s#g", $$1, $$2 } END { printf "\n" }' $(DIR)/LINKS >> $@
chmod +x $@
+gopher/notes/index.gph: $(NOTES)
+ (cd $(DIR)/gopher/notes && $(DIR)/gopher/bin/notetag) > $@
# Inference rules (*.txt and *.html)
$(HTML): bin/genpost.sh bin/fixlinks
diff --git a/ORDER b/ORDER
@@ -15,3 +15,4 @@
110-text-only.txt
111-make-obj.txt
112-use-git.txt
+113-burrowing.txt
diff --git a/README.md b/README.md
@@ -15,15 +15,16 @@ On OpenBSD, running `make obj` is recommended before running `make` to
leverage the out-of-tree build extension (see the bit about `.OBJDIR` in
the man page!).
-text.
------
+gopher://
+---------
A pure ascii dump of the [mdoc(7)][mdoc] content of the www site, served
-over HTTP, HTTPS, and Gopher (by [httpd(8)][httpd] and
-[gophernicus(1)][gophernicus] respectively!
+over Gopher by [geomyidae(1)][geomyidae] respectively!
Builds via [make(1)][make] at the same time as the HTML. See above for
instructions.
+Also has gopher-exclusive content!
+
git.
----
I use a simple setup of git-daemon for anonymous (read-only) downloads,
@@ -52,4 +53,4 @@ and [my-old-man(7)][my-old-man].
[git-daemon]: https://git-scm.com/docs/git-daemon
[self-hosted]: https://alexkarle.com/self-hosted.html
[my-old-man]: https://alexkarle.com/my-old-man.html
-[gophernicus]: https://www.gophernicus.org/
+[geomyidae]: http://r-36.net/scm/geomyidae
diff --git a/blog.7 b/blog.7
@@ -16,6 +16,11 @@ For an up to date list of software/hardware I use, see
.Sh POSTS
.Bl -tag -width "XX/XX"
.It 11/21
+.Xr burrowing 7
+- from
+.Xr text-only 7
+to gopher-only
+.It 11/21
.Xr use-git 7
- non-standard uses of
.Xr git 1
diff --git a/burrowing.7 b/burrowing.7
@@ -0,0 +1,113 @@
+.Dd November 15, 2021
+.Dt BURROWING 7
+.Os
+.Sh NAME
+.Nm burrowing
+.Nd from
+.Xr text-only 7
+to gopher-only
+.Sh DESCRIPTION
+This past month,
+I've spent a lot of time learning about gopher.
+It's truly a fascinating alternative to the world wide web,
+not just in the content found there
+but also in terms of the protocol itself.
+.Pp
+As of this writing, I've decided to deprecate
+.Lk https://text.alexkarle.com
+in favor of serving that content (and more!) over gopher
+instead, exclusively.
+.Sh IMPLICATIONS
+This shouldn't have much impact on this
+.Xr blog 7 .
+After all,
+.Xr text-only 7
+was an experiment to begin with!
+I'll still keep publishing semi-regularly here,
+I just don't plan on maintaining a text dump via HTTP.
+.Pp
+I will, however, start publishing gopher-only content.
+There's two main reasons for this:
+.Pp
+.Bl -enum -compact
+.It
+I want to see more activity on gopher
+.It
+Gopher is easier to publish on
+.El
+.Pp
+Admittedly, number 2 is my own doing.
+I moved this blog to
+.Xr mdoc 7
+willingly
+.Xr ( my-old-man 7 )
+to learn the language.
+I've found that it slows my raw output,
+which,
+while fine for longer form pieces,
+is a pain for shorter-form thoughts.
+No regrets (I learned a ton!),
+but shorter-form thoughts do much better in plaintext!
+.Pp
+The first reason is a theme for this blog:
+be the change you want to see.
+I would love to see more content on gopher,
+so I'm taking the plunge.
+.Sh THE PITCH
+So, why gopher?
+Probably the biggest reason to explore gopher is
+the content.
+It's a parallel network totally untouched by
+commercial interests.
+You won't see a single ad.
+.Pp
+The second reason to try gopher lies in the
+protocol itself--gopher has a standardized menu
+interface, and individual gopherholes cannot
+change the way you interact with them beyond
+the standard.
+In a world where it seems every bit of the
+web's UI has been rewritten in JavaScript (looking
+at you, <div>'s that should be <button>'s),
+it's wildly refreshing
+to just have a predictable menu.
+.Pp
+So, gopher separates the interaction (menus)
+from the content (can be anything, but is usually
+plaintext).
+I think this is a cool design choice
+because it emphasizes what the gopher protocol
+is really about: fetching documents.
+.Pp
+Ultimately,
+it's hard to describe and much better experienced.
+For a quick dip,
+try out a proxy like
+.Lk https://gopherproxy.net .
+For client recommendations,
+I'd check out
+.Xr lynx 1 ,
+.Xr sacc 1 ,
+or
+.Xr bombadillo 1 .
+Bombadillo has gemini support too,
+gemini being another alternative internet protocol
+worth checking out.
+I'll likely put my stuff up there too,
+if time allows.
+.Pp
+Not sure where to start in your client?
+Go to
+.Lk gopher://alexkarle.com
+of course! :)
+.Sh SEE ALSO
+.Bl -bullet -compact
+.It
+.Xr blog 7
+.It
+.Lk https://datatracker.ietf.org/doc/html/rfc1436 RFC 1436 (Gopher)
+.It
+.Lk http://gopherproject.org
+.It
+.Lk http://gemini.circumlunar.space Gemini official site
+.El
diff --git a/jam-tuesday/stats b/jam-tuesday/stats
@@ -1,285 +0,0 @@
-Thu Nov 11 22:03:10 EST 2021
-
-Play Stats:
------------
- 19 Jam Sessions
- 330 Songs Total
- 159 Unique Songs
- 87 Unique Artists
-
-Top 10 Artists (Frequency, Name):
----------------------------------
- 40 The Front Bottoms
- 37 Peach Pit
- 29 Manchester Orchestra
- 16 Vulfpeck
- 16 Dr. Dog
- 15 The Dear Hunter
- 10 Atta Boy
- 9 Cage The Elephant
- 7 Lake Street Dive
- 7 Her's
-
-Top 10 Songs (Frequency, Name):
--------------------------------
- 12 Twin Size Mattress, The Front Bottoms
- 11 Rhode Island, The Front Bottoms
- 11 Alrighty Aphrodite, Peach Pit
- 10 Shadow People, Dr. Dog
- 10 Brian's Movie, Peach Pit
- 8 The Beers, The Front Bottoms
- 8 Jack and Blow, Atta Boy
- 6 That I Miss You, Vansire
- 6 Lauren, Men I Trust
- 6 Drop the Guillotine, Peach Pit
-
-
-
-Full Archive:
-----------------------------+---------------------------------------+--
-311 | Amber | 1
-----------------------------+---------------------------------------+--
-A Great Big Pile Of Leaves | Alligator Bop | 1
-----------------------------+---------------------------------------+--
-A Tribe Called Quest | Can I Kick It? | 1
-----------------------------+---------------------------------------+--
-Anderson .Paak | Make It Better | 1
-----------------------------+---------------------------------------+--
-Anderson .Paak & Bruno Mars | Leave the Door Open | 1
-----------------------------+---------------------------------------+--
-Atta Boy | Jack and Blow | 8
- | Walden Pond | 2
-----------------------------+---------------------------------------+--
-Bad Books | Baby Shoes | 1
- | Forest Whitaker | 1
- | It Never Stops | 1
- | The After Party | 2
- | You Wouldn't Have To Ask | 1
-----------------------------+---------------------------------------+--
-Beck | Loser | 1
-----------------------------+---------------------------------------+--
-Cage The Elephant | Cigarette Daydreams | 6
- | Shake Me Down | 1
- | Telescope | 1
- | Trouble | 1
-----------------------------+---------------------------------------+--
-Cake | Comfort Eagle | 1
-----------------------------+---------------------------------------+--
-Carpenters | Close To You | 1
-----------------------------+---------------------------------------+--
-Carrie Underwood | Before He Cheats | 1
-----------------------------+---------------------------------------+--
-Daniel Caesar | Japanese Denim | 1
-----------------------------+---------------------------------------+--
-Darwin Deez | Radar Detector | 2
-----------------------------+---------------------------------------+--
-Death Cab For Cutie | I Will Posess Your Heart | 1
-----------------------------+---------------------------------------+--
-Dojo Cat | Say So | 1
-----------------------------+---------------------------------------+--
-Dr. Dog | Nellie | 1
- | Shadow People |10
- | Stranger | 2
- | The Beers/Shadow People | 1
- | The Breeze | 1
- | Twin Size/Shadow People/Beers | 1
-----------------------------+---------------------------------------+--
-Eurythmics | Sweet Dreams | 1
-----------------------------+---------------------------------------+--
-Eve 6 | Inside Out | 1
-----------------------------+---------------------------------------+--
-Father John Misty | Real Love Baby | 4
-----------------------------+---------------------------------------+--
-Fleet Foxes | White Winter Hymnal | 1
-----------------------------+---------------------------------------+--
-Foo Fighters | Learn To Fly | 1
- | The Pretender | 1
-----------------------------+---------------------------------------+--
-Goo Goo Dolls | Iris | 1
-----------------------------+---------------------------------------+--
-Gorillaz | Feel Good Inc. | 1
-----------------------------+---------------------------------------+--
-Harvey Danger | Flagpole Sitta | 1
-----------------------------+---------------------------------------+--
-Her's | Blue Lips | 6
- | Cool With You | 1
-----------------------------+---------------------------------------+--
-Herbie Hancock | Chameleon | 3
-----------------------------+---------------------------------------+--
-Jay Som | Baybee | 1
-----------------------------+---------------------------------------+--
-Jimmy Eat World | The Middle | 1
-----------------------------+---------------------------------------+--
-John Mayer | Moving On and Getting Over | 1
- | No Such Thing | 1
-----------------------------+---------------------------------------+--
-Joyce Manor | Last You Heard of Me | 1
-----------------------------+---------------------------------------+--
-Kanye West | Golddigger | 1
-----------------------------+---------------------------------------+--
-Kate Bollinger | I Don't Wanna Lose | 1
-----------------------------+---------------------------------------+--
-Kevin Devine | Cotton Crush | 1
- | I Could Be With Anyone | 1
-----------------------------+---------------------------------------+--
-Khalid | Talk | 1
-----------------------------+---------------------------------------+--
-Lake Street Dive | Call Off Your Dogs | 1
- | Hello Goodbye | 1
- | Hypotheticals | 5
-----------------------------+---------------------------------------+--
-Lenny Kravitz | Fly Away | 1
-----------------------------+---------------------------------------+--
-Mac DeMarco | My Old Man | 2
-----------------------------+---------------------------------------+--
-Mac Miller | What's The Use | 3
-----------------------------+---------------------------------------+--
-Manchester Orchestra | Bed Head | 3
- | Everything To Nothing | 1
- | I Can Barely Breathe | 1
- | I Can Feel A Hot One | 1
- | I've Got Friends | 4
- | Keel Timing | 3
- | Pride | 4
- | Shake It Out | 5
- | Telepath | 1
- | The Only One | 4
- | Tony The Tiger | 1
- | Virgin | 1
-----------------------------+---------------------------------------+--
-Matt | Original | 4
-----------------------------+---------------------------------------+--
-Matt and Alex | Original | 5
-----------------------------+---------------------------------------+--
-Men I Trust | Lauren | 6
-----------------------------+---------------------------------------+--
-Michael Jackson | Beat It | 1
- | Billie Jean | 1
-----------------------------+---------------------------------------+--
-Modern Baseball | Tears Over Beers | 2
-----------------------------+---------------------------------------+--
-Modest Mouse | Float On | 2
-----------------------------+---------------------------------------+--
-Natalie Imbruglia | Torn | 1
-----------------------------+---------------------------------------+--
-No Doubt | Don't Speak | 1
-----------------------------+---------------------------------------+--
-Omar Apollo | The Two of Us | 3
-----------------------------+---------------------------------------+--
-OutKast | Ms Jackson | 1
-----------------------------+---------------------------------------+--
-Paper Kites | Bloom | 1
-----------------------------+---------------------------------------+--
-Parcels | Tieduprightnow | 1
-----------------------------+---------------------------------------+--
-Peach Pit | Alrighty Aphrodite |11
- | Black Licorice | 1
- | Brian's Movie |10
- | Chagu's Sideturn | 2
- | Drop the Guillotine | 6
- | Peach Pit | 1
- | Shampoo Bottles | 2
- | Techno Show | 3
- | Tommy's Party | 1
-----------------------------+---------------------------------------+--
-Phish | Character Zero | 3
-----------------------------+---------------------------------------+--
-Portugal. The Man | Feel It Still | 1
-----------------------------+---------------------------------------+--
-Prawn | Why You Always Leave A Note | 1
-----------------------------+---------------------------------------+--
-Radiohead | Creep | 2
-----------------------------+---------------------------------------+--
-Rage Against The Machine | Killing in the Name | 1
-----------------------------+---------------------------------------+--
-Red Hot Chili Peppers | Can't Stop | 4
-----------------------------+---------------------------------------+--
-Ripe | Caralee | 1
- | Goon Squad | 1
- | Pretty Dirty | 1
- | Talk to the Moon | 1
-----------------------------+---------------------------------------+--
-Robbie Hunter Band | Que Paso? | 1
-----------------------------+---------------------------------------+--
-Sammy Rae | Jackie Onassis | 1
- | Kick It To Me | 2
-----------------------------+---------------------------------------+--
-Santana | Smooth | 1
-----------------------------+---------------------------------------+--
-Stone Temple Pilots | Interstate Love Song | 2
-----------------------------+---------------------------------------+--
-Sublime | Doin Time | 1
-----------------------------+---------------------------------------+--
-Sugar Ray | Every Morning | 2
-----------------------------+---------------------------------------+--
-Sure Sure | Good Thing | 1
-----------------------------+---------------------------------------+--
-Tame Impala | The Less I Know The Better | 2
-----------------------------+---------------------------------------+--
-The Beatles | I've Just Seen A Face | 1
- | With a Little Help From My Friends | 1
-----------------------------+---------------------------------------+--
-The Black Keys | Tighten Up | 1
-----------------------------+---------------------------------------+--
-The Cars | Just What I Needed | 1
-----------------------------+---------------------------------------+--
-The Dear Hunter | A Sua Voz | 3
- | Black Sandy Beaches | 1
- | Deny It All | 1
- | Girl | 1
- | Misplaced Devotion | 1
- | Progress/Therma | 2
- | Red Hands | 4
- | The Moon/Awake | 1
- | What it Means to Be Alone | 1
-----------------------------+---------------------------------------+--
-The Eagles | Hotel California | 1
-----------------------------+---------------------------------------+--
-The Front Bottoms | Cough It Out | 1
- | Flashlight | 4
- | Jim Bogart | 1
- | Legit Tattoo Gun | 2
- | Rhode Island |11
- | The Beers | 8
- | Twin Size Mattress |12
- | West Virginia | 1
-----------------------------+---------------------------------------+--
-The Head and The Heart | Honeybee | 1
- | Lost In My Mind | 2
- | Rivers and Roads | 2
-----------------------------+---------------------------------------+--
-The Raconteurs | Steady As She Goes | 1
-----------------------------+---------------------------------------+--
-The White Stripes | We're Going To Be Friends | 1
-----------------------------+---------------------------------------+--
-Theo Katzman | You Could Be President | 1
-----------------------------+---------------------------------------+--
-Third Eye Blind | Semi Charmed Life | 1
-----------------------------+---------------------------------------+--
-Three Doors Down | Kryptonite | 1
-----------------------------+---------------------------------------+--
-Tonic | If You Could Only See | 1
-----------------------------+---------------------------------------+--
-Twiddle | When it Rains it Poors | 1
-----------------------------+---------------------------------------+--
-USERx | Headsick | 1
-----------------------------+---------------------------------------+--
-Vampire Weekend | Flower Moon | 2
- | Sunflower | 4
-----------------------------+---------------------------------------+--
-Vansire | That I Miss You | 6
-----------------------------+---------------------------------------+--
-Vulfpeck | 1612 | 2
- | Animal Spirits | 1
- | Aunt Leslie | 3
- | Baby I Don't Know Oh Oh | 1
- | Back Pocket | 2
- | LAX | 1
- | Love is a Beautiful Thing | 1
- | Outro | 1
- | Wait For The Moment | 4
-----------------------------+---------------------------------------+--
-Weezer | Buddy Holly | 2
- | If You're Wondering If I Want You To | 1
- | The World Has Turned and Left Me Here | 1
-----------------------------+---------------------------------------+--
diff --git a/text-only.7 b/text-only.7
@@ -73,6 +73,11 @@ there too.
Of course, if you're curious to see how the bits come together,
I publish all of the site source at
.Lk https://git.alexkarle.com/alexkarle.com !
+.Sh UPDATE
+As of November 15, 2021, text.alexkarle.com was moved entirely to gopher.
+See
+.Xr burrowing 7
+for more info.
.Sh SEE ALSO
.Bl -bullet -compact
.It
diff --git a/welcome.txt b/welcome.txt
@@ -1,16 +0,0 @@
-Welcome to text.alexkarle.com!
-
-This is an experimental version of my main site (alexkarle.com)
-in text-only format. For maximum retro effect, I serve up this
-directory over HTTP, HTTPS, and Gopher.
-
-I've been serving txt versions of my mdoc(7) for a while over
-Gopher, but decided to formalize the subtree generation and serve
-it over HTTP after reading text.causal.agency, which you should
-totally check out. (aside: I'd like to state that I've been doing
-the whole mdoc(7) thing before I knew about causal.agency and am
-not a complete copycat (much respect, great minds think alike and
-all that) :) )
-
-I hope you enjoy your stay! If you think this is cool, don't
-hesitate to reach out: text@alexkarle.com
