A minimal and responsive theme for Hugo.
- Author: Fastbyte01
- Minimum Hugo Version: 0.53
- GitHub Stars: 224
- Updated: 2022-03-16
- License: MIT
- Tags: Blog Dark Gallery Minimal Responsive
KeepIt Hugo Theme
KeepIt is a clean, elegant, simple but not simpler blog theme for Hugo based on the original LeaveIt Theme developed by LiuZhichao.
To see this theme in action, Here is a live demo site which is rendered with this theme.
People that are using KeepIt:
- 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
- A More coerent style beetwen page and sections
- Multilanguage support
- Pagination support
- Google Analytics support
- Disqus Comment System
- Gitalk Comment System
- Valine Comment System
- Gitment Comment System
- Utterances Comment System
- Gravatar Support
- Local Avatar Support
- Share post support
- Search engine verification support (Google, Bind, Yandex and Baidu)
- Added configuration file for use on Netlify
- Dark/Light mode
- Up to 54 social sites supported out-of-the-box see the list here
- Translation ready
- Wrap Image with Figure Tag without Shortcode. Thanks Junian.Net
- Load images with Lazy Load By lazysizes
- Automatically highlighting code By Google code-prettify, Customizable styles via CSS. See the themes gallery.
- Automagical image gallery with lightGallery
Clone this repository to your hugo theme directory.
cd themes git clone https://github.com/Fastbyte01/KeepIt.git
Next, open config.toml in the base of the Hugo site and ensure the theme option is set to KeepIt:
theme = "KeepIt"
For more information read the official setup guide of Hugo.
Take a look in the
This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation.
config.toml in the root directory of your website. Overwrite the existing config file if necessary.
A few suggestions to help you get a good looking site quickly:
- Keep blog posts in the content/posts directory, for example: content/posts/my-first-post.md
- Keep static pages in the content directory, for example: content/about.md
- Keep media like images in the static directory, for example: static/images/2019/10/screenshot.png
Customizing styles for your website
If you want to change some styling to fit your own website needs, you can edit them:
assets/css/_varibales/default.scss: You can override the variables in
_variables.scssto customize the style
assets/css/_custom.scss: You can put your custom css in this file
Favicons, Browserconfig, Manifest
It is recommended to put your own favicons
- apple-touch-icon.png (180x180)
- favicon-32x32.png (32x32)
- favicon-16x16.png (16x16)
- mstile-150x150.png (150x150)
- android-chrome-192x192.png (192x192)
- android-chrome-512x512.png (512x512)
/static. They’re easily created via https://realfavicongenerator.net/.
Customize browserconfig.xml and site.webmanifest to set theme-color and background-color for example.
Set production environment when generating site
Because some functions are only in production mode, So you need to add a production environment variables when generating your site.
HUGO_ENV=production hugo --gc --minify
Hugo “extended” Sass/SCSS version required
This theme write style with scss, So you must download and install the “extended” Sass/SCSS version
How to toggle dark-light mode
- You can click the sun logo to toggle dark-light mode. In the desktop version the sun logo is to the right and in the mobile version is positioned to the left, close to the site title.
- If you want to make your own theme toggle-able element, you can create an element with a class
.theme-switch. See here
Home Post model
If you want to show posts on index instead of a personal profile, just open config.toml in the base of the Hugo site, add the following line to config.toml
[params] home_mode = "post" # post or other
Add logo and cover for SEO
Add a logo image (127x40) and a cover image (800x600). This images are used for SEO.
Questions, ideas, bugs, pull requests?
All feedback is welcome! Head over to the issue tracker.
For more configuration info or other tips you can see the wiki.
LeaveIt is licensed under the MIT license. Check the LICENSE file for details. The following resources are included in the theme:
- lazysizes - https://github.com/aFarkas/lazysizes
- lightGallery - https://github.com/sachinchoolur/lightGallery
- code-prettify - https://github.com/google/code-prettify