Personal blog / developer notes, hosted on GitHub Pages. Built with Hugo and the Maverick theme.

• Hugo (extended version recommended), e.g. 0.135+
• Git (the theme is a submodule)

brew install hugo

Check:

hugo version

1. Clone the repo (with the theme submodule):

   git clone --recurse-submodules https://github.com/hirisave/pages.git
   cd pages

   If you already cloned without submodules:

   git submodule update --init --recursive

2. Start the dev server:

   hugo server -D

   -D includes draft posts. Omit it to hide drafts.

3. Open in the browser:

   • Site: http://localhost:1313/pages/
   • Posts: http://localhost:1313/pages/posts/
   • About: http://localhost:1313/pages/about/

   Hugo will use a base URL for localhost, so links stay on your machine. The server watches for changes and reloads automatically.

4. Stop the server: Ctrl+C in the terminal.

To generate the static site (e.g. for GitHub Pages):

hugo

Output goes to the public/ directory. The repo’s GitHub Action (see .github/workflows/deploy.yml) builds from this and deploys to GitHub Pages.

New posts: add a .md file under content/posts/ with front matter (title, date, tags).