Hugo Tanka

Overview

The Tanka theme is a minimalist theme built for Hugo and blogdown. It is based on Bootstrap 4 and features a responsive and mobile-first design. The layout of the theme is derived from the Black & Light theme created by David Hamp-Gonsalves. Tanka offers several key features including a native font stack, math typesetting using MathJaX, syntax highlighting with highlight.js, comments through Utterances, and meta tags for Open Graph and Twitter Cards. It also focuses on privacy by not including any web tracking functionality by default.

Features

• Minimalist: The Tanka theme follows a minimalist design approach, offering a clean and clutter-free layout.
• Responsive: Built on Bootstrap 4, the theme is responsive and optimized for mobile devices, ensuring a seamless browsing experience across different screen sizes.
• Native font stack: Tanka utilizes a native font stack, enhancing the readability and ensuring consistency across different devices and platforms.
• Math typesetting (MathJaX): The theme supports math typesetting using MathJaX, allowing users to easily integrate mathematical equations in their content.
• Syntax highlighting (highlight.js): Tanka includes syntax highlighting functionality through the use of highlight.js, enabling code snippets to be displayed in an aesthetically pleasing manner.
• Utterances comments: Users can engage in discussions and receive comments on their content using Utterances, a lightweight, open-source commenting system.
• Open Graph meta tags: Tanka includes Open Graph meta tags, improving how content is displayed when shared on social media platforms like Facebook.
• Twitter Cards meta tags: The theme also provides Twitter Cards meta tags, enhancing the appearance of shared content on Twitter.

Installation

To install the Tanka theme, follow these steps:

1. Inside the folder of your Hugo site, run the following command:

hugo new theme/tanka https://github.com/your-username/tanka

2. For more detailed information, refer to the official setup guide of Hugo.

3. Copy the config.toml file from the exampleSite folder of the Tanka theme to your Hugo site folder. Alternatively, you can use it as a reference to configure your own config.toml file.

Summary

The Tanka theme is a minimalist theme for Hugo and blogdown, based on Bootstrap 4. It offers a clean and responsive design, along with various features such as native font stack, math typesetting, syntax highlighting, and comments through Utterances. With the inclusion of Open Graph and Twitter Cards meta tags, the theme ensures that shared content appears visually appealing on social media platforms. The Tanka theme also prioritizes user privacy by not including any web tracking functionality by default. Overall, it provides an aesthetic and functional framework for creating content-rich websites.