Hugo Xmag screenshot

Hugo Xmag

Author Avatar Theme by Yihui
Updated: 24 Feb 2025
108 Stars

A minimal magazine theme for Hugo

Overview

HUGO XMAG is a Hugo theme that is designed based on the XMin theme. It features a minimalistic design with a magazine-style homepage inspired by The Signpost on Wikipedia. The theme includes several cool features such as responsive article summary blocks, thumbnails in summary blocks, a magazine title in Blackletter font, Github edit links, author and site information at the bottom of articles, support for MathJax for LaTeX math expressions, and more.

Features

  • Responsive article summary blocks on homepage
  • Thumbnails in summary blocks
  • Magazine title in Blackletter font
  • Github edit links
  • Author info and site info at the bottom of an article
  • MathJax for LaTeX math expressions
  • Google Analytics integration
  • Syntax highlighting of code blocks with highlight.js
  • Display categories and tags on single pages
  • Table of contents for single pages

Installation

To install the HUGO XMAG theme, follow these steps:

  1. If you are an R user, the easiest way to get started is to install the blogdown package and use blogdown::new_site() to create a new site. If you are not using R, please proceed to the next step.

  2. Download the theme repository and unzip it.

  3. Change directory to the root of your Hugo site.

  4. Copy the downloaded theme into the themes/ directory:

    cp -r ~/Downloads/hugo-mag-master themes/hugo-mag
    
  5. Copy the example site into your site root:

    cp -r themes/hugo-mag/exampleSite .
    
  6. Follow the remaining steps of the Quickstart Guide starting from Step 5.

For more detailed installation instructions and configuration options, please refer to the documentation on the About page of the theme website. The source code of the theme is available on Github under the MIT license.

Summary

HUGO XMAG is a Hugo theme that combines minimalistic design with a magazine-style homepage. It offers a range of features including responsive article summary blocks, thumbnails, Blackletter font, Github edit links, author and site information, MathJax support, and more. Installation is straightforward and can be done by following the provided guide. Overall, HUGO XMAG is a versatile theme that can be used to create visually appealing and functional websites.