Blog Static Site Generator

---

Overview

• Static Site Generator: Hugo + TypeScript + MD
• Linting: ESLint + StyleLint + RemarkLint
• Hosting: Cloudflare Pages

Usage

• Minimum Requirements
• Installation
• Development
  • Development Server
  • Linting
• Writing Blog Posts

Minimum Requirements

• Node 18

If you need help installing and/or managing Node and Yarn versions, check out NVM.

Installation

npm install && npm run prepare

• npm install installs the necessary node modules for development.
• npm prepare sets up the linting pre-commit hooks via husky.

Install Hugo

Homebrew (macOS)

brew install hugo

Debian / Ubuntu

It is recommended that you install the latest release of Hugo. For debian and ubuntu users, they offer a .deb file.

Other OS

See Hugo Installation

Install Embedded Dart Sass

Download Embedded Dart Sass and make sure it is in your $PATH. This is necessary for Hugo to process SASS and SCSS files. See the Hugo documentation for more information.

Development

Development Server

The development server watches files, rebuilds the site, and reloads the browser when files change.

hugo server

Linting

npm run lint

Writing Blog Posts

Blog posts are written using markdown, with each post corresponding to a markdown file in the /content directory, with subdirectories for the year and month of publication (e.g., /content/YYYY/MM).

You can learn more about how blog post files work and how they are formatted in the BLOG-POST-TEMPLATE.md file.