Cocoa Hugo Theme

Overview:

Cocoa is a consistent and responsive Hugo theme that offers clean typography. It is designed for blogging and personal webpages, and provides various features such as support for Disqus comments, a built-in 404 page, syntax highlighting with highlightjs, Gravatar/static profile image, RSS feed and icon, optimized SVG icons for social media platforms, cache busting, and support for Google Analytics, Piwik, and Gitalk. The theme is highly customizable, allowing users to enable or disable different features according to their preference. Cocoa is licensed under the MIT License and is open to contributions from the open-source community.

Features:

• Responsive: The theme is designed to be fully responsive, adapting to different screen sizes and devices.
• Suited for blogging and personal webpages: Cocoa is tailored to meet the needs of bloggers and individuals looking to create personal websites.
• Disqus support: The theme integrates seamlessly with Disqus, allowing users to enable comments on their posts.
• Built-in 404 page: Cocoa includes a default 404 page for when a page is not found, providing a better user experience.
• Syntax highlighting with highlightjs: Code snippets in blog posts are highlighted using highlightjs for better readability.
• Gravatar/static profile image: Users can add their Gravatar image or a static profile image to personalize their website.
• RSS feed and icon: Cocoa supports RSS feeds and provides an RSS icon to enable users to subscribe to their blog.
• Optimized SVG icons: The theme includes optimized SVG icons for popular social media platforms, such as Instagram and 500px.
• Cache busting: Cocoa implements cache busting techniques to ensure that users always see the latest version of the website.
• Google Analytics: Users can easily integrate Google Analytics to track website traffic and visitor analytics.
• Piwik and Gitalk support: Cocoa also supports Piwik and Gitalk for alternative analytics and comment systems.

Installation:

To install the Cocoa theme for your Hugo site, follow these steps:

1. Clone the theme into the themes/cocoa directory from the root of your Hugo site:

   git clone [theme repository URL] themes/cocoa
   

2. Configure the theme by modifying the sample config.toml file. If you are updating from an older version of Cocoa and have updated to Hugo 0.18, make sure to lowercase every params in your existing config.toml to match the sample.

3. Create new blog posts by adding them under the directory content/blog. To have the posts appear on your site, ensure that the draft field in the post’s front matter is set to false, or alternatively, use the –buildDrafts option when building.

4. For fixed pages like an About page, place them under the content/fixed directory or at the root of the content directory.

Summary:

Cocoa is a responsive and customizable Hugo theme suitable for bloggers and personal webpages. It offers various features such as Disqus comments, syntax highlighting, built-in 404 page, social media icons, and analytics support. The theme can be easily installed and configured according to individual preferences. By being open source, users can contribute to the development and improvement of Cocoa. It is licensed under the MIT License, allowing users to freely use and modify the theme.