Lruihao - 作者 | FixIt

快速上手

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

学习在几分钟内创建一个 Hugo FixIt 站点。

💥 升级到 FixIt v1

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

本指南将引导你从 FixIt v0.x 升级到 v1.0。v1 版本引入了重大的破坏性更新，涉及配置结构、自定义资源等方面。请仔细阅读以确保顺利升级。

Hugo Partials 参考

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

本页面提供 FixIt 主题 Hugo partials（layouts/_partials/）的参考文档，涵盖模板函数、插件和布局组件。每个 partial 条目包含其参数、返回值和用法示例。

Front matter

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

了解 Hugo 和 FixIt 主题提供的 Front matter 配置项。

FixIt 主题配置

1024@lruihao.cn (Lruihao) — Sat, 11 Jul 2026 04:44:06 +0800

了解 FixIt 主题通过根配置键 params 提供的所有配置项。

扩展 Shortcode - File Tree

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

file-tree shortcode 用于在 FixIt 主题中渲染交互式文件树结构，它支持多种数据源和格式。

扩展 Shortcode - aplayer

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

这篇文档将向你展示如何在 FixIt 主题中使用 aplayer shortcode 来创建高级音频播放器。

代码块扩展语法 - JSON

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

本文档将向你展示如何在 FixIt 主题中使用代码块扩展语法创建 JSON 查看器。

扩展 Shortcode - tabs

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

tabs shortcode 允许你创建具有各种样式和布局的标签页内容。

数学公式 - MathJax 支持

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

这篇文章介绍了如何在 FixIt 主题中使用 MathJax 来渲染数学公式。

扩展 Shortcode - gist

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

gist shortcode 用于在你的内容中嵌入 GitHub Gist。

扩展 Shortcode - bluesky

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

bluesky shortcode 用于嵌入 Bluesky 帖子。

CSE 支持

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

了解如何在 FixIt 主题中配置自定义搜索引擎 (CSE)。

扩展 Shortcode - Timeline

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

这篇文档将展示如何在 FixIt 中使用 Shortcode 创建时间线。

代码块扩展语法 - 时间线（Timeline）

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

这篇文档将展示如何在 FixIt 中使用代码块扩展语法创建时间线。

如何开发一个 Hugo 主题组件

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

本文将通过开发一个 caniuse shortcode 来演示如何创建一个 Hugo 主题组件。

分享一个 canvas 实现的小鱼游动动画效果

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

分享一个 canvas 实现的小鱼游动动画效果。

扩展 Shortcode - douyin

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

douyin shortcode 提供了一个内嵌的用来播放抖音视频的响应式播放器。

扩展 Shortcode - spotify

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

spotify shortcode 提供了一个内嵌的响应式音乐播放器。

开放的自定义块

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

为了提升 FixIt 主题的可扩展性，我们提供了一些自定义块，你可以在你的项目中使用这些自定义块来实现更多的功能。

参考总览

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

本页面提供 FixIt 主题开放 API 参考的概览，涵盖 JavaScript 公共 API、SCSS 定制 API 和 Hugo 模板扩展点。

开发组件

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

如果你已经构建了一个 Hugo 主题组件，并希望贡献给 Hugo FixIt 社区，请与我们分享。

完善文档

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

通过发现问题并提出更改来帮助我们改进文档。

开发 FixIt 主题

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

为 FixIt 的开发做贡献。

为 FixIt 项目做贡献

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

Hugo FixIt 非常渴望来自于开源社区的热情和参与。我们需要你们的支持！

进阶篇

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

探索 Hugo - FixIt 主题的的进阶使用。

Hugo FixIt 配置总览

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

了解如何配置你的 Hugo FixIt 站点。

安装主题

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

只需几个步骤即可为你的 Hugo 站点安装 FixIt 主题。

关于 algolia 的使用技巧

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

了解如何在 FixIt 主题中使用 algolia，并自动化更新索引。

图表支持 - ECharts

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

ECharts 是一个帮助你生成交互式数据可视化的库。

图表支持 - Mermaid

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

Mermaid 是一个基于 JavaScript 的图表工具，它允许你使用文本和代码创建图表和可视化。

图表支持 - GoAT

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

[GoAT]^(Go ASCII Tool) 是 markdeep.mini.js 图像生成器的 Go 语言实现。

扩展 Shortcode - typeit

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

typeit shortcode 基于 TypeIt 提供了打字动画。

扩展 Shortcode - bilibili

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

bilibili shortcode 提供了一个内嵌的用来播放 bilibili 视频的响应式播放器。

扩展 Shortcode - music

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

music shortcode 基于 APlayer 和 MetingJS 提供了一个内嵌的响应式音乐播放器。

扩展 Shortcode - mapbox

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

mapbox shortcode 使用 Mapbox GL JS 库提供互动式地图的功能。

扩展 Shortcode - echarts

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

echarts shortcode 使用 ECharts 库提供数据可视化的功能。

扩展 Shortcode - admonition

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

admonition shortcode 允许你在内容中添加各种类型的标注。

扩展 Shortcode - mermaid

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

mermaid shortcode 使用 Mermaid 库提供绘制图表和流程图的功能。

扩展 Shortcodes 总览

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

FixIt 主题在 Hugo 内置的 shortcode 的基础上提供了更多的扩展 Shortcodes。

内置 Shortcodes

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

Shortcodes 是在内容文件中调用内置或自定义模板的简单片段。

Markdown 扩展语法

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

这篇文章展示了 [FixIt 风格的 Markdown]^(FixIt Flavored Markdown) 扩展语法。

内容管理总览

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

了解如何在 FixIt 主题中快速，直观地创建和组织内容。

PWA 支持

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

了解如何在 FixIt 主题中配置渐进式网络应用程序 (PWA)。

Markdown 基本语法

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

这篇文章提供了可以在 Hugo 的文章中使用的基本 Markdown 语法示例。