https://github.com/robert-riordan-ucd/robs-light-bi
https://github.com/robert-riordan-ucd/robs-light-bi
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/robert-riordan-ucd/robs-light-bi
- Owner: Robert-Riordan-UCD
- License: mit
- Created: 2025-02-01T13:47:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-07T07:47:47.000Z (about 1 year ago)
- Last Synced: 2025-05-07T08:41:53.623Z (about 1 year ago)
- Language: HTML
- Size: 13 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
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)
## 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).