开始之前

BlueLake主题写了有一段时间了，经常会有朋友发消息给我问一些配置的问题，这篇博文主要也是为了解决这些问题。主题以简洁轻量自居(实则简陋)，去掉了Jquery和Fancybox,用原生JS实现站内搜索功能。这个主题只是一个小小的雏形，期待您来帮助它成长。

在阅读本文之前，假定您已经成功安装了Hexo，并使用 Hexo 提供的命令创建了一个静态博客。Hexo是一个快速、简洁且高效的博客框架。Hexo基于Node.js ，使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

需要特别注意的是Hexo有两个_config.yml配置文件，一份位于站点根目录下，主要包含 Hexo 站点本身的配置，下文中会称为根_config.yml；另一份位于主题目录下（themes/主题名/_config.yml），这份配置由主题作者提供，主要用于配置主题相关的选项,下文中会称为主题_config.yml。

1. 安装

您可以直接到BlueLake发布页下载，然后解压拷贝到themes目录下，修改配置即可。
不过我还是推荐使用GIT来checkout代码，之后也可以通过git pull来快速更新。

1.1 安装主题

在根目录下打开终端窗口：

git bash
1
$ git clone https://github.com/chaooo/hexo-theme-BlueLake.git themes/BlueLake

1.2 安装主题渲染器

BlueLake是基于jade和stylus写的，所以需要安装hexo-renderer-jade和hexo-renderer-stylus来渲染。

git bash
1
2
$ npm install hexo-renderer-jade@0.3.0 --save
$ npm install hexo-renderer-stylus --save

1.3 启用主题

打开根_config.yml配置文件，找到theme字段，将其值改为BlueLake(先确认主题文件夹名称是否为BlueLake)。

根_config.yml_config.yml
1
theme: BlueLake

1.4 验证

首先启动 Hexo 本地站点，并开启调试模式：

git bash
1
$ hexo s --debug

在服务启动的过程，注意观察命令行输出是否有任何异常信息，如果你碰到问题，这些信息将帮助他人更好的定位错误。 当命令行输出中提示出：INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.
此时即可使用浏览器访问 http://localhost:4000，检查站点是否正确运行。

1.5 更新主题

今后若主题添加了新功能正是您需要的，您可以直接git pull来更新主题。

git bash
1
2
cd themes/BlueLake
git pull

2. 配置

2.1 配置网站头部显示文字

打开根_config.yml，找到：

根_config.yml_config.yml
1
2
3
4
title: 
subtitle: 
description: 
author:

title和subtitle分别是网站主标题和副标题，会显示在网站头部；description在网站界面不会显示，内容会加入网站源码的meta标签中，主要用于SEO；author就填写网站所有者的名字，会在网站底部的Copyright处有所显示。

2.2 设置语言

该主题目前有七种语言：简体中文（zh-CN），繁体中文（zh-TW），英语（en），法语（fr-FR），德语（de-DE），韩语 （ko）,西班牙语（es-ES）；例如选用简体中文，在根_config.yml配置如下：

根_config.yml_config.yml
1
language: zh-CN

2.3 设置菜单

打开主题_config.yml，找到：

主题_config.ymlthemes/BlueLake/_config.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
menu:
  - page: home
    directory: .
    icon: fa-home
  - page: archive
    directory: archives/
    icon: fa-archive
  # - page: about
  #   directory: about/
  #   icon: fa-user
  - page: rss
    directory: atom.xml
    icon: fa-rss

主题默认是展示四个菜单，即主页home，归档archive，关于about，订阅RSS；about需要手动添加，RSS需要安装插件，若您并不需要，可以直接注释掉。
每个页面底部的footer中联系博主的三个图标分别是邮箱，微博主页链接地址，GitHUb个人页链接地址，直接使用主题_config.yml中about页面的配置，若不需要about页面，只需要如下配置就好：

主题_config.ymlthemes/BlueLake/_config.yml
1
2
3
4
5
# About page 
about:
  email: ## 个人邮箱 
  weibo_url: ## 微博主页链接地址
  github_url: ## github主页链接地址
2.3.1 添加about页

此主题默认page页面是关于我页面的布局，在根目录下打开命令行窗口，生成一个关于我页面：

git bash
1
$ hexo new page 'about'

打开主题_config.yml，补全关于我页面的详细信息：

主题_config.ymlthemes/BlueLake/_config.yml
1
2
3
4
5
6
7
8
# About page 
about:
  photo_url: ## 头像的链接地址
  email: ## 个人邮箱 
  weibo_url: ## 微博主页链接地址
  weibo_name: ## 微博用户名 
  github_url: ## github主页链接地址
  github_name: ## github用户名

当然您也可以自定义重新布局about页面，只需要修改layout/page.jade模板就好。

2.3.2 安装 RSS(订阅) 和 sitemap(网站地图) 插件

在根目录下打开命令行窗口：

git bash
1
2
3
$ npm install hexo-generator-feed --save
$ npm install hexo-generator-sitemap --save
$ npm install hexo-generator-baidu-sitemap --save

添加主题_config.yml配置：

主题_config.ymlthemes/BlueLake/_config.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Plugins:
  hexo-generator-feed
  hexo-generator-sitemap
  hexo-generator-baidu-sitemap

feed:
  type: atom
  path: atom.xml
  limit: 20

sitemap:
  path: sitemap.xml
baidusitemap:
  path: baidusitemap.xml

2.4 添加本地搜索

默认本地搜索是用原生JS写的，但还需要HEXO插件创建的JSON数据文件配合。安装插件hexo-generator-json-content来创建JSON数据文件：

git bash
1
$ npm install hexo-generator-json-content@2.2.0 --save

然后在根_config.yml添加配置：

根_config.yml_config.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
jsonContent:
  meta: false
  pages: false
  posts:
    title: true
    date: true
    path: true
    text: true
    raw: false
    content: false
    slug: false
    updated: false
    comments: false
    link: false
    permalink: false
    excerpt: false
    categories: false
    tags: true

最后在主题_config.yml添加配置：

主题_config.ymlthemes/BlueLake/_config.yml
1
local_search: true

2.5 修改站点图标

站点图标存放在主题的Source目录下，已经默认为您准备了两张图片。您也可以自己设计站点LOGO。
您需要准备一张ico格式并命名为** favicon.ico ，请将其放入hexo目录的source文件夹，建议大小：32px X 32px。
您需要为苹果设备添加网站徽标，请命名为 apple-touch-icon.png **的图像放入hexo目录的“source”文件夹中，建议大小为：114px X 114px。
(有很多网站都可以在线生成ico格式的图片。)

2.6 添加站点关键字

请在hexo目录的根_config.yml中添加keywords字段，如：

根_config.yml_config.yml
1
2
3
4
5
6
7
# Site
title: Hexo
subtitle: 副标题
description: 网站简要描述,如：Charles·Zheng's blog.
keywords: 网站关键字, key, key1, key2, key3
author: Charles
language: zh-CN

2.7 首页添加文章置顶

在根目录下打开命令行窗口安装：

git bash
1
2
$ npm uninstall hexo-generator-index --save
$ npm install hexo-generator-index-pin-top --save

然后在需要置顶的文章的Front-matter中加上top: true即可。

1
2
3
4
5
6
---
title: BlueLake博客主题的详细配置
tags: [hexo,BlueLake]
categories: Hexo博客折腾
top: true
---

2.8 更换主题背景和添加文章版权信息

更换主题背景为深色

主题_config.ymlthemes/BlueLake/_config.yml 
1
2
# Theme tone
dark: true #true/false

添加文章版权信息

主题_config.ymlthemes/BlueLake/_config.yml 
1
2
3
4
5
# Theme tone
#Copyright
copyright: 
  enable: true #true/false  
  describe: 转载请注明出处(必须保留原文作者署名原文链接) #自定义描述替换默认描述

2.9 其他配置

主题_config.yml的其他配置

  1. show_category_count——是否显示分类下的文章数。
  2. widgets_on_small_screens——是否在小屏显示侧边栏，若true,则侧边栏挂件将显示在底部。
    主题_config.ymlthemes/BlueLake/_config.yml 
    1
    2
    show_category_count: true 
    widgets_on_small_screens: true

3.集成第三方服务

3.1 添加评论

目前主题集成六种第三方评论，分别是多说评论、Disqus评论、来必力评论、友言评论、网易云跟帖评论、畅言评论、基于Github Issue的GITALK，推荐gitalk。

  1. 需要 GitHub Application，如果没有点击这里申请。

    • Application name： 应用名称，随意
    • Homepage URL： 网站URL，对应自己博客地址
    • Application description ：描述，随意
    • Authorization callback URL：# 网站URL，博客地址就好
    • 点击注册，页面会出现其中Client ID和Client Secret在后面的配置中需要用到

  2. 配置主题_config.yml：

    主题_config.ymlthemes/BlueLake/_config.yml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    #Cmments
    comment:
      gitalk:
        enable: true ## 开启gitalk
        owner: ## GitHub的用户名
        repo: ## 此评论存放的GitHub仓库
        client_id: ## 复制刚才生成的clientID，例如. 75752dafe7907a897619
        client_secret: ## 复制刚才生成的clientSecret，例如. ec2fb9054972c891289640354993b662f4cccc50
        admin: ## Github的用户名
        language: zh-CN ## Language
        pagerDirection: last # Comment sorting direction, available values are last and first.

3.2 百度统计

  1. 登录百度统计，定位到站点的代码获取页面。
  2. 复制//hm.baidu.com/hm.js?后面那串统计脚本id(假设为：8006843039519956000)
  3. 配置主题_config.yml:
    主题_config.ymlthemes/BlueLake/_config.yml 
    1
    baidu_analytics: 8006843039519956000

注意： baidu_analytics不是你的百度id或者百度统计id
如若使用谷歌统计，配置方法与百度统计类似。

3.3 卜算子阅读次数统计

主题_config.ymlthemes/BlueLake/_config.yml
1
busuanzi: true

若设置为true将计算文章的阅读量(Hits)，并显示在文章标题下的小手图标旁。

3.4 微博秀

微博秀挂件的代码放在layout/_widget/weibo.jade下，需要您去微博开放平台获取您自己的微博秀代码来替换。

  1. 登录微博开放平台，选择微博秀。
  2. 为了与主题风格统一，作如下配置
    • 基础设置：高400px；勾选宽度自适应；颜色选择白色；
    • 样式设置：主字色#333；链接色#40759b；鼠标悬停色#f7f8f8；
    • 模块设置：去掉标题、边框、粉丝的勾选框，只留微博。
  3. 复制代码里src=""里引号包裹的内容，替换到layout/_widget/weibo.jade
    weibo.jadelayout/_widget/weibo.jade
    1
    2
    3
    4
    .widget
      .widget-title
        i(class='fa fa-weibo')= ' ' + __('新浪微博')
      iframe(width="100%",height="400",class="share_self",frameborder="0",scrolling="no",src="http://widget.weibo.com/weiboshow/index.php?language=&width=0&height=400&fansRow=2&ptype=1&speed=0&skin=5&isTitle=0&noborder=0&isWeibo=1&isFans=0&uid=1700139362&verifier=85be6061&colors=d6f3f7,ffffff,333,40759b,f7f8f8&dpc=1")
    这只是为了和主题的风格统一，当然您也可以自由随意发挥。

    注意：最主要是是要把src里uid=和verifier=后面的字段替换为您自己代码里的就好。