搭建hexo和github遇到问题

学习一样新事物，总是要经历磕磕碰碰，才能有所成长！脚踏实地，一步一个脚印，走好每一步，不要给自己留遗憾！

安装hexo问题

安装hexo我是在网上找教程安装的：
1.安装node.js(去官网下载windows版的安装包) node.js官网
2.安装git git下载地址
3.申请github账号 github 这里自己注册
设置user.name user.email

$ git config --global user.name "你的GitHub用户名"
$ git config --global user.email "你的GitHub注册邮箱"

4.生成ssh密匙
输入

$ ssh-keygen -t rsa -C "你的GitHub注册邮箱"

一路回车就OK了！
此时，在用户文件夹下就会有一个新的文件夹.ssh，里面有刚刚创建的ssh密钥文件id_rsa和id_rsa.pub。
上传公匙添加到github上
记住是id_rsa.pub内容复制到github上

5.安装hexo

$ npm install hexo-cli g
# 建立一个文件夹hexo
$ mkdir hexo 
# 初始化hexo文件夹
$ hexo init hexo
# 安装hexo插件(都安装吧!)
$ npm install hexo-server --save
$ npm install hexo-admin --save
$ npm install hexo-generator-archive --save
$ npm install hexo-generator-feed --save
$ npm install hexo-generator-search --save
$ npm install hexo-generator-tag --save
$ npm install hexo-deployer-git --save
$ npm install hexo-generator-sitemap --save
$ npm install hexo-generator-category --save

6.本地使用hexo

# 生成静态页面
$ hexo generate
# 开启本地服务器(可以使用全名 hexo server)
$ hexo s

在浏览器输入 http://localhost:4000/ 就可以在本地访问blog
7.hexo部署到github上

先在github上创建一个仓库名字： github用户名.github.io
这个创库的命名规则不能弄错了！！！！！！

修改博客配置文件(hexo/_config.yml)，在文件里找到下面内容并修改

# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
  # 类型
  type: git
  # 仓库
  repo: [email protected]:用户名/用户名.github.io.git
  # 分支
  branch: master

记得一定要修改成自己的用户名！！！！这种方式使用ssh链接(前提是你添加了公钥到github)
还有一种方式是把repo 修改为下面

 repo: https://github.com/用户名/用户名.github.io

由于我用得两个github账号，建立hexo博客是换了一个新的账号使用这种方式总是报 403 错误我是改用ssh链接github

输入下面的命令将hexo博客部署到github中：

# 清空静态页面
hexo clean
# 生成静态页面
hexo generate
# 部署 
hexo deploy

这里有一点建议：发布时最好连续执行这三个命令，以免部署到github的hexo为以前的，就相当于刷新一下缓存。

hexo替换主题

我使用的next主题
1.打开git bash 并切换到你的博客目录下比如我的博客目录是 /hexo

#自己切换自己的博客目录
$ cd hexo
# 执行下面命令
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

2.修改博客配置文件 /hexo/_config.yml 如下：

# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
#以前的选项为     theme: landscape
theme: next

3.修改主题配置文件 /hexo/themes/next/_config.yml

menu修改

找到下面内容

# ---------------------------------------------------------------
# Menu Settings
# ---------------------------------------------------------------
menu:
  home: / || home
  #about: /about/ || user
  tags: /tags/ || tags
  #categories: /categories/ || th
  #archives: /archives/ || archive
  #schedule: /schedule/ || calendar
  #sitemap: /sitemap.xml || sitemap
  #commonweal: /404/ || heartbeat

去掉 # 就可以多一个菜单栏比如去掉

menu:
  home: / || home
  #about: /about/ || user
  tags: /tags/ || tags
  categories: /categories/ || th
  #archives: /archives/ || archive
  #schedule: /schedule/ || calendar
  #sitemap: /sitemap.xml || sitemap
  #commonweal: /404/ || heartbeat

虽然在首页能看见这个菜单，但是是不能使用
点击菜单 categories 会返回 can't get /categories/ 错误信息
首先要安装categories对应插件

$ npm install hexo-generator-category --save

再在gitbash输入（hexo目录下）

$ hexo new page categories

在/hexo/source 目录下发现多的一个categories文件夹进入编辑 index.md

---
title: categories
date: 2018-1-22 12:39:04
type: "categories"
comments: false
---

在/hexo/source/_post 目录建立 test.md 内容如下

---
title: test
categories:
  - Testing
---

注意空格！！！！注意空格！！！！注意空格！！！！注意空格！！！！

赞赏功能问题

在添加赞赏功能是替换了图片不能出现赞赏功能
next赞赏功能启用
在主题配置文件找到如下内容并修改如下：

# Reward
reward_comment: Donate
wechatpay: /images/wechatpay.png
alipay: /images/alipay.jpg
#bitcoin: /images/bitcoin.png

自己图片位置在 Hexo/themes/next/source image文件内
修改成这样过后但是还是不能显示赞赏功能。至少我是这样，经过百度终于解决了。在主题配置文件查找

# Automatically Excerpt. Not recommend.
# Please use  in the post to control excerpt accurately.
auto_excerpt:
  enable: false
  length: 150

修改如下:

# Automatically Excerpt. Not recommend.
# Please use  in the post to control excerpt accurately.
auto_excerpt:
  enable: true
  length: 150

在执行

$ hexo clean && hexo generate &&  hexo s

这下应该可以！

本地搜索配置

1.hexo配置文件(/hexo/_config.yml)添加

#search
search:
  path: search.xml
  field: post
  format: html
  limit: 10000

2.安装插件

 $ npm install hexo-generator-search --save
 $ npm install hexo-generator-searchdb --save

3.修改主题配置文件(/hexo/themes/next/_config.yml)

# Local search
# Dependencies: https://github.com/flashlab/hexo-generator-search
local_search:
  enable: false
  # if auto, trigger search by changing input
  # if manual, trigger search by pressing enter key or search button
  trigger: auto
  # show top n results per article, show all results by setting to -1
  top_n_per_article: 1

修改为

# Local search
# Dependencies: https://github.com/flashlab/hexo-generator-search
local_search:
  enable: true
  # if auto, trigger search by changing input
  # if manual, trigger search by pressing enter key or search button
  trigger: auto
  # show top n results per article, show all results by setting to -1
  top_n_per_article: 1

集成gitment评论问题

自己按照网上教程安装的几次，但出现的问题是 “未开发评论” 点击login出现404错误
经过一天的努力终于知道原因的，需要发布到git上去，再用自己的git账号登录一下就OK了！
由于没有清除浏览器缓存，出现发布了但未更新。评论还是以前那样。记得清除浏览器缓存，或者换一个浏览器。
集成步骤：
1.注册OAuth Application 点击 https://github.com/settings/applications/new
2.修改 themes/next/_config.yml

# Gitment
# Introduction: https://imsun.net/posts/gitment-introduction/
# You can get your Github ID from https://api.github.com/users/
gitment:
  enable: true
  mint: false 
  # RECOMMEND, A mint on Gitment, to support count, language and proxy_gateway
  count: true 
  # Show comments count in post meta area
  lazy: false 
  # 需要懒加载的 修改为true
  # Comments lazy loading with a button
  cleanly: true 
  # Hide 'Powered by ...' on footer, and more
  language: 
  # Force language, or auto switch by theme
  github_user: 你的github用户名
  github_repo: 用户名.github.io
  client_id: 创建OAuth Application时用户id
  client_secret: 填写你自己的client_secret
  #proxy_gateway: # Address of api proxy, See: https://github.com/aimingoo/intersect
  #redirect_protocol: # Protocol of redirect_uri with force_redirect_protocol when mint enabled

其他的就不用修改了。默认就OK了！等以后玩熟了再自定义配置！

参考文档

next参考文档
hexo参考文档

没事就多看看官方文档，应该能解决问题的！加油！

2018-02-06