Technology Toolbox Hugo theme

This repository contains the Hugo theme used for the Technology Toolbox website: https://www.technologytoolbox.com.

Features

• Responsive design (mobile friendly)
• Site structure designed for hundreds (or even thousands) of blog posts organized by year/month/day
• Multiple taxonomies for blog content (view posts by tags, categories, or date)
• Bootstrap 5 (for styles and components)
• Bootstrap Icons (for small, inline SVG images)
• Commento (for blog comments)
• Uses Cloudflare content delivery network (CDN) for third-party libraries
• Improved Google Analytics to support Content Security Policy for reducing the risk of cross-site scripting (XSS) attacks
• Syntax highlighting for code samples

Installation

Important: This theme requires installing the "extended" version of Hugo in order to compile Sass/SCSS.

1. If you are using Hugo for the first time, complete the Hugo Quick Start first.

2. Copy the theme to your website (or, better yet, clone the repository for the Technology Toolbox website and add the theme to your local copy):

   git submodule add https://github.com/technology-toolbox/techtoolbox-hugo themes/techtoolbox-hugo

3. Specify the theme in the configuration file:

   theme = "techtoolbox-hugo"

4. Install NPM dependencies:

   pushd themes/techtoolbox-hugo
   npm install
   popd

   Note: If you are working with a local copy of the Technology Toolbox website, then you also need to install the NPM dependencies for the website itself. Assuming you are in the website folder, simply run:

   npm install

5. Start the Hugo server:

   hugo server

6. Browse the website: http://localhost:1313/

Site configuration

config.toml

baseURL = "https://www.technologytoolbox.com/"
languageCode = "en-us"
title = "Technology Toolbox"
theme = "techtoolbox-hugo"

enableGitInfo = true

googleAnalytics = "UA-12345678-1"

[markup]
  [markup.highlight]
    noClasses = false # Use class attributes for code syntax highlighting

  [markup.goldmark.renderer]
    unsafe= true

[menu]

  [[menu.main]]
    identifier = "services"
    name = "Services"
    url = "/services"
    weight = 10

  [[menu.main]]
    identifier = "company"
    name = "Company"
    url = "/company"
    weight = 20

  [[menu.main]]
    identifier = "blog"
    name = "Blog"
    url = "/blog/jjameson"
    weight = 30

[permalinks]
  categories = "/blog/jjameson/category/:title/"

[social]
  github = "technology-toolbox"
  twitter = "techtoolbox_"

Contributing

If you find a bug, have a question, or would like to submit a feature idea, please use the issues list.

If you would like to contribute, please fork the repository and make the changes in a feature branch. Pull requests are welcome!

License

This theme is released under the MIT License.