Site Info & SEO

Controls the site description and search engine crawler rules (e.g. Google, Bing).

Site description

Provide a short description for your site. It appears in search result previews and is also used as the RSS feed description.

Set in hugo.toml:

[params]
  # Note: Short site description.
  description = 'Tralume: a modern, lightweight, beautiful Hugo theme.'

Favicon

Tralume can output favicon links from params.favicon. Put the icon files in your site's static/ directory, then reference them with root-relative paths:

[params.favicon]
  icon = '/favicon.ico'
  svg = '/favicon.svg'
  appleTouch = '/apple-touch-icon.png'
  manifest = '/site.webmanifest'

Supported fields:

• icon: regular favicon, usually .ico or .png
• svg: SVG favicon for modern browsers
• appleTouch: iOS home screen icon
• manifest: web app manifest

Social share cards (Open Graph / Twitter Card)

Tralume outputs Open Graph and Twitter Card metadata automatically.

• Page-level front matter image has the highest priority
• Site-wide defaults can be set with params.seo.cardImage or params.seo.image
• If neither is set, the theme falls back to the site icon (appleTouch / icon) or a no-image card

Set a default share card image in hugo.toml:

[params.seo]
  # Note: Site-wide default social share card image.
  # Note: A 1200x630 image is recommended.
  cardImage = '/social-card.png'

To override the card image for a single page, add this to front matter:

+++
# Note: Overrides the share card image for this page only.
# Note: This takes priority over params.seo.cardImage.
image = '/posts/example/cover.png'
+++

Structured data author and publisher (JSON-LD)

Tralume outputs JSON-LD for the home page and article pages.

• Article pages can include author
• Home and article pages can include publisher
• publisher.logo can be set explicitly, and falls back to appleTouch or icon when omitted

Set site-wide author and publisher metadata in hugo.toml:

[params.seo.author]
  # Note: Default author name for article pages.
  name = 'AlexMa'
  # Note: Author profile or about page URL.
  url = 'https://example.com/about/'

[params.seo.publisher]
  # Note: Publisher name used in structured data.
  name = 'AlexMa\'s Blog'
  # Note: Publisher homepage URL.
  url = 'https://example.com/'
  # Note: Publisher logo image.
  # Note: Use a stable absolute URL or root-relative path.
  logo = '/publisher-logo.png'

To override the author for a single article, add this to front matter:

+++
# Note: Overrides the structured-data author for this article.
[author]
  name = 'Guest Author'
  url = 'https://example.com/team/guest-author/'
+++

Robots rules (robots.txt)

Tell search engines which pages they may crawl, and optionally disable crawling for the entire site (useful before a public launch).

Enable Hugo’s robots.txt generation at the top level of hugo.toml:

enableRobotsTXT = true

[params.robotsTxt]
  # Note: Whether to allow search engines to crawl.
  # If set to false, the whole site is disallowed (Disallow: /).
  enabled = true

  # Note: Whether to include the sitemap link in robots.txt.
  sitemap = true