Congo

Overview

Congo is a powerful and lightweight theme for Hugo, designed with a clean and minimalist design that focuses on prioritizing content. It utilizes Tailwind CSS and offers a range of features including multiple color schemes, dark mode, customizable configuration, flexible homepage layouts, multilingual content support, client-side site search, diagrams and visualizations, SEO-friendly design, and more. With extensive documentation and regular updates, Congo is a versatile theme suitable for various Hugo projects.

Features

• Fully responsive layout: Built with Tailwind CSS 3.0, Congo ensures a responsive design that adapts to different devices.
• Multiple color schemes and customization: Choose from pre-defined color schemes or fully customize your own to match your branding or personal preferences.
• Dark mode: Toggle dark mode on or off, or set it to auto-switch based on user preferences.
• Highly customizable configuration: Personalize and fine-tune various aspects of the theme to meet your specific requirements.
• Multiple homepage layouts: Select from different homepage layouts to showcase your content in different ways.
• Flexible with content types, taxonomies, and menus: Congo seamlessly integrates with different content types, taxonomies, and menus, providing versatility in organizing your website.
• Multilingual content support: Easily create multilingual websites with RTL language support.
• Third-party post linking: Ability to link posts on third-party websites.
• Client-side site search: Powered by Fuse.js, Congo offers a fast and efficient client-side search functionality for your website.
• Diagrams and visualizations: Congo supports the use of Mermaid for creating diagrams and visualizations, adding an interactive and visual element to your content.
• Charts using Chart.js: Embed interactive charts in your content using Chart.js.
• Mathematical notation using KaTeX: Include mathematical equations and notation with ease using KaTeX.
• SVG icons from FontAwesome: Access a vast library of scalable vector icons from FontAwesome.
• Automatic image resizing using Hugo Pipes: Hugo Pipes simplifies the process of resizing images, optimizing performance and loading times.
• Heading anchors, Tables of Contents, Code copy, Buttons, Badges, and more: Congo includes various elements and features that enhance the readability and usability of your content.
• HTML and Emoji support in articles: Enjoy the flexibility of incorporating HTML and emojis in your articles.
• SEO friendly: Congo is designed to be SEO-friendly, with built-in support for social media sharing and optimization.
• Fathom Analytics and Google Analytics support: Integrate Fathom Analytics or Google Analytics to track and analyze website traffic.
• RSS feeds, Favicons, and comments support: Congo supports RSS feeds, allows customization of favicons, and integrates with various comment plugins.
• Advanced customization using Tailwind color definitions and styles: Easily customize the theme using simple Tailwind color definitions and styles.
• Optimized for performance and accessibility: Congo is optimized for performance and accessibility, achieving high scores in Lighthouse tests.
• Fully documented with regular updates: Detailed documentation covering all aspects of the theme, with regular updates to ensure the latest features and improvements are available.

Installation

Congo supports multiple installation methods:

1. Hugo Module (easiest):

   • Ensure you have Go and Hugo installed.
   • Create a new Hugo project.
   • From your project directory, initialize Hugo Modules.
   • Create config/_default/module.toml and add the necessary configuration.
   • Start your server using hugo server and the theme will be automatically downloaded.
   • Delete the config.toml file generated by Hugo in the root folder of your website.
   • Copy the *.toml config files from the theme into your config/_default/ folder (excluding the module.toml file).
   • Follow the Getting Started instructions in the documentation to configure your website.

2. Git submodule:

   • Clone the Congo theme repository as a submodule of your Hugo project.
   • Follow the instructions in the Congo documentation for further configuration.

3. Manual install:

   • Download the theme files from GitHub.
   • Copy the theme files into your Hugo project’s themes/ directory.
   • Follow the Getting Started instructions in the documentation to configure your website.

For detailed installation instructions and further information on updating the theme, refer to the Congo documentation.

Summary

Congo is a feature-rich and versatile theme for Hugo, designed to provide a powerful and customizable platform for creating websites. With its extensive feature set, including multiple color schemes, dark mode, flexible layouts, multilingual support, client-side search, and more, Congo offers a range of options for creating unique and engaging websites. Additionally, with its easy installation methods and regular updates, Congo aims to provide a seamless and constantly improving user experience.