https://github.com/renbaoshuo/hexo-theme-pure
🎨 A pure, modern and simple theme for Hexo.
https://github.com/renbaoshuo/hexo-theme-pure
blog blog-theme gridea gridea-theme gridea-theme-pure hexo hexo-theme hexo-theme-pure theme theme-pure themes
Last synced: about 1 year ago
JSON representation
🎨 A pure, modern and simple theme for Hexo.
- Host: GitHub
- URL: https://github.com/renbaoshuo/hexo-theme-pure
- Owner: renbaoshuo
- License: agpl-3.0
- Created: 2021-02-05T08:14:47.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-12T13:24:06.000Z (almost 3 years ago)
- Last Synced: 2025-05-05T01:46:20.616Z (about 1 year ago)
- Topics: blog, blog-theme, gridea, gridea-theme, gridea-theme-pure, hexo, hexo-theme, hexo-theme-pure, theme, theme-pure, themes
- Language: Less
- Homepage:
- Size: 1.67 MB
- Stars: 129
- Watchers: 2
- Forks: 13
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pure
> A modern and simple theme for Hexo.
[](https://baoshuo.ren)
[](https://github.com/renbaoshuo/hexo-theme-pure/releases)
[](https://hexo.io)
[](https://github.com/renbaoshuo/hexo-theme-pure)
English | [简体ä¸æ–‡](/README.zh_CN.md)
*This theme is transplanted from [imhanjie/gridea-theme-pure](https://github.com/imhanjie/gridea-theme-pure) and has been approved by the original author.*
## Demo
+ [Hexo Theme Unit Test of Theme Pure](https://renbaoshuo.github.io/hexo-theme-pure)
## Installation
### Install via GitHub
You need to switch to the directory where the site is located before performing the following operations.
```bash
npm install hexo-renderer-ejs hexo-renderer-less --save
git clone https://github.com/renbaoshuo/hexo-theme-pure.git themes/pure
```
### Install via NPM
```bash
npm install hexo-theme-pure --save
# or use yarn: yard add hexo-theme-pure
```
## Settings
+ `favicon`: Site logo displayed in browser tabs and bookmarks. (String, default: `/favicon.ico`)
+ `avatar`: Site logo displayed on the header. (String, default: `/favicon.png`)
+ `katex`: Whether to load [KaTeX](https://katex.org) CSS. (Boolean, default: `false`)
+ `force_https`: Mandatory HTTPS. (Boolean, default: `false`)
+ `check_update`: Check update before exit. (Boolean, default: `false`)
+ `menus` (Array)
- `name`: The name displayed on the navigation bar. (String)
- `link`: The link of the page to jump to. (String)
- `target`: The [target](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/a#attr-target) of the link. (String, `_self` or `_blank`, default: `_self`)
+ `post`: Post settings
- `feature`: display post image in post list (needs to set `feature` in post, Boolean, default: `true`)
+ `disqus`: DisqusJS Settings
- `enable`: Whether to enable DisqusJS. (Boolean, default: `false`)
- `shortname`: The shortname of the Disqus site.
- `api`: Your disqus api.
- `apikey`: Your disqus api key.
- `admin`: Your disqus username.
+ `gitalk`: [Gitalk](https://github.com/gitalk/gitalk) Settings
- `enable`: Whether to enable Gitalk. (Boolean, default: `false`)
- `clientId`: Your GitHub oauth app client id
- `clientSecret`: Your GitHub oauth app client secret
- `repository`: Your GitHub comment repository
- `owner`: Your GitHub username
+ `web_analytics`: Web Analytics Settings
- `enable`: Whether to enable Web Analytics. (Boolean, default: `false`)
- `google`: Google Analytics tracker id.
- `baidu`: Baidu Analytics id.
+ `footer`: The content displayed in the footer.
+ `friends`: Friends (Array)
- `name`: The name displayed on the friends list.
- `link`: The link of the page to jump to.
- `logo`: The logo displayed on the friends list.
## Attention
### Code highlight Settings
The theme has built-in highlight style of [`highlightjs`](https://highlightjs.org). Please do not enable `line_number` and `wrap` because this theme does not support them.
Here is a configuration example:
```yaml
highlight:
enable: true
auto_detect: true
line_number: false # This value must be `false`
wrap: false # This value must be `false`
tab_replace: ' ' # 4 spaces
hljs: true # This value must be `true`
prismjs:
enable: false
```
### KaTeX Settings
It is recommended to use `hexo-renderer-markdown-it` to render Markdown and install `@neilsustc/markdown-it-katex` to render mathematical formulas.
```bash
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-markdown-it @neilsustc/markdown-it-katex --save
```
Here is a configuration example:
```yaml
# Markdown-it config
## Docs: https://github.com/celsomiranda/hexo-renderer-markdown-it/wiki
markdown:
render:
html: true
xhtmlOut: false
breaks: true
linkify: true
typographer: true
plugins:
- '@neilsustc/markdown-it-katex'
anchors:
level: 2
collisionSuffix: 't'
permalink: false
permalinkClass: header-anchor
permalinkSymbol: ''
```
### DisqusJS Settings
You must [Register a Disqus Application](https://disqus.com/api/applications/) before using [DisqusJS](https://github.com/SukkaW/DisqusJS).
## Author
**hexo-theme-pure** © [Baoshuo](https://github.com/renbaoshuo), Released under the [GPL-3.0](./LICENSE) License.
Authored and maintained by Baoshuo with help from [contributors](https://github.com/renbaoshuo/hexo-theme-pure/contributors).
> [Personal Website](https://baoshuo.ren) · [Blog](https://blog.baoshuo.ren) · GitHub [@renbaoshuo](https://github.com/renbaoshuo) · Twitter [@renbaoshuo](https://twitter.com/renbaoshuo)