Joel Van Eenwyk

These are the pages and source for joelvaneenwyk.github.io.

This is the source code for the homepage of Joel Van Eenwyk (https://www.joelvaneenwyk.com). Going open source was not my original plan for this, but there are a lot of benefits to doing this. Perhaps my favorite reason being continuous integration (CI) support for free if hosted on a public repository.

The staging branch is also deployed automatically to Heroku at jvaneenwyk.HerokuApp.com.

Structure

• 📁 content - Markdown files and the text content of the site.
• 📁 static - Assets not intended to change e.g., stylesheets, images, etc.

Principles and Guidelines

Based on the previous version of this site, there were a lot of learnings. The primary take-away is that the previous site was too complicated. This was especially apparent when trying to go back and revise/update it. This is in part poor documentation but also just relying on unreliable technology. Unfortunately, in the world of the web this is hard to avoid -- it moves at an incredible pace and technology you choose will get deprecated and replaced by something that may or may not be production ready.

1. Use only statically typed languages i.e., no JavaScript
2. Everything in the project must be linted
3. CI must be enabled from the start
4. Architecture must be well documented

Keep it simple.

Build and Run

1. Install Hugo
   • Recommend using Scoop on Windows
2. Install Heroku CLI
3. From the root, run heroku git:remote -a jvaneenwyk so that the app name is assigned
4. Install NodeJS
5. Install Yarn
6. Run yarn install
7. Run yarn start or just hugo server

Windows Setup

1. Install Scoop. Open a PowerShell terminal (version 5.1 or later) and run:

   # Optional: Needed to run a remote script the first time
   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   irm get.scoop.sh | iex

2. Install Hugo: scoop install hugo-extended

3. Start Hugo server: hugo server

Resources

• 🔒 jvaneenwyk | Heroku