About this site

org hugo

In which I give the requisite grandiloquent soliloquy about how this site is made.

Purpose and intent #

Many times in the past I have attempted to make a “web site” that is somehow about me. This is the latest. Time will tell if it survives.

This site is intended as an outlet for:

  • Detailed responses to technical inquires that might otherwise go into an individual email message. Seeking “efficiency” (laziness) I may instead turn a response into a blog post or a more formal article (such as howido). Where applicable, some things already land in Wire-Cell News posts.

  • I want a way to distribute information which has some amount of independent from my employer be it related to physics, software or other topics not appropriately served from a .gov address. Thus, this site will not be served from my BNL web area (which I mostly use for random file distribution, especially in a very permanent tmp/).

  • Remembering all my past activities is becoming a chore and noting them down will hopefully make that easy. Thus some posts may be rather boring, as they will be literally web logs. They will be kept distinct from more interesting items in some manner (likely in a “notes” section).

  • When solving problems I tend to talk to myself using fingers typing instead of lips flapping. Putting these thoughts on this help me focus them and find them later. Maybe. I also tend to revisit so expect you may see here to change over time.

Organization #

Following Hugo nomenclature the site is organized first by sections. Sections are interpreted as a type or a form of page. The following sections may be found:

about
meta descriptions (ie, this site),
posts
short “blog” entries, unlikely to (but may) see updates,
articles
long form on a topic and potentially updated over time.
notes
things likely more interesting to myself than others which is meant to summarize or simply mark some occurrence.

All pages in these sections may have one or more category or tag. In Hugo these are both taxonomies. They are provided by Hugo with no assumed interpretation and so these are taken:

categories
A limited number of general descriptors defined in a top-down manner. These label the basic topical subject of the page independent of its section.
tags
Numerous, unbound set of detailed descriptors defined in a bottom-up manner as pages are written. These label aspects of the content regardless of category or section.

Tech #

This blog uses GNU Emacs Org Mode with ox-hugo to make content for Hugo. See howido if interested in details of my personal computing configuration. The source to this site is in my pub repo and though not likely interesting to humans the exported HTML lands in this repo.

Todo #

templates #

  • Basic RSS feeds, these are out-of-the-box
  • Full content RSS feeds.
  • Two RSS feed variants: ordered by pub date and by last modified date
  • per heading anchor links (as ripped from hugo-onyx-theme)
  • customize notes list.html
  • sidebar with recents, tags, categories
  • home page with tagclouds and most recent of each section

deploy #

  • Deploy to my github
  • Deploy to local public_html
  • Deploy to my BNL via rsync wontfix
  • automate deployment
  • some kind of comments system? maybe offload to github discussions with auto thread start based on a deploy? using GH API and hub? there’s a topic for a post.

editing #

  • org mode capture templates
  • org capture for notes