# 前期准备
# 安装 git
- 下载:https://git-scm.com/download
- 安装:除了选择安装路径外,一直点 next 就行
可参考教程 https://blog.csdn.net/hahameier/article/details/86312530
# 安装 node.js
- 下载:https://nodejs.org/en/
- 安装:除了选择路径以外,一直点 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 文件
- 以管理员权限打开
cmd
- 输入
mkdir e:\blog
并回车,实现在e:\
路径下创建blog
文件夹 - 配置路径:先输入
e:
回车,切换默认目录至e
盘;然后输入cd e:\blog
回车,切换至e:\blog
目录
cmd
切换目录:
- “盘符
:
” 命令:进入指定硬盘区域,例:D:
命令,切换到 D 盘- “
cd
+ 空格 + 文件位置” 命令:切换到该磁盘下的指定目录dir
命令,显示当前目录下的所有文件cd ..
命令:返回上一级目录
# 初始化
- 初始化博客:输入
hexo init
,回车,等待... 直到出现INFO Starting blogging with Hexo
- 启动本地博客服务:输入
hexo s
,回车,得到本地访问地址http://localhost:4000
- 访问本地博客:浏览器打开 https://localhost:4000/
# 安装 git 插件
- 配置到
blog
目录:在cmd
命令行输入e:
回车,然后输入cd e:\blog
回车 - 安装部署插件:输入
cnpm install --save hexo-deployer-git
并回车,等待安装完成,如若出现 warning 可直接忽略
# 配置 git
- 打开 git bash
- 输入
git config --global user.email YourEmail
,其中YourEmail
是 github 邮箱 - 输入
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 仓库
cmd
命令行配置到路径e:\blog
- 部署:输入
hexo d
并回车,部署到 github 仓库里 - 等待弹窗,输入 github 账户密码,即配置完成
# hexo 相关命令
hexo c
:清理hexo n
:新建hexo g
:生成博客hexo s
:启动本地博客服务hexo d
:部署到远端 github 博客
# 其他配置
# 主题
本博客采用的是 Shoka 主题
其相关配置可参考:
可访问 hexo 主题列表 查看更多主题
# 链接格式
# 插件
静态链接转换:hexo-abbrlink / hexo-permalink-pinyin
为 github 生成 readme.md 文件:hexo-generator-readme-file
# 评论系统
本博客搭建的是 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 没有评论管理、邮件通知等功能
邮件通知、评论管理功能可参考以下教程: