Mainroad

Mainroad is a responsive, simple, clean, and content-focused Hugo theme based on the MH Magazine lite WordPress theme. It is designed for ease of use and broad compatibility, making it an excellent choice for various static websites.

Key Features:

• Responsive Design: Ensures optimal viewing experience across a wide range of devices.
• Navigation: Includes main and secondary menus for structured content organization.
• Widgetized Sidebar: Offers flexible layout options with customizable widgets.
• Multilingual Support: Provides translations for over 15 languages.
• Configurable Settings: Theme settings such as sidebar position, author box, post navigation, and highlight color are easily adjustable via config.toml.
• Hugo Internal Templates: Integrates seamlessly with Hugo's built-in features like Open Graph, Schema, Twitter Cards, Disqus, and Google Analytics for enhanced functionality and SEO.
• Cross-Browser Compatibility: Supports modern desktop browsers (IE11+, Chrome, Firefox, Safari) and mobile browsers (Android 4.4+, iOS 7+, Google Chrome, Opera Mini).
• Advanced Typography: Supports custom Google Fonts, MathJax for mathematical notation, Table of Contents, and SVG icons.

Installation and Configuration: To install Mainroad, ensure you have Hugo installed and a new site created. Then, clone the theme into your project's themes directory:

git clone https://github.com/vimux/mainroad.git themes/mainroad

Alternatively, add it as a Git submodule for easier updates:

git submodule add https://github.com/vimux/mainroad.git themes/mainroad

Finally, set theme = "mainroad" in your config.toml file. The theme offers extensive configuration options through config.toml and front matter, allowing customization of site description, copyright, OpenGraph, Schema, Twitter Cards, readmore button, authorbox, Table of Contents (TOC), pager navigation, post meta information order, main sections for homepage display, date format, MathJax support, Google Fonts, and custom CSS/JS files. Sidebar layouts can be configured for home, list, and single pages, with various widgets like search, recent articles, categories, taglist, social links, and languages. Social links can be customized for platforms like Facebook, Twitter, Instagram, LinkedIn, Telegram, GitHub, GitLab, Bitbucket, and email, with support for custom social links including icons.