Overview
Hugo Now is a Hugo port of Jekyll Now, inspired by Hemingway. It offers a stylish and user-friendly theme for Hugo websites.
Features
- Tags: Easily categorize your content using tags.
- Titles: Attention-grabbing titles for your posts and pages.
- Table of Contents: Toggle the visibility of a table of contents for your content.
- Installation: Simple and easy installation process.
- Supports SVG: Use vector graphics instead of traditional image formats for better styling and less bandwidth consumption.
- Pygments styles: Customize the syntax highlighting style in your code snippets.
- Build SASS: Automatically compile Sass stylesheets for easy customization.
- Production-ready: Use the minified CSS for improved website performance.
Installation
There are two methods to install Hugo Now, both of which are outlined below.
Hugo Module - Preferred
- Add Hugo Now as a module:
hugo mod add github.com/mikeblum/hugo-now
- Update to the latest version:
hugo mod get -u github.com/mikeblum/hugo-now
Git Submodule
- Add Hugo Now as a submodule:
git submodule add git@github.com:mikeblum/hugo-now.git themes/hugo-now
- Commit your .gitmodules file.
Usage
To use Hugo Now, follow these steps:
- Configure the
config.tomlfile. - Use SVG files instead of PNG or JPG for better styling and performance.
- Customize Pygments styles by changing the
sass/style.scssfile. - Build your Hugo website:
hugo
- Visit
localhost:1313to see the Hugo Now theme in action.
For Sass development, use the following commands:
- To build Sass updates and watch for changes:
sassc -w sass/style.scss static/css/style.css
- For production, use this command to generate minified CSS:
sassc -t compressed sass/style.scss static/css/style.css
- Set the
HUGO_ENVvariable toproductionto use the minified CSS.
Summary
Hugo Now is a versatile and customizable theme for Hugo websites, offering features like tags, table of contents, and customizable styles. It can be easily installed as a Hugo module or as a Git submodule. Its responsive design and modern aesthetics make it a great choice for various types of websites.