willcarh.art

Portfolio  |  Blog  |  Custom SSG

willcarh.art is Will Carhart's personal porfolio website, blog, and custom static site generator. It is built from scratch using Node.js and standard web technologies, and is hosted via Netlify.

Custom Static Site Generator

willcarh.art is a statically generated site. It uses a custom Node.js generator to replace template HTML with content sourced from markdown files. If you'd like to understand my motivation for writing my own static site generator, please check out the blog post. In addition, please see the markdown to HTML converter, marq.

Using the generator

Before starting, you'll need Node.js and Yarn. You can install them via Homebrew with brew install node and brew install yarn.

To start a new build, use the forge. Dependencies will be auto-resolved upon first build attempt.

./forge --help

forge - build pages for willcarh.art

Usage:
forge [-h] [-b] [-d] [-s] [-v]
  -h, --help      Show this menu and exit
  -b, --browser   Open the newly built website in a new browser window
  -d, --develop   Hardlink hrefs to .html files instead of URL paths (required for local builds)
  -s, --silent    Silence build output
  -v, --verbose   Show generated files as a result of forge

Create a new development build with ./forge --develop --verbose.

👉  Building redirects...
🖋  Building scripts...
💄  Building styles...
🏠  Building home...
🗄  Building vault...
🏃‍♂️  Building demos...
💁‍♂️  Building about...
📖  Building blog...
🏗  Building projects...
👓  Building etc...
🤬  Building 404...
✨  Done in 0.647 seconds

If you take a look in netlify.toml, you'll see that the production build does not use development mode when running the forge: ./forge --verbose.

About the website

willcarh.art was born out of my desire to have my own slice of the internet. It's changed over the years as I've coded more things. I hope you enjoy your visit 😊

Have questions or comments about the site? Shoot me a note:

      📫 hello@willcarh.art

Color palette

Like my theme? Here are the hex values. You can also find these on the etc page.	Color	Light Mode	Dark Mode
Main Background	#ecf0f1	#292929
Detail Background	#bdc3c7	#34495e
Main Text	#252323	#ecf0f1
Detail Text	#6a6c6e	#8895a1
Color	#e67e22	#6642ac

Licensing

All of the generator code found in generator/ is licensed under the MIT License, meaning you can use the generator to generate your own website without attribution and for commercial purposes. However, all other content of the site is licensed under the Creative Commons BY-NC 4.0 License, meaning you can share and adapt the website content if you provide attribution and do not use it for commercial purposes. See LICENSE.md.

Etc.

This repository is for the most recent version of willcarh.art. For information on v1, please see the v1 repository.

Understanding this respository

The forge (forge, generator/generator.js) generates webpages based on HTML, CSS, and JS templates. When a new version of the site is generated, the forge utilizes the files in generator/ to build valid webpages and components in src/ (not checked into Git). It pulls templates from these directories:

• templates/ - template HTML files for building the webpages in src/
• js/ - template JS files to be included in src/
• snippets/ - HTML and JS snippets from which to build content, used repeatedly throughout the website

And populates them based on files in from content/. In addition, static assets are linked from these directories:

• css/ - static css files
• font/ - static font files
• ico/ - static icon files