Hexo博客

hexo-theme-paperbox — Hexo 博客模板

作者 sun11

hexo-theme-paperbox 是一款基于 Landscape-plus 修改的 Hexo 博客主题,采用纸张风格外观与响应式布局,并加入 Swiftype 搜索、Mathjax 支持、文章目录和微信内置浏览屏蔽等改动。

看看你的网站会是什么样

浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。

2 个预览视图
桌面端首页1 / 2
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局,交互效果请以实际项目为准。

采集于 2026-10-01查看来源

值得关注的模板亮点

从已有项目资料中,快速了解它的特点。

01

纸张风格外观,视觉上引导读者聚焦文章内容

02

响应式设计,最小宽度 320px,适配小屏手机

03

集成 Swiftype 站内搜索,需配置 swiftype_key 启用

04

支持 Mathjax,需配合 hexo-renderer-kramed 插件使用

05

可在文章中通过 toc: true 显示文章目录

06

可配置 wx_block: true 屏蔽微信内置浏览

模板详细介绍

Paperbox 是作者在 Landscape-plus(基于 Landscape)基础上修改而来的 Hexo 博客主题,主要供个人使用。主题以纸张外观为视觉方向,强调让读者专注于文章内容,并采用响应式设计,最小宽度为 320px,可适配 iPhone 4 到 5s 等小屏设备。

在功能上,主题相对 Landscape-plus 做了若干调整:集成 Swiftype 站内搜索,需要在 _config.yml 中设置 swiftype_key 才能启用;移除了百度分享,原因是其与 Swiftype 存在冲突;将分享按钮中的 Pinterest 替换为 Linkedin,并增加微博、人人、QQ 空间、微信四个国内社交平台分享。主题还支持 Mathjax,但需要安装 hexo-renderer-kramed 插件并移除 hexo-renderer-marked,同时在 _config.yml 中设置 mathjax: true。文章目录需在文章 front-matter 中设置 toc: true,默认不显示标题编号。此外,可通过 wx_block: true 屏蔽微信内置浏览。

浏览器支持方面,主题面向 IE9+ 及当时主流浏览器的当前版本,并明确不支持微信内置浏览。README 中记录的 Hexo 版本为 3.1.1、Node.js 版本为 v4.2.6,属于较早的开发环境,使用时需注意与当前 Hexo 及 Node.js 版本的兼容性。主题采用 MIT 许可,允许免费使用、修改、商用和分发,但演示图片、字体、图标等第三方素材需单独核对许可。

Hexo博客

适合你的项目吗?

适用场景

  • 使用 Hexo 搭建个人博客并希望采用纸张风格主题
  • 需要在博客中启用 Swiftype 站内搜索的站点
  • 撰写含数学公式的文章并希望使用 Mathjax 渲染
  • 希望为文章提供目录导航的博客作者
  • 需要屏蔽微信内置浏览器访问的博客

适合人群

  • 使用 Hexo 构建静态博客的个人用户
  • 偏好纸张风格、内容优先阅读体验的站点
  • 需要站内搜索、数学公式或文章目录功能的博客
  • 能够自行处理旧版本主题兼容问题的开发者

上手与定制指南

结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。

  1. 1

    启用 Swiftype 搜索需在 _config.yml 中设置 swiftype_key

  2. 2

    启用 Mathjax 需安装 hexo-renderer-kramed 并移除 hexo-renderer-marked,同时设置 mathjax: true

  3. 3

    文章目录需在对应 .md 文件的 front-matter 中设置 toc: true

  4. 4

    屏蔽微信内置浏览需在 _config.yml 中设置 wx_block: true

  5. 5

    README 记录的 Hexo 版本为 3.1.1、Node.js 版本为 v4.2.6,使用前请确认与当前环境的兼容性

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供;担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 启用 Swiftype 站内搜索需在 _config.yml 中配置 swiftype_key,即依赖 Swiftype 这一外部搜索服务及其密钥。
  • 使用 Mathjax 数学公式渲染需额外安装 hexo-renderer-kramed 插件,并移除 hexo-renderer-marked,属于额外依赖要求。
  • 屏蔽微信内置浏览需在 _config.yml 中设置 wx_block: true;若拥有认证微信公众号则无需此设置。
  • 文章目录功能需在对应 .md 文件的 front-matter 中设置 toc: true 才会显示,默认不显示标题编号。
  • 主题明确不支持微信内置浏览器浏览,微信内打开页面显示效果不佳。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

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

README 原文

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

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.)

README 原文

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

README 原文

DO NOT support weixin's inside browsing

README 原文
https://github.com/sun11/hexo-theme-paperbox/blob/master/LICENSEhttps://github.com/sun11/hexo-theme-paperbox/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料一般 · 72 / 100
技术栈
Hexo
网站类型
博客
这个分数如何计算

本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2018-09-02
截图检查日期
2026-10-01

已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Hexo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: eab6a7237b1de9efc2d02f193f0dd75cfbd9d3bd91514cdcddfef48a6e729eab

2026-10-01T03:24:38.571Z

来源文件 / 仓库
# 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)
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。