Skip to content
This repository has been archived by the owner on Dec 20, 2021. It is now read-only.

uPagge/uBlogger

Repository files navigation

uBlogger Theme | Hugo

GitHub release (latest by date) Hugo License Netlify Status

uBlogger is a clean, elegant but advanced blog theme for Hugo.

It is based on the original LoveIt Theme.

Since the three themes have a similar look, if you have questions about their differences, read Why choose uBlogger so that you can choose the one that works best for you.

Hugo Theme uBlogger

⚠️ Information for those who move with LoveIt theme ⚠️

Skip to the next section if you do not know about LoveIt

If you have used the LoveIt theme, I have a message for you, make sure to read it.

To see this theme in action, here is a live demo site which is rendered with uBlogger theme.

Why choose uBlogger

Compared to the original LeaveIt theme and the KeepIt theme, the uBlogger 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 uBlogger 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 uBlogger theme may be more suitable for you.

I hope you will uBlogger ❤️!

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
  • 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

  • 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 64 social links supported
  • Up to 28 share sites supported
  • Remark42 comment system sypported by Remark42. I recommend using it.
  • 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

Extended Features

  • Search supported by Lunr.js or algolia
  • Twemoji supported
  • Automatically highlighting code
  • 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
  • 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
  • Dynamic scroll supported by Smooth Scroll
  • Cookie consent banner supported by cookieconsent
  • ...

Documentation

Build Documentation Locally:

hugo server --source=exampleSite

Multilingual and i18n

uBlogger supports the following languages:

  • English
  • Simplified Chinese
  • French
  • Polish
  • Brazilian Portuguese
  • Italian
  • Spanish
  • German
  • Serbian
  • Russian
  • Romanian
  • Vietnamese
  • Contribute with a new language

Questions, ideas, bugs, pull requests

All feedback is welcome! Head over to the issue tracker.

License

uBlogger is licensed under the MIT license. Check the LICENSE file for details.

Thanks to the authors of following resources included in the theme:

Author

uPagge

Sponsor

If you enjoy the theme, please set the star for the project or/and consider buying me a coffee ☕️.

Thanks! ❤️❤️❤️