Sherpearce Portfolio Website

A Hugo-based personal portfolio website featuring a terminal window chrome design, inspired by Glim Midnight and ReTerminal.

Features

• Terminal Window Chrome Design: Whole-site terminal window wrapper with traffic light dots, dark theme, and blue accent colors
• Monospace Typography: Clean, terminal-inspired font styling
• Content Sections:
  • Home page with introduction and featured links
  • Portfolio section with subsections (Visuals, 3D Renders, Overlays & Transitions)
  • Games section with listings and individual game pages
  • Resume page with PDF download support
• Hugo Shortcodes:
  • itch: Embed itch.io games via iframe
  • playgame: Embed browser-playable games from /static/play/

Prerequisites

• Hugo Extended (v0.121.0 or later)

Quick Start

Local Development

1. Clone the repository:

git clone https://github.com/Sherpearce/Sherpearce.github.io.git
cd Sherpearce.github.io

2. Run the Hugo development server:

hugo server

3. Open your browser to http://localhost:1313

Build for Production

Build the static site:

hugo --gc --minify

The site will be generated in the public/ directory.

Content Structure

content/
├── _index.md              # Home page
├── resume.md              # Resume page
├── portfolio/
│   ├── _index.md         # Portfolio listing
│   ├── visuals.md
│   ├── 3d-renders.md
│   └── overlays-transitions.md
└── games/
    ├── _index.md         # Games listing
    └── example-game.md   # Individual game page

Adding Content

Portfolio Items

Create a new markdown file in content/portfolio/:

---
title: "My Project"
description: "A brief description"
---

# My Project

Project details here...

Games

Create a new markdown file in content/games/:

---
title: "My Game"
description: "A brief description"
---

# My Game

Game details here...

## Embed from itch.io

{{</* itch url="https://itch.io/embed/your-game-id" height="600" */>}}

## Embed Browser Version

{{</* playgame path="my-game" height="600" */>}}

For browser-playable games, place your game files in static/play/your-game-folder/.

Resume PDF

Place your resume.pdf file in the static/ directory to make it available for download.

Customization

Site Configuration

Edit hugo.toml to customize:

• Site title
• Base URL
• Menu items
• Accent color

Styling

Edit themes/terminal/static/css/style.css to customize:

• Colors and theme
• Typography
• Layout and spacing
• Terminal chrome appearance

Deployment

The site includes a GitHub Actions workflow (.github/workflows/hugo.yml) that automatically builds and deploys to GitHub Pages when changes are pushed to the main branch.

GitHub Pages Setup

1. Go to your repository Settings → Pages
2. Set Source to "GitHub Actions"
3. Push to the main branch to trigger deployment

Shortcode Reference

itch.io Embed

{{</* itch url="https://itch.io/embed/game-id" height="600" */>}}

Parameters:

• url: Full itch.io embed URL (required)
• width: Width of iframe (default: "100%")
• height: Height of iframe (default: "600")

Browser Game Embed

{{</* playgame path="game-folder" height="600" */>}}

Parameters:

• path: Path to game folder in /static/play/ (required)
• width: Width of iframe (default: "100%")
• height: Height of iframe (default: "600")

License

Apache License 2.0 - see LICENSE file for details