Hugo Documentation
FixIt is a clean, elegant but advanced blog theme for Hugo.
Don't forget to leave a ⭐️ if you like this theme, thanks!
FixIt
It is based on the original LoveIt Theme, KeepIt Theme and LeaveIt Theme.
Live Preview
💟 Production | ❇️ Preview | 🚼 Demo | 🆕 Starter
More FixIt examples here.
Why choose FixIt
I don’t know why 🤷.
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
Click to view.
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
- Mathematical formula supported by KaTeX
- 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
- Mapbox shortcode supported by Mapbox GL JS
- Music player shortcode supported by APlayer and MetingJS
- Bilibili player and Douyin player shortcode
- Kinds of admonitions 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
- …
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.
FixIt supports the following languages.
- English
- Simplified Chinese
- Traditional Chinese
- French
- Polish
- Brazilian Portuguese
- Italian
- Spanish
- German
- Serbian
- Russian
- Romanian
- Vietnamese
- Hindi
Theme Components
The FixIt theme balances simplicity and extensibility with extra Hugo theme components for customization.
Click to view.
- fixit-bundle
🌲 Bundles the FixIt core theme and all hugo-fixit components into a single component. - cmpt-flyfish
🐟 一个 canvas 实现的小鱼游动动画效果。 - cmpt-mdevtools
Mobile devtools component powered by vConsole and eruda. - cmpt-translate
🌐 A component for site automatic translation. - component-projects
🐙 Display your GitHub projects in the FixIt theme and generate blog posts from readme. - hugo-atom-feed
Hugo theme component for ATOM feed custom Output Format. - hugo-json-feed
Hugo theme component for JSON feed custom Output Format. - shortcode-asciinema
A Hugo theme component with asciinema-embed shortcode. - shortcode-caniuse
一个含有 caniuse shortcode 的 Hugo 主题组件。 - shortcode-docs-bookmark
🔖 Embed bookmark of FixIt Docs. - shortcode-mmt-netease
🎶 A Hugo theme component with a NetEase Cloud random comment shortcode. - shortcode-rewards
A Hugo theme component with reward-log or sponsor-log shortcode.
Community
All feedback is welcome! Head over to the discussions, Pull requests and issues tracker.
| Official Community | Description |
|---|---|
| Discussions | GitHub discussion forum |
| FixIt WeChat group | Follow and reply “FixIt” to get |
| FixIt QQ group | QQ group: 814031017 |
| Hugo FixIt Planet | Paid knowledge Planet |
Contributing
We welcome you to join the development of FixIt. Please see contributing document. 🤗
Also, we welcome Issue or PR to our official-components.
When contributing, please first discuss the change you wish to make via a discussion on this repository before making the actual change.
Acknowledgements
Thanks to all the contributors for their support!
Thanks to the authors of following resources included in the theme:
- normalize.css
- Font Awesome
- Simple Icons
- Animate.css
- autocomplete-js
- algoliasearch
- Fuse.js
- object-fit-images
- Twemoji
- emoji-data
- lightgallery
- Sharer.js
- TypeIt
- KaTeX
- mermaid
- ECharts
- Mapbox GL JS
- APlayer
- MetingJS
- Gitalk
- Valine
- cookieconsent
- cell-watermark
- 不蒜子
- Vercount
- pangu.js
- Artalk
- Waline
- Twikoo
- github-corners
- giscus
- crypto-js
- pace
- xxhash-wasm
The FixIt also draws on some features of the following projects, and thanks to their authors as well:
- DoIt
- NexT
License
FixIt is licensed under the MIT license. Check the LICENSE file for details.
Sponsor
If you enjoy the theme, please consider buying me a coffee ☕️. Thanks!
- Alipay
- PayPal
Thanks to the following sponsors for their support:
- translate.js Sponsoring Enterprise Translation Channel.
Author
Lruihao