Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/binokochumolvarghese/lightbi-hugo

Lightbi is a minimal and clean blog theme for Hugo.
https://github.com/binokochumolvarghese/lightbi-hugo

blog blog-theme hugo hugo-theme lightbi-hugo minimal responsive theme

Last synced: about 1 month ago
JSON representation

Lightbi is a minimal and clean blog theme for Hugo.

Awesome Lists containing this project

README

        

# Lightbi

Lightbi is a sleek, minimalistic, and clean blog theme designed for Hugo, offering a simple yet elegant user experience.

🌍 [Demo site](https://lightbi-hugo-theme.netlify.app/)
πŸ“ [Demo repo](https://github.com/binokochumolvarghese/lightbi-hugo-demo)
πŸ› [Bug reports & Issues](https://github.com/binokochumolvarghese/lightbi-hugo/issues)
πŸ’‘ [Questions & feature requests](https://github.com/binokochumolvarghese/lightbi-hugo/discussions)
πŸ“„ [Lightbi wiki](https://github.com/binokochumolvarghese/lightbi-hugo/wiki)
πŸ•ΈοΈ [Websites built with Lightbi](https://github.com/binokochumolvarghese/lightbi-hugo/wiki/Websites-built-with-Lightbi)

![LightBi Hugo Theme Screenshot](https://raw.githubusercontent.com/binokochumolvarghese/lightbi-hugo/master/images/screenshot.png)

## Features

### General
- **Three Main Content Sections:**
- **Blog**
- **Notes**
- **Collections** (Newsletter)

- **Responsive Design**:
- Built with a **mobile-first approach** for seamless viewing on any device.

- **Card-Based Theme**:
- Flexible image placement options:
- Image at the top of the card
- Image in the middle of the card
- Image at the bottom of the card
- No image option

- **Menu Location Indicator**:
- Clear visual cues for active menu items.

- **Multilingual Support**:
- Includes a **language selector** for easy switching between languages.

- **Taxonomies**:
- Organize content effectively with customizable tags and categories.

- **Search Functionality**:
- Integrated search option for quick content access.

- **Light/Dark Theme**:
- **Automatic theme switching** based on browser preferences.
- Includes a manual **theme-switch button** for user control.

- **Google Analytics Integration**:
- Track user activity with built-in support for Google Analytics.

- **SEO-Friendly**:
- Optimized for search engines to improve visibility.

- **Commit SHA in Footer**:
- Display the current **commit SHA** for version tracking.

- **Self-Hosted Assets**:
- Compliant with **GDPR / EU-DSGVO** regulations by hosting all assets locally.

- **Bootstrap Icons**:
- Beautiful, lightweight icons integrated with **Bootstrap Icons**.

### Page
- Other Posts suggestion below a post.
- Social-Media Share buttons on posts.
- Syntax highlighting.
- Cover image for each post (with Responsive image support).

### Card based theme.
To customize the image placement within a card, the Lightbi theme offers four flexible options:

- Image at the top of the card
- Image in the middle of the card
- Image at the bottom of the card
- No image

To configure this, use the `previewCardImagePlacement` parameter in the `hugo.toml` file. Set it as follows:
- For the image at the top: `previewCardImagePlacement = "top"`
- For the image in the middle: `previewCardImagePlacement = "middle"`
- For the image at the bottom: `previewCardImagePlacement = "bottom"`
- For no image: `previewCardImagePlacement = "none"`

This gives you full control over how the image is displayed in the card layout.

## Installation

Install Hugo and create a new site. See [the Hugo documentation](https://gohugo.io/getting-started/quick-start/) for details.

```
hugo new site
cd
git init
git submodule add https://github.com/binokochumolvarghese/lightbi-hugo themes/lightbi-hugo
echo "theme = 'lightbi-hugo'" >> hugo.toml
hugo server
```

After the above copy the contents of `exampleSite` to the `content` folder in your website.

## Wiki

Checkout the [wiki](https://github.com/binokochumolvarghese/lightbi-hugo/wiki) page for detailed documentation of the theme features.

## Support & Contribution

- **Star 🌟 this repository** to show your support!
- **Help spread the word** about Hugo Lightbi by sharing it on social media and recommending it to your friends and colleagues.
- **Found a bug?** Report it via [GitHub Issues](https://github.com/binokochumolvarghese/lightbi-hugo/issues/new) to help us improve.
- **Have feature ideas?** Start a conversation in [GitHub Discussions](https://github.com/binokochumolvarghese/lightbi-hugo/discussions).
- **Got questions?** Ask away in our [GitHub Discussions](https://github.com/binokochumolvarghese/lightbi-hugo/discussions) community.

## Credits

- [Beautiful Hugo](https://github.com/halogenica/beautifulhugo) from which Lightbi was forked.
- [Unsplash](https://unsplash.com/) for Images.

## About

This is an adaptation of the [Beautiful Hugo](https://github.com/halogenica/beautifulhugo) by [Michael Romero](https://github.com/halogenica). It supports most of the features of the original theme, and many new features. It has diverged from the original theme over time, with several updates.

## License

MIT Licensed, see [LICENSE](https://github.com/binokochumolvarghese/lightbi-hugo/blob/master/LICENSE).