MiHo-Hexo主题安装和配置详情

miho

一. 主题简介

MiHo 是一款单栏响应式的Hexo主题；基于 Hexo 3.0+ 制作，兼容移动端浏览；主题的代码托管在GitHub上，
欢迎Star和Fork；如遇到问题或发表建议，可以提Issues，也可以在博客中留言给我，另外,喜欢的话不妨给个 Star。

二. 安装

2.1 安装主题

$ git clone https://github.com/WongMinHo/hexo-theme-miho.git themes/miho

MiHo 主题需要Hexo 3.0或以上版本，请先升级。

2.2 更新

cd themes/miho
git pull

2.3 依赖安装

如下依赖如果已经安装，请看配置介绍。

Json-content

生成站点文章静态数据，用于站内搜索。

npm install hexo-generator-json-content --save

三. 站点配置

站点配置文件_config.yml在hexo根目录下。

3.1 启用主题

`theme: miho`

3.2 网站基本配置

以下配置是站点的全局配置，更多配置，请查看

title: MinHow's Blog
subtitle: 网站副标题
description: 专注 WEB 开发的技术博客
author: MinHow
language: 网站使用的语言
timezone: 网站时区

3.3 jsonContent配置

详细的配置请查看hexo-generator-json-content

jsonContent:
  meta: false
  pages: false
  posts:
    title: true
    date: true
    path: true
    text: false
    raw: false
    content: false
    slug: false
    updated: false
    comments: false
    link: false
    permalink: false
    excerpt: false
    categories: false
    tags: false

四. 主题配置

编辑主题配置文件，themes/miho/_config.yml。

4.1 属性

下面将介绍几个比较重要的配置。

# 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: /
    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:
  #mail:
  #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

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

# Comments | 评论

# 畅言，输入appid和appkey
changyan_appid: false
changyan_appkey: false
# disqus
disqus: false

# 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

4.2 文章封面图

文章默认封面图，尺寸：350*150，当文章基本配置没有cover_picture时才显示。

cover_picture: images/banner.jpg

4.3 开启背景粒子

是否开启背景粒子。

open_bg_particle: true

4.4 开启主页及头部动画

是否开启主页及头部动画。

open_animation: true

4.5 评论

支持畅言、disqus。

# 畅言
changyan_appid: false
changyan_appkey: false
# disqus
disqus: false

4.6 数据统计

支持站长、百度、google三种数据统计，正确填写配置信息即可。

# 站长分析，输入站点id
cnzz_analytics: false
# 百度分析，输入key值
baidu_analytics: false
# google分析
google_analytics: false

4.7 文章基本配置

---
title: Hello World
date: 2017-06-18
categories: First
author: MinHow
tags:
    - First
    - Second
cover_picture: /images/banner.jpg
---
 MinHow-This is a summary

说明：

• 需要注意tags和摘要的写法，不然首页不能正确显示标签和摘要；
• cover_picture文章封面图，不填默认显示_config.yml配置的图片。