Lruihao - Author | FixIt

Quick Start

1024@lruihao.cn (Lruihao) — Fri, 01 Mar 2024 15:18:19 +0800

Learn to create a Hugo FixIt site in minutes.

💥 Upgrading to FixIt v1

1024@lruihao.cn (Lruihao) — Wed, 22 Jul 2026 10:00:00 +0800

This guide walks you through upgrading from FixIt v0.x to v1.0. The v1 release introduces significant breaking changes to configuration structure, custom assets, and more. Read on to ensure a smooth upgrade.

Hugo Partials Reference

1024@lruihao.cn (Lruihao) — Mon, 20 Jul 2026 21:20:13 +0800

This page provides a reference for FixIt’s Hugo partials (layouts/_partials/), covering template functions, plugins, and layout components. Each partial entry includes its parameters, return values, and usage examples.

Front matter

1024@lruihao.cn (Lruihao) — Sat, 11 Jul 2026 18:20:17 +0800

Learn about the front matter configuration options provided by Hugo and the FixIt theme.

FixIt Theme Configuration

1024@lruihao.cn (Lruihao) — Sat, 11 Jul 2026 18:19:31 +0800

Find out all FixIt theme configuration settings via the root configuration keys params.

Extended Shortcode - File Tree

1024@lruihao.cn (Lruihao) — Wed, 14 Jan 2026 02:50:14 +0800

The file-tree shortcode is used to render interactive file tree structures in FixIt theme. It supports multiple data sources and formats.

Extended Shortcode - aplayer

1024@lruihao.cn (Lruihao) — Tue, 21 Oct 2025 06:46:37 +0800

This document will show you how to use the aplayer shortcode in FixIt to create advanced audio players.

Code Fences Extended - JSON

1024@lruihao.cn (Lruihao) — Tue, 14 Oct 2025 06:49:42 +0800

This document will show you how to create a JSON viewer in FixIt using the code fences extended syntax.

Extended Shortcode - tabs

1024@lruihao.cn (Lruihao) — Thu, 11 Sep 2025 13:53:54 +0800

The tabs shortcode allows you to create tabbed content with various styles and layouts.

Mathematical formulas - MathJax support

1024@lruihao.cn (Lruihao) — Sun, 29 Jun 2025 19:30:55 +0800

This article shows how to use MathJax to render mathematical formulas in the FixIt theme.

Extended Shortcode - gist

1024@lruihao.cn (Lruihao) — Wed, 02 Apr 2025 16:35:00 +0800

The gist shortcode embeds a GitHub Gist in your content.

Extended Shortcode - bluesky

1024@lruihao.cn (Lruihao) — Wed, 12 Mar 2025 15:04:00 +0800

The bluesky shortcode embeds a post from Bluesky.

CSE Support

1024@lruihao.cn (Lruihao) — Thu, 28 Nov 2024 15:01:29 +0800

Find out how to setup Custom Search Engine in FixIt.

Extended Shortcode - Timeline

1024@lruihao.cn (Lruihao) — Sun, 21 Jul 2024 10:44:31 +0800

This document will show you how to create a Timeline in FixIt using Shortcode.

Code Fences Extended - Timeline

1024@lruihao.cn (Lruihao) — Sat, 20 Jul 2024 19:25:31 +0800

This document will show you how to create a Timeline in FixIt using the code fences extended syntax.

How to Develop a Hugo Theme Component

1024@lruihao.cn (Lruihao) — Thu, 27 Jun 2024 17:35:29 +0800

This article will demonstrate how to create a Hugo theme component by developing a caniuse shortcode.

Canvas implementation of small fish swimming animation

1024@lruihao.cn (Lruihao) — Wed, 22 May 2024 10:12:11 +0800

Sharing a canvas-implemented fish swimming animation effect.

Extended Shortcode - douyin

1024@lruihao.cn (Lruihao) — Mon, 20 May 2024 11:06:24 +0800

The douyin shortcode embeds a responsive video player for douyin videos.

Extended Shortcode - spotify

1024@lruihao.cn (Lruihao) — Mon, 20 May 2024 11:06:24 +0800

The spotify shortcode embeds a responsive music player for Spotify music.

Open Custom Blocks

1024@lruihao.cn (Lruihao) — Thu, 09 May 2024 10:28:58 +0800

To enhance the extensibility of the FixIt theme, we provide some custom blocks that you can use in your project to achieve more functionality.

References Overview

1024@lruihao.cn (Lruihao) — Wed, 08 May 2024 02:56:39 +0800

This page provides an overview of the FixIt theme’s open API references, covering the JavaScript public API, SCSS customization API, and Hugo template extension points.

Develop theme components

1024@lruihao.cn (Lruihao) — Thu, 25 Apr 2024 20:30:45 +0800

If you’ve built a Hugo theme components and want to contribute back to the Hugo FixIt Community, please share it with us.

Improve documentation

1024@lruihao.cn (Lruihao) — Thu, 25 Apr 2024 20:30:44 +0800

Help us to improve the documentation by identifying issues and suggesting changes.

Develop FixIt theme

1024@lruihao.cn (Lruihao) — Thu, 25 Apr 2024 20:30:43 +0800

Contribute to the development of FixIt.

Contribute to the FixIt project

1024@lruihao.cn (Lruihao) — Thu, 25 Apr 2024 20:30:42 +0800

Hugo FixIt is eager for enthusiasm and participation from the open-source community. We need your support!

Advanced Usage

1024@lruihao.cn (Lruihao) — Sat, 06 Apr 2024 12:59:28 +0800

Discover advanced usage of the Hugo - FixIt theme.

Hugo FixIt Configuration Overview

1024@lruihao.cn (Lruihao) — Thu, 07 Mar 2024 15:37:59 +0800

Find out how to configure your Hugo FixIt site.

Theme Installation

1024@lruihao.cn (Lruihao) — Thu, 18 Jan 2024 10:29:25 +0800

Install FixIt theme for your Hugo site in a few steps.

Tips about algolia

1024@lruihao.cn (Lruihao) — Fri, 01 Dec 2023 10:20:16 +0800

Find out how to use algolia in the FixIt theme and update index automatically.

Diagrams Support - ECharts

1024@lruihao.cn (Lruihao) — Fri, 24 Mar 2023 22:40:40 +0800

ECharts is a library helping you to generate interactive data visualization.

Diagrams Support - Mermaid

1024@lruihao.cn (Lruihao) — Fri, 24 Mar 2023 22:11:45 +0800

Mermaid is a JavaScript-based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically. It lets you create diagrams and visualizations using text and code.

Diagrams Support - GoAT

1024@lruihao.cn (Lruihao) — Wed, 22 Mar 2023 10:51:22 +0800

[GoAT]^(Go ASCII Tool) is a Go implementation of markdeep.mini.js’s ASCII diagram generator.

Extended Shortcode - typeit

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:59:50 +0800

The typeit shortcode provides typing animation based on TypeIt library.

Extended Shortcode - bilibili

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:52:50 +0800

The bilibili shortcode embeds a responsive video player for bilibili videos.

Extended Shortcode - music

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:50:50 +0800

The music shortcode embeds a responsive music player based on APlayer and MetingJS.

Extended Shortcode - mapbox

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:45:45 +0800

The mapbox shortcode supports interactive maps in Hugo with Mapbox GL JS library.

Extended Shortcode - echarts

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:40:40 +0800

The echarts shortcode supports data visualization in Hugo with ECharts library.

Extended Shortcode - admonition

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:11:45 +0800

The admonition shortcode allows you to add various types of callouts to your content.

Extended Shortcode - mermaid

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:11:45 +0800

The mermaid shortcode supports diagrams in Hugo with Mermaid library.

Extended Shortcodes Overview

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:11:39 +0800

FixIt theme provides multiple shortcodes on top of built-in ones in Hugo.

Built-in Shortcodes

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 22:11:22 +0800

Shortcodes are simple snippets inside your content files calling built-in or custom templates.

Extended Markdown Syntax

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 21:42:22 +0800

This article shows the FixIt Flavored Markdown extended syntax.

Content Management Overview

1024@lruihao.cn (Lruihao) — Fri, 24 Feb 2023 17:27:22 +0800

Find out how to create and organize your content quickly and intuitively in FixIt theme.

PWA Support

1024@lruihao.cn (Lruihao) — Wed, 26 Jan 2022 09:32:56 +0800

Find out how to turn your FixIt site into a Progressive Web App.

Basic Markdown Syntax

1024@lruihao.cn (Lruihao) — Sat, 18 Dec 2021 16:15:22 +0800

This article offers a sample of basic Markdown syntax that can be used in Hugo content files.

Lruihao - Author | FixIt

Quick Start

💥 Upgrading to FixIt v1

Hugo Partials Reference

Front matter

FixIt Theme Configuration

Extended Shortcode - File Tree

Extended Shortcode - aplayer

Code Fences Extended - JSON

Extended Shortcode - tabs

Mathematical formulas - MathJax support

Extended Shortcode - gist

Extended Shortcode - bluesky

CSE Support

Related content

Extended Shortcode - Timeline

Code Fences Extended - Timeline

How to Develop a Hugo Theme Component

Canvas implementation of small fish swimming animation

Extended Shortcode - douyin

Extended Shortcode - spotify

Open Custom Blocks

References Overview

Develop theme components

Improve documentation

Develop FixIt theme

Contribute to the FixIt project

Advanced Usage

Hugo FixIt Configuration Overview

Theme Installation

Tips about algolia

Diagrams Support - ECharts

Diagrams Support - Mermaid

Diagrams Support - GoAT

Extended Shortcode - typeit

Extended Shortcode - bilibili

Extended Shortcode - music

Extended Shortcode - mapbox

Extended Shortcode - echarts

Extended Shortcode - admonition

Extended Shortcode - mermaid

Extended Shortcodes Overview

Built-in Shortcodes

Extended Markdown Syntax

Content Management Overview

PWA Support

Basic Markdown Syntax