Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/526avijitgupta/gokarna

A minimal opinionated theme for Hugo
https://github.com/526avijitgupta/gokarna

blog hugo hugo-theme theme

Last synced: about 1 month ago
JSON representation

A minimal opinionated theme for Hugo

Host: GitHub
URL: https://github.com/526avijitgupta/gokarna
Owner: 526avijitgupta
License: gpl-3.0
Created: 2021-05-22T08:45:30.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-09-26T11:12:08.000Z (about 2 months ago)
Last Synced: 2024-09-29T05:40:54.094Z (about 1 month ago)
Topics: blog, hugo, hugo-theme, theme
Language: HTML
Homepage: https://gokarna-hugo.netlify.app
Size: 14.4 MB
Stars: 343
Watchers: 7
Forks: 135
Open Issues: 14
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Gokarna

Gokarna is an opinionated theme with a focus on minimalism and simplicity.

### Authors:

- [Yash Mehrotra](https://yashmehrotra.com)

- [Avijit Gupta](https://twitter.com/526avijit)

#### Major Contributors

- [James Davidson](https://jamesdavidson.xyz)

- [David Kröll](https://davidkroell.com)

- [Mansoor Barri](https://mansoorbarri.com)

### Demo: [https://gokarna-hugo.netlify.app](https://gokarna-hugo.netlify.app)

## Support the developer

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/avijitgupta)

## Features

- Minimalistic & fast

- Customizable header

- Responsive

- Available in light and dark themes

- Native fonts and support for [feather icons](https://feathericons.com/) and [svg icons](https://gokarna-hugo.netlify.app/posts/theme-documentation-advanced/#icons-on-homepage)

- Syntax highlighting

- SEO Ready

- Table of contents which can be configured per page

- Option to add custom javascript and css

- RSS Feed

- Math typesetting using [Katex](https://gokarna-hugo.netlify.app/posts/theme-documentation-advanced/#katex)

## Screenshots

### Homepage

Light Mode                                                      | Dark Mode

:-------------------------:|:-------------------------:

![Light mode](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/screenshot-light-home.png "Light mode") | ![Dark mode](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/screenshot-dark-home.png "Dark mode")

### Post page

Light Mode                                                      | Dark Mode

:-------------------------:|:-------------------------:

![Light mode](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/screenshot-light-post.png "Light mode") | ![Dark mode](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/screenshot-dark-post.png "Dark mode")

### List page

Light Mode                                                      | Dark Mode

:-------------------------:|:-------------------------:

![Light mode](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/screenshot-light-list.png "Light mode") | ![Dark mode](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/screenshot-dark-list.png "Dark mode")

## Installation

Follow details installation steps in the [documentation here](https://gokarna-hugo.netlify.app/posts/theme-documentation-basics/#installation)

```sh

git submodule add https://github.com/526avijitgupta/gokarna.git themes/gokarna

```

## Customization

For a complete guide on customization, please go through our [basic](https://gokarna-hugo.netlify.app/posts/theme-documentation-basics/) and [advanced](https://gokarna-hugo.netlify.app/posts/theme-documentation-advanced/) theme documentation. A gist of things you can customize:

- Navigation menu

- Avatar image and size

- Accent color

- Theme mode (Auto, Light & Dark)

- Custom HTML in head and footer section for loading any scripts

- Syntax highlighting

- Option to show posts recent or popular homepage.

- Footer

## Inspiration

The theme is inspired by and accordingly named after [Gokarna](https://en.wikipedia.org/wiki/Gokarna,_Karnataka), a small and peaceful beach town on the west coast on India.

![Gokarna](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/gokarna.jpg)

## Performance

Google Lighthouse check score: 100%

![Lighthouse Score](https://raw.githubusercontent.com/526avijitgupta/gokarna/main/images/lighthouse.png)

## LICENSE

This code is licensed under [GNU GPLv3](https://www.gnu.org/licenses/gpl-3.0.html)