Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gurusabarish/hugo-profile/llms.txt

Use this file to discover all available pages before exploring further.

The hero section is the full-viewport banner at the top of your portfolio site — the first thing every visitor sees. It displays your intro line, name, tagline, a short paragraph, a profile image, an optional resume button, and a row of social media icons. All hero configuration lives under params.hero in your hugo.yaml.

Enable the section

params.hero.enable
boolean
default:"false"
Set to true to render the hero section on your home page.

Text content

params.hero.intro
string
Small label rendered above your name. Typically a greeting such as "Hi, my name is".
params.hero.title
string
Your name, displayed as a large heading in the theme’s primary color. Include trailing punctuation if you like (e.g., "Isabella.").
params.hero.subtitle
string
A short tagline rendered beneath your name (e.g., "I build things for the web").
params.hero.content
string
A paragraph of descriptive text. Supports Markdown, so you can include bold, italic, or links.

Image

params.hero.image
string
Path to the hero image displayed on the right side of the section (e.g., /images/hero.svg). Accepts any path relative to the static/ directory or an absolute URL.
params.hero.roundImage
boolean
default:"false"
When true, applies a rounded-circle CSS class to the hero image, making it circular.
params.hero.bottomImage.enable
boolean
default:"true"
Toggles a decorative dot-grid SVG placed at the bottom-left of the hero section. Visible on medium screens and larger.

Resume button

params.hero.button.enable
boolean
Set to true to show a call-to-action button beneath the content paragraph.
params.hero.button.name
string
The label displayed on the button (e.g., "Resume").
params.hero.button.url
string
The URL the button links to. Use a relative path such as /resume.pdf to serve a file from your static/ directory, or any external URL.
params.hero.button.download
boolean
When true, adds the HTML download attribute to the link, prompting the browser to download the file instead of navigating to it.
params.hero.button.newPage
boolean
default:"true"
When true, opens the button link in a new browser tab (target="_blank"). Set to false to open in the same tab.
Social icons are rendered in a row next to the resume button. You can use Font Awesome icons, custom image icons, or both.
A list of social link objects using Font Awesome class names. Each object accepts:
KeyTypeDescription
iconstringFont Awesome class string (e.g., fab fa-github)
urlstringLink destination URL
A list of social link objects using custom image files instead of Font Awesome. Each object accepts:
KeyTypeDescription
iconstringPath to the icon image (e.g., /images/icons/myicon.png)
urlstringLink destination URL
Icons whose url begins with # are treated as same-page anchors and will not open in a new tab, regardless of other settings.

Complete example

params:
  hero:
    enable: true
    intro: "Hi, my name is"
    title: "Isabella."
    subtitle: "I build things for the web"
    content: "A passionate web app developer. I tend to make use of modern web technologies to build websites that look great, feel fantastic, and function correctly."
    image: /images/hero.svg
    bottomImage:
      enable: true
    # roundImage: true  # Make hero image circular | default false
    button:
      enable: true
      name: "Resume"
      url: "#"
      download: true
      newPage: false
    socialLinks:
      fontAwesomeIcons:
        - icon: fab fa-github
          url: https://example.com
        - icon: fab fa-x-twitter
          url: https://example.com
      customIcons:
        - icon: /fav.png
          url: "https://example.com"
The hero section supports per-language overrides. Place any of the text fields (intro, title, subtitle, content, button.name) under the language-specific params.hero block in your languages configuration to display translated content for each locale. See the i18n documentation for details.

Build docs developers (and LLMs) love