Sites

Overview

Paper

Paper is a blog which will (potentially) have many random writeup of my various shenanigans.

It uses a theme called Papermod

Posts

Create a new page by using hugo

hugo new posts/<name>.md

A full range of configuration options for the theme can be found here

Themes

Themes need to be initialized by generating a css file via the Hugo CLI:

# For example, generate a theme 
hugo gen chromastyles --style monokai --highlightStyle 'bg:#474733' > assets/css/extended/monokai.css

A full list of themes can be viewed here

LZ

LZ is a landing zone for displaying social links, it uses a neat theme called Lynx.

Developing

Install the Hugo Integration for Jetbrains IDE's will allow you to leverage run configurations stored in the project, as well as hot reloading. This is optimal for Windows as WSL does not yet support filewatching nicely yet.

Otherwise, you can bring up the sites with the provided Docker Compose configuration.

docker-compose up -d

# LZ
# http://localhost:1313 
# Paper
# http://localhost:1414

Deployment

Github pages used to heavily rely on serving your site based on a specific branch name, but has since moved to Github Actions.

Along with the change has come a recommended set of starter workflows curated by the wonderful people at Github. The Hugo workflow builds and publishes the static content with a Github action instead.

TODO?

Schema for resume?

https://jsonresume.org/schema/