$ show HugoBlox/hugo-theme-academic-cv
This repository is a Hugo-based starter template for building an academic CV website, part of the HugoBlox ecosystem. It provides pre-configured project structure, sample content (blog posts, publications, projects, courses, events, slides), and CI/CD workflows for deployment to GitHub Pages or Netlify. The codebase is primarily configuration (Hugo, YAML, Go modules, npm packages) and Markdown content, with minimal custom layout code (a single partial for a GitHub button). Its primary value is as a boilerplate for researchers and academics to quickly spin up a personal portfolio site. While it contains no complex application logic, it demonstrates solid engineering practices through well-structured configuration, modern build tooling (Tailwind CSS v4, Pagefind search), and reusable CI/CD patterns.
The LLM identified 4 files worth highlighting for reuse:
A reusable GitHub Actions workflow for building Hugo sites. It dynamically reads the Hugo version from hugoblox.yaml, sets up Node.js/pnpm, installs Tailwind dependencies, configures multi-layer caching (Go modules, node_modules, Hugo resources), runs Hugo build with minification, generates Pagefind search index, and uploads the artifact. This workflow can be extracted and adapted to any Hugo project with minimal changes.
A deployment workflow that checks the configured deploy host from hugoblox.yaml (supports github-pages, netlify, vercel, cloudflare, none) and only proceeds to GitHub Pages if that is the target. It demonstrates a clean pattern for multi-host deployment logic and can be reused across HugoBlox projects.
A well-structured YAML data file following the HugoBlox author schema (v1). It defines an academic profile with fields for name, status, role, bio, affiliations, links (multiple social platforms), interests, education history, experience, skills, languages, and awards. This schema is reusable across any HugoBlox-based site and demonstrates a clean, portable way to represent person data for a CV or portfolio.
A workflow that converts BibTeX files to Markdown publication pages using the Academic Python tool. It validates input, runs the conversion with compact/verbose flags, and creates a pull request with the generated content. This pattern can be reused by any academic site that publishes BibTeX-based references.