Hello Friend NG for Mad CAD IT
This theme started out as a Fork of rhazdon’s Hello Friend NG Hugo theme. A big Thank You! to him for his excellent work!
I’ve then forked it to modify it to fit my needs. While it should work with most Hugo setups, it’s not really intended to be used as-is by other blogs, mostly because I continuously tinker with it and make various changes. So if you like it, clone it into your own fork and enjoy!
$ git clone https://github.com/Landhund/hugo-theme-hello-friend-ng.git themes/hello-friend-ng-mad-cad-it
The rest of this Readme is essentially just rhazdon’s readme. Most of it should still hold true, but at some point I’ll have to really document the features I’ve changed and added.
If you like it, I strongly recommend to look into rhazdon’s original!
-
Theming: dark/light mode, depending on your system preferences or the users choice
-
Great reading experience thanks to Inter font, made by Rasmus Andersson
-
Nice code highlighting thanks to PrismJS
-
An easy way to modify the theme with Hugo tooling
-
Fully responsive
-
Support for audio in posts (thanks to @talbotp)
-
Builtin (enableable/disableable) multilanguage menu
-
Support for social icons
-
Support for sharing buttons
-
Support for Commento
-
Support for utterances comment system
You can download the theme manually by going to https://github.com/rhazdon/hugo-theme-hello-friend-ng.git and pasting it to themes/hello-friend-ng
in your root directory.
You can also clone it directly to your Hugo folder:
If you don’t want to make any radical changes, it’s the best option, because you can get new updates when they are available. To do so, include it as a git submodule:
$ git submodule add https://github.com/rhazdon/hugo-theme-hello-friend-ng.git themes/hello-friend-ng
The theme doesn’t require any advanced configuration.
Just copy the following config file.
To see all possible configurations, check the docs.
Note: There are more options to configure.
Take a look into the config.toml
in exampleSite
.
baseurl = "localhost"
title = "My Blog"
languageCode = "en-us"
theme = "hello-friend-ng"
paginate = 10
[params]
dateform = "Jan 2, 2006"
dateformShort = "Jan 2"
dateformNum = "2006-01-02"
dateformNumTime = "2006-01-02 15:04"
# Subtitle for home
homeSubtitle = "A simple and beautiful blog"
# Set disableReadOtherPosts to true in order to hide the links to other posts.
disableReadOtherPosts = false
# Enable sharing buttons, if you like
enableSharingButtons = true
# Show a global language switcher in the navigation bar
enableGlobalLanguageMenu = true
# Metadata mostly used in document's head
description = "My new homepage or blog"
keywords = "homepage, blog"
images = [""]
[taxonomies]
category = "blog"
tag = "tags"
series = "series"
[languages]
[languages.en]
title = "Hello Friend NG"
keywords = ""
copyright = '<a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank" rel="noopener">CC BY-NC 4.0</a>'
readOtherPosts = "Read other posts"
[languages.en.params]
subtitle = "A simple theme for Hugo"
[languages.en.params.logo]
logoText = "hello friend ng"
logoHomeLink = "/"
# or
#
# path = "/img/your-example-logo.svg"
# alt = "Your example logo alt text"
# And you can even create generic menu
[[menu.main]]
identifier = "blog"
name = "Blog"
url = "/posts"
Of course you are able to use all default shortcodes from hugo (https://gohugo.io/content-management/shortcodes/).
By default the theme is using PrismJS to color your code syntax. All you need to do is to wrap you code like this:
``` html // your code here ```
Check the docs.
A large variety of social icons are available and can be configured like this:
[[params.social]]
name = "<site>"
url = "<profile_URL>"
Take a look into this list of available icon options.
If you need another one, just open an issue or create a pull request with your wished icon. :)
Copyright © 2023-2024 Felix Dreier
The theme is released under the MIT License. Check the original theme license for additional licensing information.