Erblog

Erblog is a personal blog theme for Hugo, authored by Ertuil, that organizes content into three built-in sections — post, zone, and gallery — and lets you toggle MathJax per page. It is responsive for mobile and customizable through configuration parameters for colors, menus, and HTML hooks.

What is Erblog?

Erblog is a Hugo blog theme maintained by Ertuil. It accepts Markdown files placed in the post, zone, or gallery content directories and outputs a responsive blog site. The theme uses layui.js for UI components, Font Awesome icons, GitHub markdown CSS for typography, and undraw for illustrations. Because it runs on Hugo, pages are static and fast, and the theme can be installed as a git submodule.

Key Features

• Three content sections — post for articles, zone for status updates, and gallery for photo collections; each is created with its own Hugo new command.
• Per-page MathJax — MathJax is deliberately not loaded by default for performance; enable it with math: true in a page's front matter or set Params.math globally.
• Color theming — customize badge, quote, and notification background colors through Params.badge, Params.quote, and Params.notice_color, choosing from red, cyan, orange, green, blue, and gray.
• Configurable menus — add main navigation, footer links, and social icons via menu.main, menu.footer, and menu.icon entries in config.toml.
• Analytics and search — configured with Google Analytics and Google intra-site search via googleAnalytics and Params.google_search.
• Custom HTML hooks — two partials, layouts/partials/self-define.html and layouts/partials/self-define-single.html, inject code above the footer on all pages or on posts only.
• Optional styled scrollbar — a contributed styled-scrollbar branch is available for the theme.

Who should use Erblog?

• Hugo bloggers — get a personal blog with three content types and no build tooling beyond Hugo.
• Photographers — assemble galleries by copying images into the static directory and listing them in a gallery Markdown file.
• Writers publishing math — turn on MathJax per post to render LaTeX-style equations in articles.
• Developers who customize themes — use color parameters, menu arrays, and HTML hooks to adapt the theme without editing template internals.

What can you do with Erblog?

• Personal bloggers: write long-form posts in post and short updates in zone, mirroring a Facebook-like timeline.
• Photo hobbyists: publish a gallery page by referencing image files in gallery_name.md.
• Technical writers: enable MathJax on selected pages to include formulas in tutorials or notes.
• Site owners: embed Disqus or gittalk comments using the self-define-single.html hook.

How does Erblog work?

Installation uses git submodules: add the repository as themes/erblog, then run git submodule init and git submodule update. Future updates come from git submodule update --remote themes/erblog. Content is created with standard Hugo commands such as hugo new post/post_name.md, and configuration is done in config.toml. The README documents two HTML partials that let you insert custom code site-wide or per post.

FAQ

Is MathJax included by default?

No. The theme excludes MathJax for performance. You enable it per page by adding math: true in front matter, or for the whole site by setting Params.math to true.

How do I add Disqus comments?

Add the Hugo internal Disqus template to layouts/partials/self-define-single.html and define disqusShortName in your config.toml. This hook appears at the bottom of every blog post.

Can I change the theme colors?

Yes. Set Params.badge, Params.quote, and Params.notice_color to any of red, cyan, orange, green, blue, and gray. These control badge, quote block, and notification background colors.

How do I install Erblog?

Use git submodule commands to add the repository to themes/erblog, then initialize and update it. After installation, configure the theme in config.toml.

What content sections are available?

Erblog provides post for articles, zone for a Facebook-like status timeline, and gallery for photo collections. Each section has its own hugo new command.