<!-- markdownlint-disable-file MD033 MD041 -->

<div align="center" class="ignore"> <p> FixIt is a clean, elegant but advanced blog theme for <a href="https://gohugo.io/">Hugo</a>.<br> <em>_{Don't forget to leave a ⭐️ if you like this theme, thanks!}</em> </p> English | <a href="/README.zh-cn.md">简体中文</a> | <a href="https://fixit.lruihao.cn/zh-cn/ecosystem/hugo-fixit/fixit/?lang=chinese_traditional">繁體中文</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=french">Français</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=russian">Русский язык</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=spanish">Español</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=hindi">हिन्दी</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=deutsch">deutsch</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=korean">한국어</a> | <a href="https://fixit.lruihao.cn/ecosystem/hugo-fixit/fixit/?lang=japanese">しろうと</a> </div>

<a title="FixIt website" href="https://fixit.lruihao.cn"><img align="right" alt="FixIt logo" width="70" height="70" src="https://avatars.githubusercontent.com/u/110414864?s=200&v=4"></a>

FixIt

It is based on the original LoveIt Theme, KeepIt Theme and LeaveIt Theme.

Live Preview

<p align="center"> 💟 <a href="https://fixit.lruihao.cn">Docs</a> | ❇️ <a href="https://demo.fixit.lruihao.cn/test/">Test</a> | 🚼 <a href="https://demo.fixit.lruihao.cn">Demo</a> | 🆕 <a href="https://hugo-fixit.github.io/hugo-fixit-starter/">Starter</a> <br> <br> More FixIt examples <a href="https://fixit.lruihao.cn/showcase/">here</a>. </p>

Usage

Documentation

Head to the Quick Start page for a step-by-step guide on how to create a new website with FixIt.

Outline: Installation ➜ Getting Started ➜ Content Management ➜ Advanced Usage

Starter Wizard

We provided a CLI tool to help you create a new project with FixIt by a single command.

pnpx fixit-cli create my-blog

Templates

Click the following links to generate a new repository with template:

| Template | repository | Generate link | | :-------------------------------------------- | :-------------------------------- | :----------------------------: | | A quick-start template base on Hugo Modules. | hugo-fixit-starter | Click | | A quick-start template base on Git submodule. | hugo-fixit-starter1 | Click | | Build multilingual sites using Fixit theme. | docs | Click | | Customize with FixIt theme. | Lruihao/hugo-blog | Click |

Features

<details> <summary>Click to view.</summary>

Performance and SEO

• Optimized for performance: 99/100 on mobile and 100/100 on desktop in Google PageSpeed Insights
• Optimized SEO performance with a correct SEO SCHEMA based on JSON-LD
• Google Analytics supported
• Fathom Analytics supported
• Baidu Analytics supported
• Umami Analytics supported
• Plausible Analytics supported
• Cloudflare Web Analytics supported
• Splitbee Analytics supported
• Search engine verification supported (Google, Bing, Yandex, Pinterest, Baidu, 360 and Sogou)
• CDN for third-party libraries supported

Appearance and Layout

• Responsive layout
• Light/Dark mode
• Globally consistent design language
• Pagination supported
• Easy-to-use and self-expanding table of contents
• Multilanguage supported and i18n ready
• Beautiful CSS animation

Social and Comment Systems

• Gravatar supported by Gravatar
• Local Avatar supported
• Up to 87 social links supported
• Up to 28 share sites supported
• Disqus comment system supported by Disqus
• Gitalk comment system supported by Gitalk
• Valine comment system supported by Valine
• Waline comment system supported by Waline
• Facebook comments system supported by Facebook
• Telegram comments system supported by Telegram Comments
• Commento comment system supported by Commento
• Utterances comment system supported by Utterances
• Artalk comment system supported by Artalk
• Twikoo comment system supported by Twikoo
• giscus comment system supported by giscus

Extended Features

• AI Summary, AI Search and AI Chatbot supported by PostChat
• PWA (Progressive Web App) supported
• Sub Menu supported
• Content Encryption supported (Pages, Partial)
• Friends page embedded template
• Search supported by algolia, Fuse.js, CSE or PostChat
• Custom Search Engine (CSE) supported by Google
• Twemoji supported
• Automatically highlighting code
• Copy code to clipboard with one click
• Images gallery supported by lightgallery
• Extended Markdown syntax for Font Awesome icons
• Extended Markdown syntax for ruby annotation
• Extended Markdown syntax for fraction
• Multiple admonitions shortcode or alerts extended Markdown syntax
• Tabs and Tab shortcode with multiple design styles
• Mathematical formula supported by KaTeX or MathJax
• Diagrams code fences extended and shortcode supported by mermaid
• Interactive data visualization shortcode and code fences extended supported by ECharts
• Timeline code fences extended and shortcode supported
• File tree code fences extended and shortcode supported
• Mapbox shortcode supported by Mapbox GL JS
• Music player shortcode supported by APlayer and MetingJS
• Bilibili player and Douyin player shortcode
• Custom style shortcode
• Custom script shortcode
• Open more custom blocks
• Animated typing supported by TypeIt
• Cookie consent banner supported by cookieconsent
• Web Watermark supported by cell-watermark
• Chinese typesetting supported by pangu.js
• Options to cache remote image locally
• ...

</details>

Multilingual and i18n

FixIt supports multilingual and i18n. For more information, see the Content Management documentation. You are welcome to contribute with a new language.

<details> <summary>FixIt supports the following languages.</summary>

• English
• Simplified Chinese
• Traditional Chinese
• French
• Polish
• Brazilian Portuguese
• Italian
• Spanish
• German
• Serbian
• Russian
• Romanian
• Vietnamese
• Hindi
• Japanese
• Korean

</details>

Theme Components

The FixIt theme balances **simplicity