HexoBlog

hexo-theme-paperbox — Hexo Blog Template

By sun11

hexo-theme-paperbox is a Hexo blog theme modified from Landscape-plus, featuring a paper-like appearance and responsive layout, with additions including Swiftype search, Mathjax support, article table of contents, and blocking of WeChat built-in browsing.

Open Source Site Download Source ZIP

Explore the design

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

2 previews

Desktop homepage1 / 2

Visit websiteOpens in a new tab

Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-01View source

What stands out

A quick read of the recorded project description.

Paper-like appearance that visually guides readers to focus on article content

Responsive design with a minimum width of 320px, adaptable to small-screen phones

Integrates Swiftype site search, enabled by configuring swiftype_key

Supports Mathjax, requiring the hexo-renderer-kramed plugin

Article table of contents can be shown via toc: true in articles

WeChat built-in browsing can be blocked by configuring wx_block: true

Template Details

Paperbox is a Hexo blog theme modified by the author from Landscape-plus (based on Landscape), primarily for personal use. The theme takes a paper-like appearance as its visual direction, emphasizing letting readers focus on article content, and uses a responsive design with a minimum width of 320px, adaptable to small-screen devices such as iPhone 4 through 5s.

Functionally, the theme makes several adjustments relative to Landscape-plus: it integrates Swiftype site search, which requires setting swiftype_key in _config.yml to enable; it removes Baidu Share due to conflicts with Swiftype; it replaces Pinterest in the share buttons with Linkedin and adds sharing for four Chinese social platforms: Weibo, Renren, Qzone, and WeChat. The theme also supports Mathjax, but requires installing the hexo-renderer-kramed plugin and removing hexo-renderer-marked, while setting mathjax: true in _config.yml. The article table of contents requires setting toc: true in the article front-matter, and heading numbers are not displayed by default. Additionally, WeChat built-in browsing can be blocked via wx_block: true.

Regarding browser support, the theme targets IE9+ and the then-current versions of mainstream browsers, and explicitly does not support WeChat built-in browsing. The README records Hexo version 3.1.1 and Node.js version v4.2.6, an older development environment, so compatibility with current Hexo and Node.js versions should be noted. The theme uses the MIT license, allowing free use, modification, commercial use, and distribution, but third-party assets such as demo images, fonts, and icons must be checked separately for their licenses.

HexoBlog

Is it right for your project?

Use Cases

Building a personal blog with Hexo and wanting a paper-style theme
Sites that need to enable Swiftype site search in the blog
Writing articles with mathematical formulas and wanting to render them with Mathjax
Blog authors who want to provide table of contents navigation for articles
Blogs that need to block access from WeChat built-in browser

Suitable For

Individual users building static blogs with Hexo
Sites preferring a paper style and content-first reading experience
Blogs needing site search, mathematical formulas, or article table of contents
Developers able to handle compatibility issues of an older theme version themselves

Getting started & customization

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

1
Enabling Swiftype search requires setting swiftype_key in _config.yml
2
Enabling Mathjax requires installing hexo-renderer-kramed and removing hexo-renderer-marked, and setting mathjax: true
3
The article table of contents requires setting toc: true in the front-matter of the corresponding .md file
4
Blocking WeChat built-in browsing requires setting wx_block: true in _config.yml
5
The README records Hexo version 3.1.1 and Node.js version v4.2.6; confirm compatibility with the current environment before use

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 is the code of this version and does not mean 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 complete 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

Enabling Swiftype site search requires configuring swiftype_key in _config.yml, i.e., it depends on the external Swiftype search service and its key.
Using Mathjax mathematical formula rendering requires additionally installing the hexo-renderer-kramed plugin and removing hexo-renderer-marked, which is an extra dependency requirement.
Blocking WeChat built-in browsing requires setting wx_block: true in _config.yml; if you have a verified WeChat official account, this setting is not needed.
The article table of contents feature requires setting toc: true in the front-matter of the corresponding .md file to display, and heading numbers are not displayed by default.
The theme explicitly does not support browsing in WeChat built-in browser, and pages opened within WeChat display poorly.
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

You need to specify `swiftype_key` in `_config.yml` to enable it.
Original README

Requires the [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) plugin, and hexo-renderer-marked should be removed.
Original README

You can enable it using `wx_block: true` in your `_config.yml`, otherwise Weixin will render your article in a disgusting way! (Unless you have a public weixin account.)
Original README

Should config `toc: true` in .md files, serial numbers of titles is not displayed by default.
Original README

DO NOT support weixin's inside browsing
Original README

https://github.com/sun11/hexo-theme-paperbox/blob/master/LICENSE https://github.com/sun11/hexo-theme-paperbox/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-01. 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 · 72 / 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: 2018-09-02
Screenshot last checked: 2026-10-01

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: eab6a7237b1de9efc2d02f193f0dd75cfbd9d3bd91514cdcddfef48a6e729eab

2026-10-01T03:24:38.571Z

Source file / repository

# Paperbox

 [**Demo**](https://sun11.me)
 
 ![](https://www.sun11.me/images/hexo-theme-paperbox/responsive-design.png)

A theme modified based on [Landscape-plus](https://github.com/xiangming/landscape-plus) theme based on Landscape theme, with some papers and a paperbox. The motivation is for my personal use. Hexo version is 3.1.1, nodejs v4.2.6.

### Feature

* **Paper-like Appearance** - Make you focus on the contents.
* **Responsive Design** - min-width is 320px, ensure the normal display for iPhone 4-5s.
* **Bug fixs** - fixed many bugs, including paginator in archive, share button, mobile nav, etc.

### Modifications on Landscape-plus

* **Integrated Swiftype Search** - You need to specify `swiftype_key` in `_config.yml` to enable it.
* **Removed Bdshare** - There are conflicts between bdshare and swiftype search, for example, the `more` button in bdshare is invalid when swiftype is enabled.
* **Landscape share Enhancement** - Replaced Pinterest with Linkedin, added 4 Chinese SNS share buttons.
* **Support Mathjax** - Requires the [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) plugin, and hexo-renderer-marked should be removed. You need to enable it using `mathjax: true` in `_config.yml`.
* **Block Disgusting Browsing inside Weixin** - You can enable it using `wx_block: true` in your `_config.yml`, otherwise Weixin will render your article in a disgusting way! (Unless you have a public weixin account.)
* **Table of Contents (TOC)** - Should config `toc: true` in .md files, serial numbers of titles is not displayed by default.

### Browser Support

* **IE 9+ and the current versions of other browsers**
* **DO NOT support weixin's inside browsing**

### People Using Paperbox

see [Examples](https://github.com/sun11/hexo-theme-paperbox/wiki/Examples)

---
 
基于基于Landscape主题的Landscape-Plus主题由本人修改的主题，主要目的是自己使用，Hexo版本是3.1.1，nodejs 4.2.6

### 主题特性

* **纸张外观** - 使你专注于文章内容
* **响应式设计** - 最小宽度为320px，确保了在iPhone 4到5s的320x*分辨率的正常显示
* **诸多bug修复** - 修复了包括archive分页显示，原主题在分享按钮、mobile nav界面、分页条等的诸多细节bug

### 对Landscape-Plus的功能修改

* **增加Swiftype站内搜索** - 需在配置文件中设置`swiftype_key`
* **移除百度分享** - 因为不明原因（可能是全局变量？）与Swiftype冲突，先执行的js功能正常，后执行的js会出问题，如百度分享的`更多`按钮点击无效
* **Landscape原主题分享增强** - 将Pinterest更改为Linkedin，增加四个国内社交网站：微博，人人，QQ空间，微信
* **支持Mathjax** - 需安装[hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed)插件，并移除hexo-renderer-marked。在`_config.yml`配置`mathjax: true`以启用
* **屏蔽微信内置浏览** - 在`_config.yml`中设置`wx_block: true`即可屏蔽微信内置浏览, 否则你的文章会变成一团糊（除非你有认证的微信公众号）
* **增加文章目录（TOC）显示** - 需在文章中设置`toc: true`，默认不显示编号

### 浏览器支持

* **IE9+和目前版本的其它浏览器**
* **不支持微信内置浏览**

### Paperbox用户

见 [Examples](https://github.com/sun11/hexo-theme-paperbox/wiki/Examples)

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hexo-theme-matery

hexo-theme-matery is a Material Design, responsive Hexo blog theme with homepage carousel, waterfall post list, timeline archive, word cloud tags, radar chart categories, and an about page.

Hexo · Blog

hexo-theme-cactus

Cactus is a responsive Hexo theme for personal websites and blogs, maintained by probberechts. It offers four color schemes (dark, light, white, classic), configurable navigation, homepage post lists, project lists, social links, and copyright year ranges.

Hexo · Blog

hexo-theme-volantis

Volantis is a blog theme for Hexo, distributed as the npm package hexo-theme-volantis and enabled by setting theme to volantis in the Hexo site's _config.yml. It requires Hexo 7.3+, hexo-cli 4.3+, Node.js 22.x LTS+, and npm 10.x LTS+.

Hexo · Blog

hexo-theme-aurora

Hexo Theme Aurora is a futuristic Hexo blog theme built around aurora gradients and a magazine-style grid layout.

Hexo · Blog

hexo-theme-Claudia

Claudia is a Hexo blog theme focused on a clean look and easy configuration. It automatically follows the device's dark mode and claims a 90+ Lighthouse score.

Hexo · Blog

hexo-theme-A4

hexo-theme-A4 is a minimalist Hexo blog theme that mimics the texture of A4 paper, emphasizing simplicity, small size, and minimal configuration.

Hexo · Blog