This repository uses Hugo to build jrhoun.com.
Checkout the site by running: git clone https://github.com/jrhoun/jrhoun.com.git
The site's theme is incorporated in the repo as a git submodule. See https://github.com/jrhoun/jrhoun.com/tree/master/themes. Cloning the repo does not automatically also checkout the submodule. In order to checkout the submodule run the following command in the root project directory:
git submodule update --init --recursive
Your repo should now have everything checked out.
On Windows I used Chocolatey to install using gitbash.
choco install hugo
More recently I've begun using WSL2 + Ubuntu. To install:
sudo apt install hugo
Build and run the site locally with live updates by running:
hugo server -D
The site is accessible at localhost:1313.
See conf.toml for site configuration details.
The site uses a fork of the hugo-vitae theme as a base.
The fork is here and has a two notable patches:
- Ensure that the full content of a blog entry appear in the RSS feed. This patch was made primarily to enable automated newsletter generation using TinyLetter.
- Enable symbols to be used in markdown links
jrhoun.com is hosted using netlify.com and is configured to use Continuous Deployment. When new changes are pushed to the jrhoun/jrhoun.com master branch, Netlify automatically fetches the repo, builds the site using the hugo command, and publishes the updated site files (usually within minutes).
The jrhoun.com is currently managed at hover.com.
I'm still figuring this part out. The site's content is mostly going to be blog posts so new posts are added to the /content/posts/ directory
To create a new blog post:
hugo new posts/[blog-title-here].md
This will create a new .md in the /posts/ directory with title date, and draft status metadata.
To enable users to receive emails with blog content, I setup an automated job with Zapier that monitors the blog's RSS feed for updates and then pushes new blog content to connected TinyLetter account. The content appears as a draft that can be manually or automatically sent as a newsletter to subscriber's emails.