Top Related Projects
Card-style Hugo theme designed for bloggers
A fast, clean, responsive Hugo theme.
Ananke: A theme for Hugo Sites
A minimalist blog theme for hugo.
A simple, retro theme for Hugo
Quick Overview
LoveIt is a clean, elegant, and advanced Hugo theme designed for personal blogs and websites. It offers a wide range of customization options, built-in shortcodes, and features to enhance the user experience and aesthetics of Hugo-based websites.
Pros
- Highly customizable with numerous configuration options
- Responsive design that works well on various devices and screen sizes
- Built-in support for dark mode and multilingual content
- Rich set of shortcodes for enhanced content creation
Cons
- Steeper learning curve compared to simpler Hugo themes
- Some users report occasional compatibility issues with certain Hugo versions
- Documentation could be more comprehensive for advanced customization
- Limited built-in color scheme options
Getting Started
To use the LoveIt theme with your Hugo site:
-
Initialize a new Hugo site:
hugo new site mysite cd mysite
-
Add the LoveIt theme as a submodule:
git init git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt
-
Configure your
config.toml
file:baseURL = "http://example.org/" # [...] theme = "LoveIt" [params] # LoveIt theme version version = "0.2.X" # site description description = "This is my new Hugo site" # site keywords keywords = ["Theme", "Hugo"] # site default theme ("light", "dark", "auto") defaultTheme = "auto" # [...]
-
Create your first post:
hugo new posts/my-first-post.md
-
Start the Hugo server:
hugo server -D
Visit http://localhost:1313
to see your new site with the LoveIt theme.
Competitor Comparisons
Card-style Hugo theme designed for bloggers
Pros of Stack
- More modern and minimalist design aesthetic
- Better support for image galleries and custom layouts
- More active development and frequent updates
Cons of Stack
- Less customization options out-of-the-box
- Steeper learning curve for beginners
- Fewer built-in shortcodes compared to LoveIt
Code Comparison
Stack uses a more modular approach to templating:
{{ define "main" }}
<main class="main">
{{ partial "article-list.html" . }}
</main>
{{ end }}
LoveIt uses a more traditional Hugo templating structure:
{{- define "content" -}}
{{- $paginator := .Paginate .Pages .Site.Params.home.paginate -}}
{{- .Scratch.Set "paginator" $paginator -}}
{{- range $paginator.Pages -}}
{{- .Render "summary" -}}
{{- end -}}
{{- partial "paginator.html" . -}}
{{- end -}}
Both themes offer responsive designs and support for dark mode, but Stack's implementation is generally more modern and streamlined. LoveIt provides more built-in features and customization options, while Stack focuses on simplicity and performance. The choice between the two depends on the specific needs of the project and the developer's preferences.
A fast, clean, responsive Hugo theme.
Pros of PaperMod
- Lighter and faster loading times
- More frequent updates and active development
- Simpler customization process
Cons of PaperMod
- Fewer built-in features and integrations
- Less extensive documentation
- Limited multi-language support
Code Comparison
PaperMod:
<h1 class="post-title">{{ .Title }}</h1>
<div class="post-meta">
{{- if .Date }}
<span class="post-date">
{{- .Date.Format "January 2, 2006" -}}
</span>
{{- end }}
</div>
LoveIt:
<h1 class="post-title">{{ .Title }}</h1>
<div class="post-meta">
{{- with .Date -}}
{{- $format := $.Site.Params.dateFormat | default "2006-01-02" -}}
<span class="post-date">
<i class="far fa-calendar-alt fa-fw"></i> {{- .Format $format -}}
</span>
{{- end -}}
</div>
Both themes use similar structures for displaying post titles and dates, but LoveIt includes more customization options and icons in its default template.
Ananke: A theme for Hugo Sites
Pros of Ananke
- Simpler and more lightweight theme, easier for beginners to customize
- Better out-of-the-box support for multilingual sites
- More frequent updates and active maintenance
Cons of Ananke
- Less feature-rich compared to LoveIt, with fewer built-in shortcodes and widgets
- Limited customization options for advanced users
- Less comprehensive documentation for theme configuration
Code Comparison
Ananke (partial.html):
{{ define "main" }}
<article class="pa3 pa4-ns nested-copy-line-height">
<section class="cf ph3 ph5-l pv3 pv4-l f4 tc-l center measure-wide lh-copy {{ $.Param "text_color" | default "mid-gray" }}">
{{- .Content -}}
</section>
</article>
{{ end }}
LoveIt (single.html):
{{- define "title" }}{{ .Title }} - {{ .Site.Title }}{{ end -}}
{{- define "content" -}}
{{- $params := .Scratch.Get "params" -}}
{{- $toc := $params.toc -}}
{{- if eq $toc true -}}
{{- $toc = .Site.Params.page.toc | default dict -}}
{{- else if eq $toc false -}}
{{- $toc = dict "enable" false -}}
{{- end -}}
{{- /* TOC */ -}}
{{- if ne $toc.enable false -}}
<div class="toc" id="toc-auto">
<h2 class="toc-title">{{ T "contents" }}</h2>
<div class="toc-content{{ if eq $toc.auto false }} always-active{{ end }}" id="toc-content-auto"></div>
</div>
{{- end -}}
A minimalist blog theme for hugo.
Pros of Hugo Coder
- Simpler and more minimalist design, ideal for text-focused content
- Faster loading times due to less complex features
- Easier to customize and extend for developers with basic skills
Cons of Hugo Coder
- Fewer built-in features and widgets compared to LoveIt
- Less visually striking out-of-the-box, which may not suit all users
- Limited multilingual support compared to LoveIt's extensive options
Code Comparison
Hugo Coder (config.toml):
[params]
author = "John Doe"
info = "Full Stack DevOps and Magician"
description = "John Doe's personal website"
keywords = "blog,developer,personal"
avatarurl = "images/avatar.jpg"
LoveIt (config.toml):
[params]
# LoveIt theme version
version = "0.2.X"
# site description
description = "This is My New Hugo Site"
# site keywords
keywords = ["Theme", "Hugo"]
# site default theme ("light", "dark", "auto")
defaultTheme = "auto"
Both themes use similar configuration structures, but LoveIt offers more detailed customization options and features in its default configuration.
A simple, retro theme for Hugo
Pros of hugo-theme-terminal
- Minimalist, retro-style design that appeals to developers and tech enthusiasts
- Lightweight and fast-loading due to its simplicity
- Easy to customize with minimal configuration options
Cons of hugo-theme-terminal
- Limited features compared to more comprehensive themes
- Less suitable for image-heavy or visually complex content
- May not be as appealing to non-technical audiences
Code Comparison
LoveIt:
<header class="home-header">
{{- /* Title */ -}}
<h1 class="home-title">
{{ .Site.Title }}
</h1>
{{- /* Subtitle */ -}}
{{- with .Site.Params.home.subtitle -}}
<p class="home-subtitle">{{- . | safeHTML -}}</p>
{{- end -}}
</header>
hugo-theme-terminal:
<header class="header">
<div class="header__inner">
<div class="header__logo">
{{ partial "logo.html" . }}
</div>
{{ if len $.Site.Menus }}
{{ partial "menu.html" . }}
{{ end }}
</div>
</header>
Both themes use similar HTML structures for their headers, but LoveIt includes more specific classes and separates the title and subtitle, while hugo-theme-terminal uses a more compact structure with partials for logo and menu components.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
LoveIt Theme | Hugo
English README | ç®ä½ä¸æè¯´æ
LoveIt is a clean, elegant but advanced blog theme for Hugo.
It is based on the original LeaveIt Theme and KeepIt Theme.
Since the three themes have a similar look, if you have questions about their differences, read Why choose LoveIt so that you can choose the one that works best for you.
Demo Site
To see this theme in action, here is a live demo site which is rendered with LoveIt theme.
Why choose LoveIt
Compared to the original LeaveIt theme and the KeepIt theme, the LoveIt theme has the following modifications.
- Custom Header
- Custom CSS Style
- A new home page, compatible with the latest version of Hugo
- A lot of style detail adjustments, including color, font size, margins, code preview style
- More readable dark mode
- Some beautiful CSS animations
- Easy-to-use and self-expanding table of contents
- More social links, share sites and comment system
- Search supported by Lunr.js or algolia
- Copy code to clipboard with one click
- Extended Markdown syntax for Font Awesome icons
- Extended Markdown syntax for ruby annotation
- Extended Markdown syntax for fraction
- Mathematical formula supported by KaTeX
- Diagram syntax shortcode supported by mermaid
- Interactive data visualization shortcode supported by ECharts
- Mapbox shortcode supported by Mapbox GL JS
- Embedded music player supported by APlayer and MetingJS
- Bilibili player supported
- Kinds of admonitions shortcode supported
- Custom style shortcodes supported
- CDN for all third-party libraries supported
- ...
In short, if you prefer the design language and freedom of the LoveIt theme, if you want to use the extended Font Awesome icons conveniently, if you want to embed mathematical formulas, flowcharts, music or Bilibili videos in your posts, the LoveIt theme may be more suitable for you.
I hope you will LoveIt â¤ï¸!
Features
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
- Plausible Analytics supported
- Yandex Metrica supported
- Search engine verification supported (Google, Bind, Yandex and Baidu)
- CDN for third-party libraries supported
- Automatically converted images with Lazy Load by lazysizes
Appearance and Layout
- Desktop/Mobile 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 81 social links supported
- Up to 27 share sites supported
- Disqus comment system supported by Disqus
- Gitalk comment system supported by Gitalk
- Valine comment system supported by Valine
- 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
- giscus comment system supported by giscus
Extended Features
- Search supported by Lunr.js or algolia
- 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 shortcode supported by mermaid
- Interactive data visualization shortcode supported by ECharts
- Mapbox shortcode supported by Mapbox GL JS
- Music player shortcode supported by APlayer and MetingJS
- Bilibili player shortcode
- Kinds of admonitions shortcode
- Custom style shortcode
- Custom script shortcode
- Animated typing supported by TypeIt
- Cookie consent banner supported by cookieconsent
- Person shortcode
- ...
Documentation
Build Documentation Locally:
hugo server --source=exampleSite
Compatibility
LoveIt branch or version | Supported Hugo versions |
---|---|
master(Unstable) | ⥠0.128.0 |
0.3.X(Recommended) | 0.128.0 - 0.145.0 |
0.2.X(Outdated) | 0.68.0 - 0.127.0 |
Multilingual and i18n
LoveIt supports the following languages:
- English
- Simplified Chinese
- Traditional Chinese
- French
- Polish
- Portuguese (Brazil)
- Italian
- Spanish
- German
- Serbian
- Russian
- Romanian
- Vietnamese
- Arabic
- Catalan
- Thai
- Telugu
- Indonesian
- Turkish
- Korean
- Hindi
- Dutch
- Bengali
- Contribute with a new language
Roadmap
Questions, ideas, bugs, pull requests
All feedback is welcome! Head over to the issue tracker.
License
LoveIt is licensed under the MIT license. Check the LICENSE file for details.
Special Thanks
Thanks to the authors of following resources included in the theme:
- modern-normalize
- Font Awesome
- Simple Icons
- Animate.css
- autocomplete
- Lunr.js
- algoliasearch
- lazysizes
- object-fit-images
- Twemoji
- emoji-data
- lightGallery
- clipboard.js
- Sharer.js
- TypeIt
- KaTeX
- mermaid
- ECharts
- Mapbox GL JS
- APlayer
- MetingJS
- Gitalk
- Valine
- cookieconsent
Author
Sponsor
If you enjoy the theme, please consider buying me a coffee âï¸.
Thanks! â¤ï¸
Stargazers over time
Top Related Projects
Card-style Hugo theme designed for bloggers
A fast, clean, responsive Hugo theme.
Ananke: A theme for Hugo Sites
A minimalist blog theme for hugo.
A simple, retro theme for Hugo
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot