HexoBlog

hexo-theme-bp-gallery — Hexo Blog Template

By BP-Devteam

A Hexo blog theme ported from StartBootstrap's Clean Blog, supporting dark mode, Bootstrap 5, and image galleries.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-01View source

What stands out

A quick read of the recorded project description.

01

Ported from StartBootstrap's Clean Blog, with an editorial-style blog appearance

02

Provides both light and dark theme color schemes

03

Uses vanilla JavaScript, no jQuery dependency, with styles based on Bootstrap 5

04

Supports cover images for posts and pages, tags and categories, responsive images, and image galleries

05

Can integrate Google Analytics, a page counter, and Disqus or Facebook comments

Template Details

hexo-theme-bp-gallery is a blog theme written by BP-Devteam for Hexo. The README states that it is implemented from StartBootstrap's Clean Blog template, so the overall look is an editorial-style blog appearance. The theme provides both light and dark color schemes, and the repository includes screenshots of both modes on desktop.

Functionally, the theme uses vanilla JavaScript (no jQuery dependency) and Bootstrap 5, and declares that no custom CSS is written; Bootstrap Icons are built in. At the content level, it supports cover images for posts and pages, tags and categories, responsive images, and image galleries (via Lightbox for Bootstrap 5). It also integrates Google Analytics tracking code, a page counter (hexo-pagecounter), and Disqus or Facebook comments.

Configuration is centralized in the theme's _config.yml: menu items are defined in the form "label: path", the top-left title can be customized or left blank to use the site title, the homepage cover image applies to all index-type pages, and the pagination per_page is recommended to be 4, 8, 12, or 16; setting it to 0 disables pagination. At the post level, front-matter specifies the author, cover image, share cover image, and comment: false to disable comments. Note that the theme does not support traditional excerpts; the excerpt text on index pages must be provided via the subtitle field.

Regarding licensing, the repository uses the MIT license, allowing free use, modification, commercial use, and distribution, provided copyright and license notices are retained; the licensing of third-party assets such as demo images, fonts, and icons must be verified separately.

HexoBlog

Is it right for your project?

Use Cases

  • Building a personal or team Hexo blog focused on article reading
  • An illustrated blog that needs dark mode and image gallery display
  • A Hexo site where styles are quickly adjusted using the Bootstrap 5 system

Suitable For

  • Developers using Hexo to generate static blogs
  • Users who prefer a clean editorial layout style like Clean Blog
  • Bloggers who need basic content capabilities such as tags, categories, cover images, and galleries

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Clone the theme into themes/bp-gallery and set theme to bp-gallery in the site _config.yml

  2. 2

    Configure options such as menus, top-left title, homepage cover image, pagination, and comments in the theme _config.yml

  3. 3

    Choose either Disqus or Facebook for comments; filling in both will render two comment sections under a post

  4. 4

    Post excerpts must use the subtitle field in front-matter; the theme does not support traditional excerpts

  5. 5

    The repository uses the MIT license; copyright and license notices must be retained when used, and third-party asset licensing must be verified separately

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Comment functionality requires choosing one: if both the Disqus shortname and Facebook appid are filled in, each post will render two comment sections, so only one can be enabled.
  • Enabling Google Analytics requires providing your own tracking ID and is an optional configuration that depends on an external third-party service.
  • The theme does not support traditional excerpts; the excerpt text on index pages must instead be provided via the subtitle field in front-matter.
  • Pagination is controlled by per_page; setting it to 0 disables pagination. The README recommends values of 4, 8, 12, or 16.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

If you specify both a `disqus_shortname` and a `facebook.appid` there will be 2 sets of comment per post. So choose one.

Original README

The Google Analytics Tracking ID is configured in the theme's `_config.yml`.

Original README

This theme does not support traditional excerpts. To show excerpts on the index page, use `subtitle` in the front-matter

Original README

## Set per_page to 0 to disable pagination

Original README
https://github.com/BP-Devteam/hexo-theme-bp-gallery/blob/main/LICENSEhttps://github.com/BP-Devteam/hexo-theme-bp-gallery/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 60 / 100
Technologies
Hexo
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2024-01-26
Screenshot last checked
2026-10-03

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hexo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 26ce1f0c31ac6a7a3bbb5e1a23d41b83e667dc2b3541fdd744e177e99d3c15d5

2026-10-03T05:16:22.613Z

Source file / repository
# BP Gallery for Hexo

## Light mode 
![](https://github.com/BP-Devteam/hexo-theme-bp-gallery/blob/main/source/images/pc_light.png?raw=true)

## Dark mode 
![](https://github.com/BP-Devteam/hexo-theme-bp-gallery/blob/main/source/images/pc_dark.png?raw=true)

Hexo implementation of [Clean Blog](http://blackrockdigital.github.io/startbootstrap-clean-blog/index.html)

## Demo 
![Hexo-theme-bp-gallery](https://hexo-theme-bp-gallery.web.app/)

## Features

- Dark Theme
- **vanillaJS** (No Jquery)
- **BootStrap5** (No custom CSS)
- Google Analytics
- Cover image for posts and pages
- Tags and Categories Support
- Responsive Images
- Image Gallery
- [Bootstrap Icons](https://icons.getbootstrap.com/)
- Page Counter

## External libraries used

- [Bootstrap](https://getbootstrap.com/) (included)
- [Lightbox for Bootstrap 5](https://github.com/trvswgnr/bs5-lightbox) (Gallery)
- [Page Counter](https://github.com/BP-Devteam/hexo-pagecounter)

## Installation

```
$ git clone https://github.com/BP-Devteam/hexo-theme-bp-blog themes/bp-gallery
```

Then update your blog's main `_config.yml` to set the theme to `bp-gallery`:

```
# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: bp-gallery
```

## Configuration

### Menu

The menu is configured in the theme's `_config.yml`.

```
# Header
menu:
  Archives: /archives
  Github: https://github.com/BP-Devteam/hexo-theme-bp-gallery
```

The object key is the label and the value is the path, or you can use a icon (font awesome) like menu item.

### Top Left Label

The top left label is configured in the theme's `_config.yml`. When clicked it will lead to the Home Page.

```
# Title on top left of menu. Leave empty to use main blog title
menu_title: Configurable Title
```

### Home Page cover image

The Home Page cover is configured in the theme's `_config.yml`. It will be the same for all index type pages.

```
# URL of the Home page image
index_cover: /img/home-bg.jpg
```

### Default post title

The default post title (used when no title is specified) is configured in the theme's `_config.yml`.

```
# Default post title
default_post_title: Untitled
```


### Recommeded per_page

4,8,12,16

```
# Pagination
## Set per_page to 0 to disable pagination
per_page: 12
```

### Comments

The comments provider is specified in the theme's `_config.yml`. If you specify both a `disqus_shortname` and a `facebook.appid` there will be 2 sets of comment per post. So choose one.

```
# Comments. Choose one by filling up the information
comments:
  # Disqus comments
  disqus_shortname: klugjotest
  # Facebook comments
  facebook:
    appid: 123456789012345
    comment_count: 5
    comment_colorscheme: light
```

You can too hide the comment in the posts front-matter:

```
comment: false
---
```

### Google Analytics

The Google Analytics Tracking ID is configured in the theme's `_config.yml`.

```
# Google Analytics Tracking ID
google_analytics:
```

### Social Account

Setup the links to your social pages in the theme's `_config.yml`. Links are in the footer.

```
# Social Accounts
twitter_url:
facebook_url:
github_url: https://github.com/BP-Devteam/hexo-theme-bp-blog
linkedin_url:
mailto:
```

### Author

The post's author is specified in the posts front-matter:

```
author: BP.jason
---
```

### Post's Cover Image

By default, posts will use the home page cover image. You can specify a custom cover in the front-matter:

```
title: Excerpts
date: 2013-12-25 00:23:23
tags: ["Excertps"]
cover: /assets/contact-bg.jpg
---
```

### Post's Share Cover Image

You can specify a custom cover to share yours posts in social medias:

```
share_cover: /assets/contact-bg.jpg
---
```

### Post's Excerpt

This theme does not support traditional excerpts. To show excerpts on the index page, use `subtitle` in the front-matter:

```
title: Excerpts
date: 2013-12-25 00:23:23
tags: ["Excertps"]
subtitle: Standard Excerpts are not supported in Clean Blog but you can use subtitles in the front matter to display text in the index.
---

```


## Creator

This theme was created by [BP-Devteam](https://github.com/BP-Devteam)

## License

MIT
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.