Set Preferred Language

Pocket Hugo theme natively supports over 10 language settings, including English, Chinese, Japanese, French, Spanish, Russian, German, Korean, Portuguese, Italian, and more. You can specify a preferred language in hugo.toml; this preferred language typically corresponds directly to the index.md file within the content directory.

languageCode = "en"
defaultContentLanguage = "en"

If you require a different site name and title for each language, you can configure them individually in hugo.toml.

[languages.en]
  languageName = "English"
  title = "Pocket Hugo"
  weight = 1

[languages.en.params.sidebar]
  subtitle = "A cover-driven theme for long-term personal writing"

Language Switching Settings

If you configure two languages, you can switch between them with a single click using a button located in the website header and below the in-text table of contents. If you configure three or more languages, a dropdown menu will be enabled by default in the website header.

  [params.languageSwitcher]
    headerSelectThreshold = 3

• Responsive Image Pipeline Demo
• Shortcodes Demo

What this feature is for

Use a title card when you want the article to look complete in lists and single pages, but you do not want to prepare a real image file for every post.

That is especially useful for:

• notes and short essays
• documentation pages
• multilingual pages that should share a consistent visual rhythm
• sections where text-first cards feel more natural than photo covers

Quick start

In front matter, the simplest form is just one letter:

coverCard: "a"

Rules:

• a to h: the 8 light presets
• A to H: the 8 dark presets
• any other value: falls back to an automatic random preset

If you set coverCard, the theme will use the generated title card and stop using image.

Hide the repeated list title

If you only want the title to appear inside the card on homepage, taxonomy, archive, and other list-style pages, add:

listTitle: false

That will hide the repeated title in list cards. On single pages, if the page is using a generated title card, it will also hide the separate title block there.

If you want to change this site-wide, use params.article.listTitle = false in hugo.toml. That site-level switch only affects generated gradient cards in list pages, not normal image covers.

Example front matter

title: "My Article"
date: 2026-02-09T08:30:00+08:00
slug: "my-article"
coverCard: "C"
listTitle: false

All 16 presets

The presets below follow the built-in order used by the theme.

When to use which preset

• a / A: warm and editorial, good for essays and personal writing
• b / B: softer and more friendly, useful for tutorials or documentation
• c / C: stronger contrast, good for product or release notes
• d / D: muted and calm, fits archive-like or reflective writing
• e / E: lively and fresh, useful for tools, workflow, and updates
• f / F: neutral and restrained, good for technical references
• g / G: clearer and more digital, useful for software and platform topics
• h / H: monochrome and minimal, good for terse notes or index pages

Default behavior

If the page does not define coverCard, the theme falls back to the site-level cover rules in hugo.toml.

That means a user can also do nothing at all and still get a generated title card by default. When the theme fallback is set to gradient mode, the card preset is assigned automatically.

That means you can combine both strategies:

• use a global fallback mode for ordinary posts
• set coverCard only on the pages where you want a specific preset

One practical recommendation

Start with the automatic fallback for the site, then manually assign letters only to pages that you want to feel more deliberate. That keeps authoring fast while still giving important pages a distinct look.

Multilingual Long-form reading Cover-driven

What the theme cares about

Many themes look fine when a site is small, but start to drift once the content grows: article pages and fixed pages feel unrelated, language switching becomes awkward, cover cards lose consistency, and mobile reading gets cramped. Pocket Hugo Theme tries to keep those details coherent.

Best fit

Theme rhythm

Why it fits this demo

This example shows the theme describing itself without turning into documentation-only copy. The page still reads like a project profile rather than a config reference.