Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cofess/hexo-theme-pure
Hexo theme pure. It's a pure theme for Hexo.
https://github.com/cofess/hexo-theme-pure
blog-theme hexo hexo-awesome-theme hexo-blog hexo-blog-theme hexo-bootstrap-theme hexo-nice-theme hexo-template hexo-theme theme
Last synced: 1 day ago
JSON representation
Hexo theme pure. It's a pure theme for Hexo.
- Host: GitHub
- URL: https://github.com/cofess/hexo-theme-pure
- Owner: cofess
- License: mit
- Created: 2017-06-10T05:06:19.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-09-25T14:50:53.000Z (over 1 year ago)
- Last Synced: 2024-10-29T19:59:42.822Z (2 months ago)
- Topics: blog-theme, hexo, hexo-awesome-theme, hexo-blog, hexo-blog-theme, hexo-bootstrap-theme, hexo-nice-theme, hexo-template, hexo-theme, theme
- Language: CSS
- Homepage: http://blog.cofess.com
- Size: 4.55 MB
- Stars: 1,099
- Watchers: 18
- Forks: 292
- Open Issues: 100
-
Metadata Files:
- Readme: README.cn.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hexo-themes - cofess/hexo-theme-pure
README
# pure
A brand new default theme for [[Hexo](https://hexo.io)]. [Preview](http://cofess.github.io/) | [English documentation](README.md) | [iconfont](http://blog.cofess.com/hexo-theme-pure/iconfont/demo_fontclass.html)
## 特色
- 多语言
- 第三方评论框（友言、来必力、gitment、gitalk）
- 可展示个人豆瓣书单
- 可展示个人github托管项目
- 可设置支付宝、微信打赏
## 主题颜色
## 页面展示
[首页](http://cofess.github.io/) | [归档](http://cofess.github.io/archives/) | [分类](http://cofess.github.io/categories/) | [标签](http://cofess.github.io/tags/) | [项目](http://cofess.github.io/repository/) | [书单](http://cofess.github.io/books/) | [友链](http://cofess.github.io/links/) | [关于](http://cofess.github.io/about/)
## 配置说明
在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。为了描述方便，在以下说明中，将前者称为站点配置文件， 后者称为主题配置文件
## 安装主题
```
git clone https://github.com/cofess/hexo-theme-pure.git themes/pure
```
## 更新主题
```
cd themes/pure
git pull
```
## 启用pure主题
打开站点配置文件，找到theme字段，将其值更改为 pure
```
theme: pure
```
到此，主题安装完成。然后启动Hexo服务验证主题是否正确启用。
```
hexo s
```
## 安装插件
### [hexo-wordcount](https://github.com/willin/hexo-wordcount)
```
npm install hexo-wordcount --save
```
### [hexo-generator-json-content](https://github.com/alexbruno/hexo-generator-json-content)
```
npm install hexo-generator-json-content --save
```
### [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed)
```
npm install hexo-generator-feed --save
```
### [hexo-generator-sitemap](https://github.com/hexojs/hexo-generator-sitemap)
```
npm install hexo-generator-sitemap --save
```
### [hexo-generator-baidu-sitemap](https://github.com/coneycode/hexo-generator-baidu-sitemap)
```
npm install hexo-generator-baidu-sitemap --save
```
## 主题配置
### 设置语言
打开站点配置文件, 将 language 设置成你所需要的语言。建议明确设置你所需要的语言,可选值对应themes\pure\languages目录下语言文件，简体中文配置如下：
```
language: zh-CN
```
### 主题颜色
定制了五套颜色，默认白，黑:theme-black，蓝:theme-blue，绿:theme-green，紫:theme-purple
```
# config
config:
skin: # 主题颜色 theme-black theme-blue theme-green theme-purple
```
### 导航菜单
```
# 导航菜单
menu:
Home: .
Archives: archives # 归档
Categories: categories # 分类
Tags: tags # 标签
Repository: repository # github repositories
Books: books # 书单
Links: links # 友链
About: about # 关于
# 导航菜单图标（font awesome）
menu_icons:
enable: true # 是否启用菜单图标
home: icon-home-fill
archives: icon-archives-fill
categories: icon-folder
tags: icon-tags
repository: icon-project
books: icon-book-fill
links: icon-friendship
about: icon-cup-fill
```
### 设置个人信息
```
头像在themes\pure\source\images 目录下替换图片即可，捐献的二维码同理。
个人信息大部分都在 主题配置文件 中设置
```
### 搜索
主题内置三种站内搜索方式：insight、swiftype、baidu
```
# Search
search:
insight: true # you need to install `hexo-generator-json-content` before using Insight Search
swiftype: # enter swiftype install key here
baidu: false # you need to disable other search engines to use Baidu search
```
### 分享
支持`weibo,qq,qzone,wechat,tencent,douban,diandian,facebook,twitter,google,linkedin`
```
# Share
# weibo,qq,qzone,wechat,tencent,douban,diandian,facebook,twitter,google,linkedin
share:
enable: true # 是否启用分享
sites: weibo,qq,wechat,facebook,twitter # PC端显示的分享图标
mobile_sites: weibo,qq,qzone # 移动端显示的分享图标
```
### 评论
主题集成了[disqus](https://disqus.com/)、[友言](http://www.uyan.cc/)、[来必力](https://livere.com/)、[gitment](https://github.com/imsun/gitment)、[gitalk](https://github.com/gitalk/gitalk)评论系统，选择其中一种即可
```
# Comment
# Gitment
# Introduction: https://imsun.net/posts/gitment-introduction/
comment:
type: livere # 启用哪种评论系统
disqus: # enter disqus shortname here
youyan:
uid: *** # enter youyan uid
livere:
uid: *** # enter livere uid
gitment:
githubID: username
repo: username.github.io
ClientID: ***
ClientSecret: ***
lazy: false
```
### 文章浏览量统计
主题内置了不蒜子和leancloud来统计文章浏览量，启用其中之一即可，注意leancloud需要到其官网申请APP ID 和APP Key。
比如，启用不蒜子来统计文章浏览量，在主题配置文件中把busuanzi设置为true即可：
```
pv:
busuanzi:
enable: true # 不蒜子统计
```
如果不需要第三方来统计浏览量，只需将相应设置改为false即可（设置为false后不会加载第三方JS脚本）
### 项目
复制`theme/pure/_source/` 目录下`repository`文件夹到`blog path/source/` 目录下
新版配置（支持 Github 和 Gitee）：
*新版配置将会覆盖旧版的 github 配置！*
```
# Repository Info (This will override 'github' option)
# 项目仓库展示信息（将会覆盖 github 项）
repository:
platform: github # 托管平台（github | gitee）
username: *** # 用户名
```
旧版配置（仅支持 Github）：
```
# Github
github:
username: *** # github username
```
### 豆瓣书单
复制`theme/pure/_source/` 目录下`books`文件夹到`blog path/source/` 目录下
```
# douban 豆瓣书单
douban:
user: *** # 豆瓣用户名
start: 0 # 从哪一条记录开始
count: 100 # 获取豆瓣书单数据条数
```
### 友情链接
复制`theme/pure/_source/` 目录下`links`文件夹到`blog path/source/` 目录下
在 hexo 目录下的 source 文件夹内创建一个名为 _data（禁止改名）的文件夹。
然后在文件内创建一个名为 links.yml 的文件,在其中添加相关数据即可。
单个友情链接的格式为：
```
Name:
link: http://example.com
avatar: http://example.com/avatar.png
desc: "这是一个描述"
```
添加多个友情链接，我们只需要根据上面的格式重复填写即可。
. 将 Name 改为友情链接的名字，例如 Cofess。
. http://example.com 为友情链接的地址。
. http://example.com/avatar.png 为友情链接的头像。
. 这是一个描述 为友情链接描述。
### 文章索引目录
```
title: 文章标题
categories:
- 文章分类
tags:
- 文章标签
toc: true # 是否启用内容索引
```
### sidebar侧边栏
文章侧边栏默认为开启状态，如果某篇文章不想开启侧边栏，在文章开头配置加入“sidebar: none”即可：
```
title: 文章标题
categories:
- 文章分类
tags:
- 文章标签
sidebar: none # 是否启用sidebar侧边栏，none：不启用
```
## 博客优化
### [hexo-neat](https://github.com/rozbo/hexo-neat)
> auto Minify html、js、css and make it neat
```
npm install hexo-neat --save
```
在博客配置文件`_config.yml`中添加
```
# hexo-neat
neat_enable: true
neat_html:
enable: true
exclude:
neat_css:
enable: true
exclude:
- '*.min.css'
neat_js:
enable: true
mangle: true
output:
compress:
exclude:
- '*.min.js'
```
### [hexo-baidu-url-submit](https://github.com/huiwang/hexo-baidu-url-submit)
```
npm install hexo-baidu-url-submit --save
```
### [hexo-translate-title](https://github.com/cometlj/hexo-translate-title)
> 使用Google翻译，百度翻译和有道翻译将Hexo中的汉字标题转成英文标题
安装
```
npm install hexo-translate-title --save
```
在博客配置文件`_config.yml`中添加
```yml
translate_title:
translate_way: google #google | baidu | youdao
youdao_api_key: XXX
youdao_keyfrom: XXX
is_need_proxy: true #true | false
proxy_url: http://localhost:8123
```
**注意**：判断是否需要配置google本地代理，因为我在本地是开启时才能访问google翻译的，如果没有被墙，请将`_config.yml` 下的`is_need_proxy: true`改为false。如果设置为true,请设置本地代理地址
## 数学公式
> Hexo默认使用"hexo-renderer-marked"引擎渲染网页，该引擎会把一些特殊的markdown符号转换为相应的html标签
### 解决方案
解决方案有很多，可以网上搜下，为了节省大家的时间，这里只提供亲身测试过的方法。
更换Hexo的markdown渲染引擎，[hexo-renderer-markdown-it-plus](https://github.com/CHENXCHEN/hexo-renderer-markdown-it-plus)引擎替换默认的渲染引擎[hexo-renderer-marked](https://github.com/hexojs/hexo-renderer-marked)即可。
### 安装hexo-renderer-markdown-it-plus插件
```
npm un hexo-renderer-marked --save
npm i hexo-renderer-markdown-it-plus --save
```
### 配置
安装插件后，如果未正常渲染LaTeX数学公式，在博客配置文件`_config.yml`中添加
```
markdown_it_plus:
highlight: true
html: true
xhtmlOut: true
breaks: true
langPrefix:
linkify: true
typographer:
quotes: “”‘’
plugins:
- plugin:
name: markdown-it-katex
enable: true
- plugin:
name: markdown-it-mark
enable: false
```
### 文章启用mathjax
```
title: Hello World
mathjax: true
```