hugo-profile

Hugo Profile Wiki

Welcome to the end-to-end documentation for Hugo Profile, a high-performance, mobile-first Hugo theme for personal portfolios and blogs.

These pages live in the wiki/ folder of the repository so they are versioned with the theme. Every file is named like a GitHub Wiki page, so the folder can be copied as-is into the repository’s .wiki.git to publish it on the GitHub Wiki tab.

Feature overview

Area What you get Page
Homepage Hero, About, Experience, Education, Projects, Achievements and Contact sections, each individually switchable Homepage Sections
Navigation Sticky navbar, brand logo/name, custom and dropdown menus, built-in search Navigation and Search
Extra pages Standalone pages, new sections, about layout, menu links Multi-Page Sites
Blog Lists, single posts, table of contents, tags, reading time, scroll progress, social sharing, comments Blog and Content
Gallery Image gallery with lightbox viewer Gallery
Projects Optional project pages that also appear on the homepage Project Pages
Look and feel Light / dark / auto theme, colour variables, fonts, animations Color Customization
Multilingual English, Spanish and French built in; add your own Internationalization
Footer Recent posts, social links, copyright Footer
Integrations Google Analytics, Disqus, Formspree, MathJax, Cloudinary, Bootstrap CDN Integrations
Extending Custom CSS, custom scripts, layout overrides, shortcodes Advanced Customization
Ship it Netlify, GitHub Pages, any static host Deployment
  1. Installation – get a site running.
  2. Configuration Reference – every hugo.yaml option in one place.
  3. Homepage Sections, Multi-Page Sites and Blog and Content – fill in your content.
  4. Color Customization and Advanced Customization – make it yours.
  5. Deployment – publish.

Stuck? See Troubleshooting or open an issue.

Repository layout

hugo-profile/
├── archetypes/default.md     # Template used by `hugo new content`
├── exampleSite/              # Complete demo site (hugo.yaml, content, static assets)
├── i18n/                     # Built-in translations: en.toml, es.toml, fr.toml
├── layouts/
│   ├── index.html            # Homepage (assembles the section partials)
│   ├── 404.html              # "Page not found" page
│   ├── _default/             # baseof, list, single, about, gallery, index.json (search index)
│   ├── projects/list.html    # List layout for the `projects` content type
│   ├── partials/             # head, scripts, head/extensions and sections/*
│   └── shortcodes/           # dynamic-img (Cloudinary)
├── static/                   # Theme CSS, JS, Bootstrap 5, Font Awesome 6, viewer.js, 404 image
├── netlify.toml              # Netlify build for the demo site
└── theme.toml                # Hugo theme metadata
This site is open source. Improve this page.