Hugo Future Imperfect Slim

Tracey Jaquith 路 PoohBot Pictures

Technophile 路 Optimist 路 CyclistArchivist 路 Design 路 Video 路 TV 路 Kubernetes 路 Docker

3 minutes read

this post source - in markdown

things turning me on this week
鈽昬njoy with a hot cupa java/script
I’m now migrating off of WordPress and a paid web hosting plan, to a free* website using **Hugo** and **GitLab**. It nicely leverages **markdown** and makes posting content from an editor a breeze. Your entire website is in a **git** repository – so you can take your entire website anywhere and have a full copy on your laptop (even with networking off). **No database**!

For me, suddenly writing felt more like writing again - and I get to have full copies of everything (with any luck, the site should last forever..)

Static Site Generators

Basically, instead of a server-side scripting language-based website (like PHP or python) - these kind of websites have you writing basic HTML. But versions like Jekyll and Hugo, um, go, a step further. They have you write in a much more natural way, using MarkDown.

They get cute by having a ‘production’ step that prepares your site and does some light transforms of your pages into a new /public/ subdir (that your pages serve from), converting markdown to HTML (AKA markup). It sums up your ‘tags’ and ‘categories’ and makes static simple pages based on them, eg: /categories/coding/. It uses your “number of posts per page” variable to auto-paginate and make static simple pages like: /page/2/ or /tags/biking/page/2/.

They also can get clever about user comments - allowing Discus or ‘staticman’ as ways to get comments into your site and onto your pages. I chose staticman because my code repository will get the comments (instead of being stored in some external service).


Hugo is a blisteringly fast alternative to Jekyll, based on the superfast (and quite new) Go language (more like C language in terms of speed, statically typed, and compiled). My older brother suggested it after noting his similar blog of 10years+ of entries was taking minutes to build in Jekyll - but seconds with Hugo.

Setup Hugo

You can quickstart very.. quickly! There’s a bunch of themes you can pick from - I chose the one below.

Deploy to the world

You can use GitLab or GitHub - I prefered GitLab because I use its build process at work and it has the quickest/easiest stup. They want your business, and will host it for free. You setup an account, and git push your laptop directory of files to them. Everything re-deploys automatically ever time you git push an update - easy!

(*) You can get your own hostname and point it to your GitLab (or GitHub) site url for a nicer URL, for about $20/year

Say something


da pooh's Gravatar

da pooh

wow, i really wish i was someone like tracey. so funny and smert.
dvd's Gravatar


thank you for this tutorial! as you may have noticed, my current HTML authoring toolchain strategy is unsustainable.

Recent posts

See more



#spottheshuttle 1940s 1st-person 3d accident aids-lifecycle airplane animals appeltart apple-pie apple-watch architecture arkit art ascii-art asia augmented-reality baking bali bay-area biking birthday cafe-racer camaro camera-video cars cat-pee cat-psychology cats coding college colorspaces computer-vision cornell crictl css dark-mode decaf deinterlace desert design diy docker documentary ducting emacs endeavour family ffmpeg food games geek gitlab golden-gate-bridge google-cardboard green-magic-man h.264 hack highway-1 home https hugo hyperlapse internet-archive ios iphone javascript k3s kubernetes landscapes linux lisp luke-battling-darth mac macosx mashup metal montclair motion-jpeg motorcycle mplayer nasa new-bay-bridge news ninja oakland partioning php php-htm-mode politics protest rancher recording remaster remix remodel shuttle small-town star-wars swift technical time-lapse time-machine timing-belt-adjustment top-end-rebuild tracey traefik training-ride vacation valve-job video virtual-reality vlog vscode weekend-mechanic work x264 xcode yuvj420p zx6


tracey is a nonstop dance party. so you dont have to. dont ask me about k8s. thanks for dropping by today. you look nice.