Overview

The AllinOneHugo theme is a versatile theme designed for blogging and personal webpages. It offers a range of features including a responsive full image carousel, smooth scroll and hierarchical table of contents scrollspy, syntax highlighting, and support for LaTeX equations. The theme also includes built-in features such as tags, series, and categories, as well as pagination and previous/next post buttons. Most features can be individually enabled or disabled in the configuration settings.

Features

• Responsive full image carousel
• Suited for blogging and personal webpages
• Smooth scroll and hierarchical table of contents scrollspy
• Syntax highlighting with highlightjs
• Support for LaTeX equations using Katex
• Google Analytics integration
• Font Awesome 3.1.0 icons
• Built-in tags, series, and categories
• Show recommendations in the sidebar
• Built-in pagination for sections
• Previous/Next post buttons
• Post card list with summary and intro picture
• Series card list in the sidebar

Installation

To install the AllinOneHugo theme, follow these steps:

1. Clone the theme into the themes/AllinOne directory of your Hugo site.

   git clone [theme-url] themes/AllinOne
   

2. Open the sample config.toml file provided with the theme and customize the settings according to your needs.

   cp themes/AllinOne/exampleSite/config.toml .
   

3. Set the directory path and URL for the carousel images in the config.toml file.

   slidesDirPath = "path/to/slides"
   slidesDirPathURL = "/relative/url/to/slides"
   

4. Add the image path to the YAML front matter of each post for Post Intro Pictures.

   ---
   title: My Post
   date: 2021-01-01
   image: /path/to/image.jpg
   ---
   

5. Customize the post summary with one of the following methods:

   a. Hugo-defined Summary Split: Hugo automatically takes the first 70 words of the content as the summary. Set summaryLength in config.toml to change the length.

   b. User-defined Summary Split: Add `

` where you want to split the article and the content before it will be used as the summary.

c. User-defined Summary: Add a summary parameter in the YAML front matter of the post with the desired summary.

6. Customize the series intro picture by replacing the default image located at themes/AllinOne/static/img/default.png with your own image.

7. Build and run your Hugo site.

   hugo serve
   

Summary

The AllinOneHugo theme is a feature-rich theme for Hugo websites. It offers a range of customization options for creating blogging and personal webpages. With its responsive carousel, smooth scroll, and syntax highlighting, the theme provides an engaging and visually appealing experience for website visitors. The built-in features, such as tags, series, and categories, make it easy to organize and navigate through content. Overall, the AllinOneHugo theme is a great choice for individuals looking to create a stylish and functional website with Hugo.