前言

准备工作

Github账号
node.js、hexo、npm安装

一、安装node.js

下载windows版node.js

下载地址: https://nodejs.org/en/download/

选择Windows Installer(.msi) 64-bit
双击node-v12.13.0-x64.msi, 一直next安装完成
测试是否安装成功

win+R键，输入cmd,然后回车，打开cmd窗口

输入node -v 显示node.js版本

输入npm -v 显示npm版本

安装完成

二、安装hexo

先创建hexo的安装目录, 例如: F:\LearnSpace\Blog
cd Blob 进入Blob目录
npm install hexo-cli -g 安装hexo
hexo -v 验证是否安装成功
npm init blog 初始化blog文件夹，存放博客
npm install 安装必备组件
cd blog
hexo g 生成静态网页
hexo s 打开本地服务器
http://localhost:4000/ 打开网页
ctrl + c 关闭本地服务器

三、连接Github与本地

新建一个名为你的github用户名.github.io的仓库，比如说，如果你的Github用户名是test，那么你就新建test.github.io的仓库（必须是你的用户名，其它名称无效），将来你的网站访问地址就是http://test.github.io 了。

点击Settings，向下拉到最后有个GitHub Pages，点击Choose a theme选择一个主题。然后等一会儿，再回到GitHub Pages, 就会像下面一样
修改配置文件

编辑blog根目录下的_config.yml, 修改最后一行的配置

deploy:
  type: git
  repository: https://github.com/981935539/981935539.github.io.git
  branch: master

安装Git部署插件: npm install hexo-deployer-git --save

四、编辑第一篇博客

hexo new post "first-article"  # 创建第一篇博客
hexo g  # 生成静态网页
hexo s  # 本地预览效果
hexo d  # 上传github

此时可以在github.io主页就能看到发布的文章啦。

五、绑定域名

以阿里云为例，如下图所示，添加两条解析记录:

然后打开你的Github博客项目，点击settings，拉到下面Custom domain处，填上你自己的域名，保存
这时候你的F:\LearnSpace\Blog\blob\source 会出现一个CNAME的文件
如果没有CNAME文件

打开你本地博客/source目录，我的是F:\LearnSpace\Blog\blob\source，新建CNAME文件，注意没有后缀。然后在里面写上你的域名，保存。最后运行hexo g、hexo d上传到Github。

六、hexo常用命令

npm install hexo-cli -g      # 安装hexo
npm uninstall hexo-cli -g      # 卸载hexo

hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

# 缩写
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

# 组合
hexo s -g #生成并本地预览
hexo d -g #生成并上传

七、写博客的规范

_config.yml

冒号后面必须有一个空格，否则会出问题
图片

引用图片需要把图片放在对应的文件夹中，只需要写文件名就可以了

文章头设置

模板在/scaffolds/post.md

--- 
title: {{ title }} # 文章名称
date: {{ date }} # 文章生成时间
top: false 
cover: false 
password: 
toc: true 
mathjax: true 
summary: 
tags:
-- [tag1]
-- [tag2]
-- [tag3]
categories: 
-- [cat1]
---

八、备份博客源文件

博客已经搭建完成，但是博客仓库只是保存生成的静态网页文件，是没有博客源文件的，如果电脑出现了问题，那就麻烦了，所以源文件也需要备份一下。

在Github上创建一个与本地仓库同名的仓库, 我的是hexo-matery

初始化本地仓库

git init       
添加.gitignore文件
.gitignore
    .DS_Store
    Thumbs.db
    *.log
    public/
    .deploy*/
    .vscode/

连接到远程Github,

git remote add github git@github.com:981935539/hexo-matery.git
git fetch
git merge --allow-unrelated-histories github/master

推送本地源文件到Github

git add .
git commit -m "第一次备份本地仓库"
git push --set-upstream github master

现在在任何一台电脑上, 执行git clonegit@github.com:981935539/hexo-matery.git

就可以把博客源文件复制到本地。

九、Ubuntu安装node.js和hexo

tar -xvf node-v12.13.0-linux-x64.tar.xz
sudo mv node-v12.13.0-linux-x64 /usr/local
sudo ln -s /usr/local/node-v12.13.0-linux-x64/bin/node /usr/local/bin/node
sudo ln -s /usr/local/node-v12.13.0-linux-x64/bin/npm /usr/local/bin/npm

sudo npm install -g hexo
sudo ln -s /usr/local/node-v12.13.0-linux-x64/bin/hexo /usr/local/bin/hexo