Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kaushikgopal/henry-hugo
Henry: Hugo theme meant for a gorgeous reading experience and packed with features
https://github.com/kaushikgopal/henry-hugo
blog font github-pages golang gorgeous-responsive-theme hugo hugo-blog-theme hugo-theme hugo-themes ibm-plex personal-site recursive responsive static-site-generator theme-site themes-jekyll
Last synced: about 2 months ago
JSON representation
Henry: Hugo theme meant for a gorgeous reading experience and packed with features
- Host: GitHub
- URL: https://github.com/kaushikgopal/henry-hugo
- Owner: kaushikgopal
- License: mit
- Created: 2021-07-10T07:28:24.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-31T18:02:42.000Z (about 2 months ago)
- Last Synced: 2024-07-31T22:12:58.981Z (about 2 months ago)
- Topics: blog, font, github-pages, golang, gorgeous-responsive-theme, hugo, hugo-blog-theme, hugo-theme, hugo-themes, ibm-plex, personal-site, recursive, responsive, static-site-generator, theme-site, themes-jekyll
- Language: HTML
- Homepage: https://kau.sh/henry/
- Size: 2.81 MB
- Stars: 50
- Watchers: 4
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-github-stars - kaushikgopal/henry-hugo - Henry: Hugo theme meant for a gorgeous reading experience and packed with features (HTML)
README
# Henry
Henry is a [Hugo](https://gohugo.io/) theme with a gorgeous reading experience, chock-full of features. To find out more about all the features check out this [blog post](https://kau.sh/blog/henry-hugo-theme/).
# Getting Started
These are the instructions for setting up a hugo blog with the Henry theme.
```shell
# 1. Install Hugo
# https://gohugo.io/getting-started/installing/
brew install hugo
hugo new site blog-henry
cd blog-henry
# 2. clone Henry
git clone https://github.com/kaushikgopal/henry-hugo.git themes/henry
# brew install node # if you don't have npm installed
cd themes/henry
npm install -D tailwindcss
npx tailwindcss -i assets/css/input.css -o ../../assets/css/output.css
# 3. configure blog
## add these lines to your hugo.toml config file
theme = "henry"
# 4. run Hugo!
# Option 1: in two separate tabs
npx tailwindcss -i assets/css/input.css -o ../../assets/css/output.css --watch
# go back to the root of your hugo project
cd ../.. && hugo server --bind=0.0.0.0 --cleanDestinationDir --logLevel debug --disableFastRender --gc --minify
--noHTTPCache --printI18nWarnings --buildDrafts
# Option 2: use a single dev script
# See my blog post on this https://kau.sh/blog/tailwind-hugo#bonus-tip
# open http://0.0.0.0:1313/
# sample posts are in henry's content folder : themes/henry/content
# if you want to see some samples, just mark them from draft true → false
```
You're good to go. Happy blogging!
Now, whenever you need to get your hugo blog up and running again, just run `./bin/dev`.
## Optional configurations
Here are some recommended customizations to make in your `hugo.toml` config file in addition to what was mentioned above.
### RSS/JSON feed customizations
```toml
## hugo.toml
# enable .json RSS feeds
[outputFormats]
# output formats
# https://gohugo.io/templates/output-formats/#output-format-definitions
[outputFormats.rss]
mediatype = "application/rss"
# change RSS path for default XML feed to /feed.xml (default index.xml)
baseName = "feed"
[outputFormats.json]
# change RSS path for JSON feed to /feed.json
baseName = "feed"
# configure RSS feeds for specific pages
[outputs]
# output format for pages
# https://gohugo.io/templates/output-formats/#output-formats-for-pages
page = ["html"]
home = ["html", "rss","json"]
# sections = directories e.g. blog, letters, ppt
section = ["html","rss","json"]
# taxonomies = virtual tags/directories e.g. categories, tags (built-in)
# no rss for these as they're mostly "list" pages
taxonomy = ["html"]
# terms = values of taxonomies e.g. categories/programming
term = ["html", "rss","json"]
```
### Related posts customization
```toml
## hugo.toml
[related]
includeNewer = true
threshold = 80
toLower = true
# weight index distribution tags > categories > title
[[related.indices]]
name = "tags"
weight = 80
[[related.indices]]
name = "categories"
weight = 20
[[related.indices]]
name = "title"
weight = 10
```
# Henry in the Wild
Here are a couple of blogs that use Henry:
1. [Karthick Gopal's blog](https://karthickg.com/blog)
2. [Kaushik Gopal's blog](https://kau.sh/blog)
# License
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
_Bug reports and pull requests are welcome on [GitHub](https://github.com/kaushikgopal/henry-hugo). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct._