首页 Tutorial Hexo

# 前期准备

# 安装 git

  1. 下载：https://git-scm.com/download
  2. 安装：除了选择安装路径外，一直点 next 就行

可参考教程 https://blog.csdn.net/hahameier/article/details/86312530

# 安装 node.js

  1. 下载：https://nodejs.org/en/
  2. 安装：除了选择路径以外，一直点 next 就行

# hexo 环境搭建

# 进入命令行

打开命令行窗口：按 win+r 键，输入 cmd ，回车，后续操作均在命令行进行

# 安装 cnpm

安装 cnpm 镜像源：输入 npm install -g cnpm --registry=http://registry.npm.taobao.org ，回车，等待...

# 安装 hexo

安装 hexo 框架：输入 cnpm install -g hexo-cli ，回车

# 新建 blog 文件

  1. 以管理员权限打开 cmd
  2. 输入 mkdir e:\blog 并回车，实现在 e:\ 路径下创建 blog 文件夹
  3. 配置路径：先输入 e: 回车，切换默认目录至 e 盘；然后输入 cd e:\blog 回车，切换至 e:\blog 目录

cmd 切换目录：

  • “盘符 : ” 命令：进入指定硬盘区域，例： D: 命令，切换到 D 盘
  • “ cd + 空格 + 文件位置” 命令：切换到该磁盘下的指定目录
  • dir 命令，显示当前目录下的所有文件
  • cd .. 命令：返回上一级目录

# 初始化

  1. 初始化博客：输入 hexo init ，回车，等待... 直到出现 INFO Starting blogging with Hexo
  2. 启动本地博客服务：输入 hexo s ，回车，得到本地访问地址 http://localhost:4000
  3. 访问本地博客：浏览器打开 https://localhost:4000/

# 安装 git 插件

  1. 配置到 blog 目录：在 cmd 命令行输入 e: 回车，然后输入 cd e:\blog 回车
  2. 安装部署插件：输入 cnpm install --save hexo-deployer-git 并回车，等待安装完成，如若出现 warning 可直接忽略

# 配置 git

  1. 打开 git bash
  2. 输入 git config --global user.email YourEmail ，其中 YourEmail 是 github 邮箱
  3. 输入 git config --global user.name YourName ， YourName 是 github 用户名

# 创建 github 仓库

登录 github 网页，右上角 New repository 新建仓库， Repository name 命名为 YourName.github.io （以避免二级域名）

# 配置_config.yml

打开 e:\blog 路径下的 _config.yml 文件，找到 Deployment 板块，配置如下

# Deployment
deploy: 
  type: git
  repo: https://github.com/YourGithubName/YourGithubName.github.io.git
  branch: master

其中， repo 后面的链接为个人 github 仓库的链接， branch 填写仓库默认分支

注：冒号后面需要有英文环境下的空格

# 部署到 github 仓库

  1. cmd 命令行配置到路径 e:\blog
  2. 部署：输入 hexo d 并回车，部署到 github 仓库里
  3. 等待弹窗，输入 github 账户密码，即配置完成

# hexo 相关命令

  • hexo c ：清理
  • hexo n ：新建
  • hexo g ：生成博客
  • hexo s ：启动本地博客服务
  • hexo d ：部署到远端 github 博客

# 其他配置

# 主题

本博客采用的是 Shoka 主题

其相关配置可参考：

  • Shoka 主题使用说明
  • Shoka 主题功能介绍补充点
  • Shoka 主题进阶玩法
  • 添加 Jsdelivr CDN 的链接无法访问
  • Jsdelivr 刷新缓存

可访问 hexo 主题列表 查看更多主题

# 插件

静态链接转换：hexo-abbrlink / hexo-permalink-pinyin

显示本地图片：hexo-asset-img

为 github 生成 readme.md 文件：hexo-generator-readme-file

hexo 插件列表

# 评论系统

本博客搭建的是 Valine 评论系统

在 _config.yml 主题配置文件中，添加如下配置（具体参数可参考 Valine 配置项）：

# valine
valine:
  appId: # Leancloud 的 AppID
  appKey: # Leancloud 的 AppKey
  placeholder: 欢迎评论~ # Comment box placeholder
  avatar: mp # Gravatar style : mp, identicon, monsterid, wavatar, robohash, retro
  pageSize: 10 # Pagination size
  lang: zh-CN
  visitor: true # 文章访问量统计
  NoRecordIP: false # 不记录 IP
  serverURLs: # Leanclound 的 REST API 服务器地址

需自行填写 appId 和 appKey ，其值分别为 Leancloud 的 AppID 和 AppKey

若 Leancloud 为国际版，需在 _config.yml 文件中设置 serverURLs ，其值为 Leancloud 中的 REST API 服务器地址

注：Valine 没有评论管理、邮件通知等功能

邮件通知、评论管理功能可参考以下教程：

  • Valine Admin

  • Valine Admin 升级版（含 QQ、微信提醒功能）

# 参考资料

Hexo 博客搭建的视频教程

解决 Github 连接不上的问题：HOSTS 文件配置

使用 SSH 地址

hexo + github 本地和线上图片不显示问题

Hexo 博客搭建超级指南

Hexo 博客同时部署到 Github 和 Gitee

为博客添加免费的 CDN 加速

将 Hexo 博客提交 Google 并配置 Google Analysis

百度，必应，谷歌收录

阅读次数 次