yann64andClaude Opus 5.5
32b735283e
- forum/extension: oc:import command (archived comments -> one thread per machine) and embed styling - forum/docker: local Flarum 2 test stack - site: optional params.forum.url adds a Forum menu entry and shows the machine thread in the Comments tab Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YDRjtmAiNpo5mK5N3d7QwZ
3.3 KiB
old-computers.com — static site
Static rebuild of old-computers.com with Hugo (0.158 or newer, tested with
0.167). The content is recovered from the Wayback Machine by the extraction repository
(../oc), which generates part of this one.
| Path | Origin |
|---|---|
content/{museum,machine-tabs,companies,software,history,magazine,fun}/ |
generated, replaced on every make content |
static/media/ |
generated (copied images and documents) |
data/slugs.json |
generated, keeps URLs stable between runs — do not delete |
content/post/ |
written by hand: news posts, see below |
data/forum.json |
machine → forum thread map, written by the forum import (absent = no forum) |
forum/ |
forum extension, local test stack, install notes |
content/_index.md, layouts/, assets/, hugo.toml, tools/ |
written by hand |
build/, public/ |
build output (make build, hugo server), not versioned |
Content pages are Markdown with YAML front matter and can be corrected by hand, but a later
make content overwrites them: lasting fixes belong in the extraction repository.
Posts
make post NAME=my-title
creates content/post/<today>-my-title.md (any .md file in content/post/ is a post). The
date comes from the file name unless date: is set; author: is optional; the name
links to /author/<name>/, which lists all posts by that author. For a banner, put an
image under static/media/ and set banner: /media/....jpg (image: works too). Write the text in Markdown and
remove draft: true to publish. The most recent posts (homePosts in hugo.toml, 5 by default) appear on the home page with their
banner, date, author and summary (summary: in the front matter, or the text before
<!--more-->, or the first lines); all posts are listed under News and on each
author's page, listPosts per page (20 by default). Posts are never touched by
make content.
Search
Search runs in the visitor's browser on an index generated by Pagefind
at the end of make build (fetched by npx, so Node.js is needed to build). The header box
sends to /search/, where results can be filtered by section. Content pages are indexed
(data-pagefind-body on <main> in layouts/baseof.html); lists, taxonomy pages and the
visitor-comments tabs are not. hugo server has no index: use make build and serve build/
to try the search locally.
Forum and comments
A Flarum forum can run next to the site and serve as its comment system:
with params.forum.url set in hugo.toml, the menu gets a Forum entry and the Comments tab of
each machine shows that machine's forum thread (archived comments first, new replies after).
With the url empty the site has no forum and shows the archived comments as static text.
Everything about the forum is in forum/README.md.
Usage
make content # regenerate from ../oc (OC=path to use another location)
make build # build into build/, with the search index
make check # build + verify every internal link and image
make serve # preview on http://localhost:1313
make deploy # build and copy to the test server (share must be mounted; see DEPLOY_DIR/DEPLOY_URL)
The site uses relative URLs, so public/ can be served from any directory of a web server.