HugoHTMLBlogDocumentation

blue — Hugo Blog Template

By memoex

A responsive blog theme based on Hugo, with an interface referencing the Bootstrap documentation site, featuring a sidebar, table of contents, code highlighting, and MathJax.

Explore the design

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

1 previews
Author preview
Author-provided previewTop of page

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-11View source

What stands out

A quick read of the recorded project description.

01

Responsive layout, with an interface referencing the Bootstrap documentation site style

02

Provides a sidebar and article table of contents (TOC)

03

Code syntax highlighting, with click-to-copy code blocks

04

Integrates MathJax formulas and fancybox image viewing

05

Supports Disqus comments, tags, and display of last modified date

Template Details

Blue is a responsive theme for the Hugo blog framework, and the author states that its visual inspiration comes from Bootstrap's documentation site. The repository provides a blog demo site and screenshots; the README focuses on a feature list and quick start, without further design notes.

In terms of content presentation, the theme leans toward documentation-style reading: it provides a sidebar and article table of contents (TOC), supports syntax highlighting, and allows code blocks to be copied with a click; it also integrates MathJax formulas and fancybox image viewing, with fonts and colors referencing the Material color palette. Comments use Disqus, content organization supports tags, and articles can display a last modified date. Blog search is still marked as incomplete in the README.

Usage follows the usual process for Hugo themes: clone the repository under themes in the Hugo site directory, then enable it via hugo -t blue or by setting theme = "blue" in config.toml. The README provides a config.toml example including baseurl, title, subtitle, favicon, author information, and the main navigation menu; menu items need to end with / for navigation highlighting to work. The repository was last updated in 2018, and the README does not state compatibility with newer versions of Hugo.

HugoHTMLBlogDocumentation

Is it right for your project?

Use Cases

  • Building a personal blog focused on technical notes
  • Writing tutorial articles containing code snippets and mathematical formulas
  • Documentation-style sites that need a sidebar and table of contents to assist long-form reading

Suitable For

  • Individual bloggers using Hugo to generate static sites
  • Technical writers who need a documentation-style reading experience and code display
  • Developers who want to modify the theme themselves based on MIT-licensed code

Getting started & customization

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

  1. 1

    Hugo must be installed first and a site created; the directory should contain a themes folder

  2. 2

    Run git clone https://github.com/memoex/blue.git in the themes directory

  3. 3

    Enable the theme with hugo -t blue or by setting theme = "blue" in config.toml

  4. 4

    Configure baseurl, title, subtitle, favicon, author, and the main navigation menu according to the README example

  5. 5

    Menu URLs need to end with / for navigation highlighting to work

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 that version and does not mean 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 complete 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 separate charges.
  • The comment feature depends on the third-party Disqus service; you must register and configure a Disqus site yourself, and it may be subject to its terms of service and network availability.
  • The blog search feature is not yet implemented and is marked as incomplete in the README; the site does not include search capability.
  • Using this theme requires installing the Hugo static site generator in advance and creating a site; it is not a standalone runnable website.
  • Installation is done by cloning the repository from GitHub into the themes directory of a Hugo site, requiring Git and network access.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

- [x] Disqus comment.

Original README

- [ ] Blog searching.

Original README

First you need to have hugo installed and use hugo to create a new website.

Original README

git clone https://github.com/memoex/blue.git

Original README
https://github.com/memoex/blue/blob/master/LICENSE.mdhttps://github.com/memoex/blue/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-11. 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
Partly documented · 61 / 100
Technologies
Hugo · HTML
Website type
Blog · Documentation
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
2018-04-13
Screenshot last checked
2026-10-11

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

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: 26f868caa84bd7701af055a31cad78744a90838a6fa78efbd9793f400d44cc37

2026-10-11T18:17:08.153Z

Source file / repository
# Blue

A responsive theme inspired by documentation site of Bootstrap for Hugo blog framework.

## Demo

Blog demo: https://memoex.github.io

![](https://i.imgur.com/KD1PetE.png)

## Features

- [x] Responsive.
- [x] Nice and convenient sidebar.
- [x] TOC (table of content).
- [x] Syntax Highlighting.
- [x] Copy code block to clipboard with single click.
- [x] MathJax.
- [x] Show images with fancybox.
- [x] Beautiful [fonts](http://localhost:1313/note/tech/css/) and [material color](https://material.io/guidelines/style/color.html#color-color-palette).
- [x] Disqus comment.
- [x] Tags.
- [x] Show last modify date after your modification.
- [ ] Blog searching.


## Quick start

### Installation

First you need to have hugo installed and use hugo to create a new website. See the [Quick Start](http://gohugo.io/getting-started/quick-start/) if hugo is new for you.

After you have a new hugo website, the directory structure must look like this:

```
.
├── archetypes
├── config.toml
├── content
├── data
├── layouts
├── static
└── themes
```

Then move to `themes` folder. If you don't have this folder, just create one.

Run the commands below to install `blue` theme:

``` sh
git clone https://github.com/memoex/blue.git
```

Then you could use this theme in two ways.

One is to pass the `-t` flag:

- building your site for deployment: `hugo -t blue`
- starting a local server at http://localhost:1313 (default): `hugo server -t blue`

The other one is to change your configuration file `config.toml`. Change the value of `theme` as below:

```
theme = "blue"
```

Then you don't need an extra `-t` flag anymore.

### Configuration

Below is my `config.toml`, you can replace the values with your information.

``` toml
baseurl = "https://memoex.github.io/"
DefaultContentLanguage = "en"
title = "Mr.Blue"
theme = "blue"
metaDataFormat = "yaml"

[Params]
  subtitle = "Mr.Blue doesn't have a good memory."
  favicon = "/favicon.ico"                          # when build website, the files under `/static` will be moved to `/`

[Author]
  name = "Mr.Blue"
  website = "https://memoex.github.io"
  email = "[email protected]"
  github = "blue-fatty"

[[menu.main]]
    identifier = "note"
    name = "Note"
    url = "/note/"                                  # url should end with `/` to make highlighting of navigation bar works
    weight = 2                                      # small weight go left, large weight go right

[[menu.main]]
    identifier = "project"
    name = "Project"
    url = "/project/"
    weight = 2

[[menu.main]]
    identifier = "tags"
    name = "Tags"
    url = "/tags/"
    weight = 2

[[menu.main]]
    identifier = "about"
    name = "About"
    url = "/about/"
    weight = 3
```
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.