Overview:

The Minos theme is a simple and retro styled theme designed to focus on the user’s ideas. It is a port of the Minos theme from Hexo to Hugo and requires Hugo version 0.59 or higher. The theme includes features such as a gallery, commenting, search box, hierarchical categories, smart table of contents, Disqus integration, Google Analytics integration, KaTeX support, and syntax highlighting using highlight.js.

Features:

• Gallery (fancybox): Includes a gallery feature for displaying images.
• Duoshuo comment: Allows users to leave comments on articles using the Duoshuo comment system.
• Search box: Provides a search box for users to search for specific content.
• Hierarchical categories: Supports hierarchical categories, which are not natively supported in Hugo.
• Smart table of contents: Automatically generates a table of contents for articles and highlights and expands the current section in the table of contents.
• Disqus: Integrates with the Disqus commenting system.
• Google Analytics: Includes support for tracking website analytics using Google Analytics.
• KaTeX: Enables the KaTeX auto-render extension for rendering math equations.
• Syntax highlighting: Uses highlight.js for syntax highlighting in code blocks.

Installation:

To install the Minos theme, follow these steps:

1. Clone the repository to the themes/ directory of your Hugo project.

   git clone https://github.com/ppoffice/hugo-theme-minos.git themes/hugo-theme-minos
   

2. Specify hugo-theme-minos as your default theme in the config.toml file of your Hugo project. Add the following line:

   theme = "hugo-theme-minos"
   

3. Configure additional options in the config.toml file to customize the theme’s behavior. Available options include pagination, smart table of contents, post navigation, Disqus integration, Google Analytics integration, and KaTeX support.

4. Customize the theme’s appearance by adding custom CSS and adjusting other configuration variables.

Summary:

The Minos theme is a simple and retro styled theme that aims to highlight the user’s ideas. It offers several features including a gallery, commenting system, search box, hierarchical categories, smart table of contents, Disqus integration, Google Analytics integration, KaTeX support, and syntax highlighting. Installing the theme is straightforward and additional customization options are available in the config.toml file.