Hugo Themes
Hugo blog awesome
Minimal Hugo blog theme with light and dark mode support
- Author: Sidharth R
- Minimum Hugo Version: 0.86.0
- GitHub Stars: 18
- Updated: 2023-03-14
- License: MIT
- Tags: Blog Dark Light Minimal Responsive
Awesome hugo blog | Demo
β‘ Fast | π° Clean UI | π Dark mode support | π± Responsive design
Features
- Minimal design
- Responsive design
- Light and dark mode
- Syntax highlighting
- RSS feed
- No jQuery, Bootstrap
- 100/100 Google PageSpeed Insights score on all 4 metrics
Screenshots
Dark mode | Light mode |
---|---|
![]() | ![]() |
Page speed score:
Google PageSpeed Insights test link.
Setup
Note: you need to have the Hugo extended version installed in order to use this theme. This theme uses SCSS for styling. With Hugo extended version, SCSS can be compiled to CSS without any additional tool.
To create a new Hugo site with this theme, run the following command:
hugo new site myblog
Then, clone this repository into the themes
directory of your new site:
cd myblog
git clone https://github.com/hugo-sid/hugo-blog-awesome.git themes/hugo-blog-awesome
To preview the thmeme with example content, run the following command from the exampleSite
directory:
hugo server --themesDir ../..
Usage
To use this theme, set the theme
variable in your site’s config.toml
to hugo-blog-awesome
:
theme = "hugo-blog-awesome"
Configuration
You can have a look at the config.toml
file in the exampleSite
directory for an example configuration.
It is recommend that you to copy the config.toml
file from the exampleSite
directory to the root directory of your Hugo site. You can then edit the config.toml
file to suit your needs.
Adding favicon
I used realfavicongenerator.net to generate the favicons. You can place the resulting files in the static\images\favicon
folder. That should get your favicon working.
If you want to customize anything further, you can modify layouts\partials\head.html
.
Adding Social icons
Social icons can be added by congifuring config.toml
file in the following manner.
[[params.socialIcons]]
name = "github"
url = "https://github.com/hugo-sid"
[[params.socialIcons]]
name = "twitter"
url = "https://twitter.com"
[[params.socialIcons]]
name = "Rss"
url = "index.xml"
List of available icons (click to expand)
Name | Platform |
---|---|
123rf | 123rf.com |
adobestock | stock.adobe.com |
applemusic | music.apple.com |
behance | behance.net |
bilibili | bilibili.com |
bitcoin | - |
buymeacoffee | buymeacoffee.com |
codepen | codepen.io |
cryptohack | cryptohack.org |
ctftime | ctftime.org |
cv | - |
deezer | deezer.com |
dev | dev.to |
discogs | discogs.com |
discord | discord.com |
dreamstime | dreamstime.com |
dribbble | dribbble.com |
email | - |
facebook | facebook.com |
flickr | flickr.com |
freepik | freepik.com |
gitea | gitea.io |
github | github.com |
gitlab | gitlab.com |
goodreads | goodreads.com |
googlescholar | scholar.google.com |
guruShots | gurushots.com |
hackerone | hackerone.com |
hackerrank | hackerrank.com |
hackthebox | hackthebox.eu |
instagram | instagram.com |
itchio | itch.io |
kaggle | - |
kakaotalk | kakaocorp.com/service/KakaoTalk |
key | - |
keybase | keybase.io |
kofi | ko-fi.com |
komoot | - |
lastfm | last.fm |
letterboxd | - |
liberapay | liberapay.com |
linkedin | linkedin.com |
mastodon | mastodon.social |
matrix | matrix.org |
medium | medium.com |
monero | - |
mixcloud | mixcloud.com |
nuget | nuget.org |
paypal | paypal.com |
peertube | - |
pgp | - |
phone | - |
ploywork | ploywork.com |
qq | qq.com |
reddit | reddit.com |
researchgate | researchgate.net |
rss | - |
serverfault | serverfault.com |
soundcloud | soundcloud.com |
shutterstock | shutterstock.com |
slack | slack.com |
snapchat | snapchat.com/add |
spotify | spotify.com |
stackoverflow | stackoverflow.com |
steam | steampowered.com |
strava | strava.com |
telegram | telegram.org |
tiktok | tiktok.com |
twitch | twitch.tv |
twitter | twitter.com |
unsplash | unsplash.com |
xda | xda-developers.com |
xing | xing.com |
ycombinator | ycombinator.com |
youtube | youtube.com |
other | - |
If you are trying to add an icon which is not listed above, you can modify layouts\partials\svgs\svgs.html
to include your icon (SVG). You are encouraged to submit your icon by creating a pull request, so that other can benefit.
Content
Posts
To create a new post, run the following command:
hugo new posts/my-first-post.md
Then, edit the my-first-post.md
file to suit your needs.
Contributing
If you find any bugs or have any suggestions, feel free to open an issue or a pull request.
Websites using this theme
If you are using this theme for any website, feel free to list the website here. You can submit a pull request (PR) to include your website.
Support
Don’t forget to βοΈ the repo if you liked this theme!
Credits
The social icons are made possible thanks to Aditya Telange’s hugo-PaperMod theme.
License
This theme is released under the MIT license. For more information read the License.