hexo-theme-pure

A modern and simple theme for Hexo.

Usage no npm install needed!

<script type="module">
  import hexoThemePure from 'https://cdn.skypack.dev/hexo-theme-pure';
</script>

README

Pure

A modern and simple theme for Hexo.

Author Version Hexo Repo Size

This theme is transplanted from imhanjie/gridea-theme-pure and has been approved by the original author.

Demo

Installation

You need to switch to the directory where the site is located before performing the following operations.

npm install hexo-renderer-ejs hexo-renderer-less --save
git clone https://github.com/renbaoshuo/hexo-theme-pure.git themes/pure
cd themes/pure
npm install
cd ../..

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 CSS. (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 of the link. (String, _self or _blank, default: _self)
  • 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.
  • google_analytics: Google Analytics Settings
    • enable: Whether to enable Google Analytics. (Boolean, default: false)
    • id: Google Analytics tracker 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. Please do not enable line_number and wrap because this theme does not support them.

Here is a configuration example:

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.

npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-markdown-it @neilsustc/markdown-it-katex --save

Here is a configuration example:

# 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 before using DisqusJS.

Author

hexo-theme-pure © Baoshuo, Released under the GPL-3.0 License.
Authored and maintained by Baoshuo with help from contributors.

Personal Website · Blog · GitHub @renbaoshuo · Twitter @renbaoshuo