HugoPortfolioBlog

hugo-tifrueh — Hugo Portfolio Template

By tifrueh

A Hugo theme module for personal websites and blogs, providing site parameters such as author information, copyright, and RSS metadata, along with book-style layout options.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-12View source

What stands out

A quick read of the recorded project description.

01

Site parameters can configure author, editor, webmaster, copyright year and entity, as well as GitHub and Mastodon links

02

Page-level parameters support book-style layout, drop-cap, and math formula loading

03

Blog section pages automatically enable book-style layout and drop caps, and additionally support the table-of-contents parameter

04

RSS and Atom templates pull articles from the blog section, and editor and webmaster information is used for feed metadata

05

The README explicitly states that the three top-level pages /subscribe/, /contact/, and /legal-information/ are hard-referenced

Template Details

This is a Hugo theme module written by the author for a personal website, released publicly under the MIT license. The theme organizes content around personal site and blog scenarios: site-level parameters cover author, editor, webmaster, copyright, and social links, while page-level parameters control book-style layout, drop caps, and math formula loading. The README states that the three top-level pages /subscribe/, /contact/, and /legal-information/ are hard-referenced in multiple places and should be retained; the blog section is technically optional, but the RSS and Atom templates by default pull articles from that section, and pages within it forcibly enable book-style and drop-cap, which cannot be disabled. The theme's configuration merge mainly involves two groups of settings: markup.highlight and outputFormats.rss.

HugoPortfolioBlog

Is it right for your project?

Use Cases

  • Building a personal website and publishing blog posts
  • Writing scenarios that require per-page control of book-style layout and drop caps
  • Sites that need to provide author, editor, and webmaster metadata for RSS/Atom subscriptions
  • Personal projects that wish to use and modify the theme code under the MIT license

Suitable For

  • Developers building personal websites or blogs with Hugo
  • Authors who need site-level and page-level parameters to control layout details
  • Sites that accept retaining the fixed pages /subscribe/, /contact/, and /legal-information/
  • Sites that use the blog section as the article source and rely on RSS/Atom output

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    The README does not provide installation steps; the repository must be included in the usual way for a Hugo theme module

  2. 2

    The three top-level pages /subscribe/, /contact/, and /legal-information/ must be created, otherwise multiple hard references will fail

  3. 3

    The blog section is technically optional, but the RSS and Atom templates by default pull articles from that section

  4. 4

    Pages within the blog section forcibly enable book-style and drop-cap, which cannot be disabled via parameters

  5. 5

    The configuration merge mainly involves two groups of settings: markup.highlight and outputFormats.rss

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
  • When using this theme, the three top-level pages /subscribe/, /contact/, and /legal-information/ must be created, otherwise multiple hard references will fail.
  • All pages within the blog section forcibly enable book-style and drop-cap, which cannot be disabled via parameters.
  • The RSS and Atom templates by default pull articles from the blog section; if that section is missing, the subscription output will have no content.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

The following three top-level pages should always exist, as they are hard-referenced from multiple places:

Original README

Also note that the `book-style`, `drop-cap` parameters are automatically enabled for all pages in this section and cannot be disabled.

Original README

The `blog` section doesn't *technically* have to exist when using this template, but the general assumption is that it does. It is where the RSS and Atom templates pull the posts from.

Original README
https://github.com/tifrueh/hugo-tifrueh/blob/main/LICENSE.txthttps://github.com/tifrueh/hugo-tifrueh/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-12. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 85 / 100
Technologies
Hugo
Website type
Portfolio · Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-09-12
Screenshot last checked
2026-10-12

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-13

Inspect the recorded source material

SHA-256: bd7b8a0d129d16e1e2db0d6433e40d6f917569ebbcf82055dbc8df5564539d5c

2026-10-12T23:28:41.342Z

Source file / repository
# tifrueh HUGO Theme Module

This is the HUGO theme module I wrote for my personal website.

## Custom Site Parameters

| Parameter            | Default Value | Description                                                                          |
| ---                  | ---           | ---                                                                                  |
| `author.name`        | NONE          | The author's name (site-wide default, override on page-basis).                       |
| `author.email`       | NONE          | The author's email. (site-wide default, override on page-basis).                     |
| `editor.name`        | NONE          | The site editor's name. Used in the RSS feed metadata.                               |
| `editor.email`       | NONE          | The site editor's email. Used in the RSS feed metadata.                              |
| `webmaster.name`     | NONE          | The site webmaster's name. Used in the RSS feed metadata.                            |
| `webmaster.email`    | NONE          | The site webmaster's email. Used in the RSS feed metadata.                           |
| `copyright.baseYear` | NONE          | The base year for the copyright notices (site-wide default, override on page-basis). |
| `copyright.entity`   | NONE          | The entity to use in copyright notices (site-wide default, override on page-basis).  |
| `copyright.license`  | NONE          | The license to use in copyright notices (site-wide default, override on page-basis). |
| `urls.github`        | NONE          | The URL for the GitHub link in the menubar.                                          |
| `urls.mastodon`      | NONE          | The URL for the Mastodon link in the menubar.                                        |

## Custom Page Parameters

| Parameter    | Default Value | Description                                                                                                                             |
| ---          | ---           | ---                                                                                                                                     |
| `book-style` | `false`       | Format text in a more book-like manner.                                                                                                 |
| `drop-cap`   | `false`       | Add a drop cap to the first paragraph.                                                                                                  |
| `math`       | `false`       | Force the loading of MathJax to display math on the page. (Note that MathJax *should* load automatically if there is math on the page.) |

## Necessary Pages

The following three top-level pages should always exist, as they are
hard-referenced from multiple places:

| Link                  | Description                                                                    |
| ---                   | ---                                                                            |
| `/subscribe/`         | A page containing instructions on how to subscribe to updates on the site.     |
| `/contact/`           | A page containing contact information.                                         |
| `/legal-information/` | A page containing legal information like the copyright and the privacy policy. |

## Note on the `blog` Section

The `blog` section doesn't *technically* have to exist when using this template,
but the general assumption is that it does. It is where the RSS and Atom
templates pull the posts from.

Also note that the `book-style`, `drop-cap` parameters are automatically enabled
for all pages in this section and cannot be disabled.

Furthermore, the following additional parameters are available for pages in this
section:

| Parameter           | Default Value | Description                                                                  |
| ---                 | ---           | ---                                                                          |
| `table-of-contents` | `false`       | Show a table of contents at the beginning of a page.                         |

## Configuration Merge

The configuration settings potentially relevant for merging in `hugo.toml` are
within:

* `[markup.highlight]`
* `[outputFormats.rss]`
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.