# pablotron.org ## Overview [Hugo][] backend for [pablotron.org][]. Content is divided into three [sections][]: |Section Type|Description|Permalinks| |------------|-----------|---------| |`posts`|Blog entries.|`/YYYY/MM/DD/SLUG/`| |`articles`|Long-form articles.|`/articles/SLUG/`| |`projects`|Programming projects.|`/SLUG/`| The 10 most recent `posts` are shown on the home page blog in reverse chronological order. A list of all `posts`, grouped by year, is shown on the [archive][] page in reverse chronological order. `articles` are long-form content that doesn't fit nicely as blog posts. `projects` have a repository link and a brief description. Eventually I may add more information (release history, signatures, etc). ## Usage The `bin/new` script allows you (me) to quickly create new content by: 1. Expanding a section template ([Hugo][] calls these templates "archetypes") draft content. 2. Opening the draft content in your editor. ## Add Post To add a new post: # easy version bin/new post some-blog-post # longer version hugo new --editor $EDITOR posts/$(date +%Y-%m-%d)-some-blog-post.md ## Add Article To add a new article: # easy version bin/new article some-article # longer version hugo new --editor $EDITOR articles/some-article.md ## Add Project To add a new project: # easy version bin/new project great-project # longer version hugo new --editor $EDITOR projects/great-project.md ## Edit Navbar Menu To add or edit navbar menu entries: # edit navbar menu entries vim data/menu.yaml ## Serve Locally To serve this site locally: # serve hugo locally on port 1313 hugo serve --minify --disableFastRender **Notes:** * `--minify` generates minified HTML, and [`html/template`][html-template] is aware of `
` and `` so
  inline code blocks work correctly.
* `--disableFastRenderer` may be unnecessary, but the fast
  renderer cache was giving me grief while doing theme development.

## Deploy Site

To deploy to production site:

*TODO*

# Theme

The current theme is `hugo-pt2021` and is stored in this repository as
`themes/hugo-pt2021`.

`hugo-pt2021` is depends on the following:

* [Bulma 0.9.3][bulma]: CSS framework.
* Several icons from [Feather Icons][feathericons].

The [Bulma][] [SASS][] is:

1. Stripped of extraneous styles.  See `assetes/style.sass`.
2. Combined with a small amount of `pt2021`-specific styling.  See
   `assets/style.sass`.
2. Converted from [SASS][] to [CSS][], minified, and fingerprinted
   using [Hugo Pipes][hugo-pipes].  See `layouts/partials/head.html`.
3. Written to `public/style.$HASH.css`.

[hugo]: https://gohugo.io/
  "hugo static site generator"
[sections]: https://gohugo.io/content-management/sections/
  "content sections"
[pablotron.org]: https://pablotron.org/
  "the hottest site on the net"
[archive]: https://pablotron.org/archive/
  "post archive"
[bulma]: https://bulma.io/
  "modern CSS framework"
[feathericons]: https://github.com/feathericons/feather
  "beautiful open source icons"
[hugo-pipes]: https://gohugo.io/hugo-pipes/
  "hugo asset processing pipeline"
[sass]: https://sass-lang.com/
  "Syntactically Awesome Style Sheets"
[css]: https://en.wikipedia.org/wiki/CSS
  "Cascading Style Sheets"
[go]: https://golang.org/
  "Go programming language"
[html-template]: https://pkg.go.dev/html/template
  "Go's built-in HTML template renderer"