Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wongminho/hexo-theme-miho

🍺一款单栏响应式的hexo主题, A single column response for hexo . https://blog.minhow.com
https://github.com/wongminho/hexo-theme-miho

css ejs hexo responsive theme

Last synced: about 1 month ago
JSON representation

🍺一款单栏响应式的hexo主题, A single column response for hexo . https://blog.minhow.com

Awesome Lists containing this project

README

        

![MiHo](http://cloud.minhow.com/images/miho/theme/github.jpg)
hexo-theme-miho
================

MiHo is a single and responsive design theme for [Hexo](//hexo.io).
MiHo requires Hexo 3.0 and above, Compatible with mobile browsing; Theme DEMO:[MinHow's Blog](https://blog.minhow.com/).
中文文档请[查看](https://blog.minhow.com/articles/blog/installation-configuration/).

## Summary
* [General](#general)
* [Features](#features)
* [Installation](#installation)
* [Configuration](#configuration)
* [Contributing](#contributing)
* [License](#license)

## General
[![Version](https://img.shields.io/badge/version-1.0.0-green.svg?style=flat-square)](#)
[![Author](https://img.shields.io/badge/author-MinHow-blue.svg?style=flat-square)](https://minhow.com)

[![Hexo](https://img.shields.io/badge/hexo-3.0+-green.svg?style=flat-square)](https://hexo.io)
[![node.js](https://img.shields.io/badge/node.js-6.0+-green.svg?style=flat-square)](https://nodejs.org/)

## Features
* Responsive
* Concise
* Tags Support & Categories Support
* Googe analytics & Baidu analytics & Cnzz analytics
* Disqus comments & Changyan comments
* Stylus CSS preprocessor
* Local Site Search
* Pagination
* ejs HTML templates

## Installation

### Installation Theme
``` bash
$ git clone https://github.com/WongMinHo/hexo-theme-miho.git themes/miho
```

### Update
``` bash
cd themes/miho
git pull
```

### Dependency installation
#### Json-content
Generate site articles static data for in-site search; detailed configuration please check [hexo-generator-json-content](https://github.com/alexbruno/hexo-generator-json-content).
``` bash
npm install hexo-generator-json-content --save
```

### Theme Config
Change theme field in Hexo root's `_config.yml` file.
``` bash
theme: miho
```

## Configuration
Modify settings in `themes/miho/_config.yml`,Please use it as needed.

```
# hexo-theme-miho
# https://github.com/wongminho/hexo-theme-miho

# Favicon of your site | 网站icon
favicon: /favicon.ico

# Header

# Keywords of your site | 网站关键字
keywords: MinHow,MinHow's Blog
# Head headline | 头部标题
header_title: MinHow's Blog
# Head description | 头部描述
header_description: 一个专注 WEB 开发的技术博客
# Link to your logo | logo地址
logo: images/logo.png
# Link to your banner_img | 首页banner图地址
banner_img: images/banner.jpg
# Menu setting | 菜单设置
# name: Font Awesome icon | Font Awesome 图标
# title: Home Title | 标题
# url: //minhow.com Url, absolute or relative path | 链接,绝对或相对路径
# target: true Whether to jump out | 是否跳出
menu:
home:
title: Home
url: /
target: false
archive:
title: Archives
url: /archives
target: false
user:
title: About
url: /about
target: false
# Social setting, use to display social information | 社交设置,用来展示社交信息
# name: Font Awesome icon | Font Awesome 图标
# title: Home Icon title | 图标标题
# url: //minhow.com Url, absolute or relative path | 链接,绝对或相对路径
# target: true Whether to jump out | 是否跳出
social:
home:
title: MinHow
url: //minhow.com
target: true
github:
title: Github
url: //github.com/wongminho
target: true
weibo:
title: Weibo
url: //weibo.com/WongMinHo
target: true
twitter:
title: Twitter
url: //twitter.com/huangminhow
target: true
#qq:
#weixin:
#snapchat:
#telegram:
#envelope-o:
#facebook:
#google:
#linkedin:

# Content

# Excerpt length | 摘录长度
excerpt_length: 190
# Excerpt link | 摘录链接
excerpt_link: more>>
# New window open link | 新窗口打开文章
open_new_link: false
# Article default cover picture,size:350*150 | 文章默认封面图,尺寸:350*150
cover_picture: images/banner.jpg
# Open background particles | 开启背景粒子
open_bg_particle: true
# Open animation in homepage and head | 开启主页及头部动画
open_animation: true

# Article

# Open toc | 是否开启toc
toc: true
# Open share | 是否开启分享
share: true

# Style customization | 样式定制
style:
# Main color tone | 主色调
main_color: '#0cc'

# Reward | 打赏

reward:
# 0-close, 1-All articles are rewarding, 2-Article's md file has reward:true attribute, only reward
# 0-关闭, 1-所有文章均有打赏, 2-文章的md文件里有reward:true属性,才有打赏
status: 1
# 标题
title: 请我吃糖~
# 微信,关闭设为 false
wechat: images/wechat_code.jpg
# 支付宝,关闭设为 false
alipay: images/alipay_code.jpg

# Comments | 评论

# 畅言,输入appid和appkey
changyan_appid: false
changyan_appkey: false
# 友言,输入id
youyan_id: false
# disqus
disqus: false
# gitment https://github.com/imsun/gitment
gitment:
owner: false #你的 GitHub ID
repo: '' #存储评论的 repo
client_id: '' #client ID
client_secret: '' #client secret

# Analytics | 分析
# 站长分析,输入站点id
cnzz_analytics: false
# 百度分析,输入key值
baidu_analytics: false
# google analytics | google分析
google_analytics: false

# Footer

# Access statistics | “不蒜子”访问量统计
access_counter:
on: true
site_uv: 总访客数:
site_pv: 总访问量:

# Copyright Information | 版权信息
copyright: 2017 MinHow
```

#### Article cover picture
Article default cover picture,size:350*150, When the article configuration does not have cover_picture display.
``` bash
cover_picture: images/banner.jpg
```

#### Background particles
Whether to open background particles.
``` bash
open_bg_particle: true
```

#### Homepage and head animation
Whether to open homepage and head animation.
``` bash
open_animation: true
```

#### Analytics
Google analytics, Baidu analytics and cnzz analytics are supported.
``` bash
# 站长分析,输入站点id
cnzz_analytics: false
# 百度分析,输入key值
baidu_analytics: false
# google analytics | google分析
google_analytics: false
```

#### Comments
This theme support both Disqus and Changyan as the third party discussion system.
``` bash
# 畅言,输入appid和appkey
changyan_appid: false
changyan_appkey: false
# 友言,输入id
youyan_id: false
# disqus
disqus: false
```

### Article configuration example
``` bash
---
title: Hello World
date: 2017-06-18
categories: First
tags:
- First
- Second
cover_picture: /images/banner.jpg
---
MinHow-This is a summary

```

## Contributing
All kinds of contributions (enhancements, new features, documentation & code improvements, issues & bugs reporting) are welcome.

## License
Open sourced under the GPL v3.0 license.