主要步骤

  1. 软件安装
  2. 创建github仓库
  3. 生成、配置ssh key
  4. 配置deployer
  5. 将本地hexo项目托管到github
  6. 绑定域名(可选)

软件安装部分:

nodejs

链接:nodejs官网
安装过程,一路next。
安装完成后,控制台输入:
node -v
显示nodejs版本号则nodejs安装成功。

git

链接:git官网
再次一路next。安装完成后,关闭控制台后再重新打开,然后输入
git --version
若输出git版本号,则安装成功。

Hexo

Hexo的安装

在你的硬盘里找一个合适的地方,创建一个文件夹(可命名为blog),如我的blog文件夹路径为D:\developer\blog。接下来将会安装Hexo,将Hexo初始化后的文件安排在这个blog文件夹里,以后整个博客的资源都在这里。
进入blog文件夹,在空白处打开右键菜单,选择Git Bash here,

在Git Bash中输入命令:
npm install -g hexo-cli

开始安装Hexo。安装完成后,继续输入hexo,按下回车,若输出提示信息,则安装成功。

hexo的初始化

1.若能看到上述的提示信息,则紧接着就输入 hexo init hexo
来对Hexo进行初始化。初始化所产生的文件都会在当前的目录blog之下。 初始化成功会显示Start blogging with Hexo! 然后在blog文件夹下会看到产生了一个hexo文件夹,这个就是初始化Hexo之后产生的。 (若你是直接打开Git Bash,此时git的工作目录将是/c/Users/你的用户名/。然后如果你这时输入命令对Hexo进行安装和初始化,就会把Hexo初始化到/c/Users/你的用户名/之下。为了便于管理,还是建议建立一个专门的文件夹,在这个文件夹对Hexo进行初始化。)
输入cd hexo命令进入到blog下的hexo目录中,
然后输入npm install安装依赖文件。
输入hexo generate(或简化的命令hexo g),生成博客网页资源文件。
2.测试
输入hexo server,在本地对形成的博客静态页面进行调试。此时显示Hexo is running at http://localhost:4000/,打开浏览器,输入地址localhost:4000会打开本地的博客预览页面。
如果能看到默认的博客页面,说明软件都正确安装好了。

创建github仓库

  • 注册、登陆github账号
  • 创建github pages:
    点击右上角加号,New repository。
    Repository name请务必填写你的用户名。

然后点击Create repository就行了。

生成、配置ssh key

1.检查是否有“C:\Users\你的用户名.ssh”目录。
若你的C:\Users\你的用户名\下没有.ssh文件夹,那是因为你第一次使用git,之前没有留下ssh key。

2.在git bash中输入:
ssh-keygen -t rsa -C "你的github注册邮箱" (有英文引号)
中间会让你填写key文件名,可以不用填,直接回车得到默认文件名的key,建议默认名即可。中途还会让你输入一个密码,这个是以后在本机部署文件到github时用到的,不是github登陆密码,可填可不填。
之后会在上述.ssh文件夹中产生两个文件,“id_rsa” 以及“id_rsa.pub”。

3.用文本编辑器打开id_rsa.pub,全选复制到剪贴板,然后点击github右上方头像打开设置面板,在settings里面的SSH and GPG keys 选项卡里,点击new SSH key,title自定义,key栏中就把刚才复制的内容粘贴上去。然后点击下面的按钮,add SSH key,密码确认就行了。

配置deployer(编辑站点配置文件)

1.打开blog\hexo目录,用文本编辑器打开_config.yml文件。在最后的##deployment一段中作如下修改和添加:

deploy:  
  type: git  
  repository: git@github.com:你的github用户名/你的github用户.github.io.git  
  branch: master

注意站点配置文件和主题配置文件中每个变量的冒号后都有一个空格,同级变量的缩进量要相等。(hexo文件夹下的_config.yml和hexo\themes\主题名称\中的_config.yml分别成为站点配置文件和主题配置文件
2.安装hexo-deployer-git插件:
git bash中,输入命令
npm install hexo-deployer-git --save
3.为自己配置身份信息:打开cmd命令行,然后输入:
git config --global user.name "yourname"
git config --global user.email "youremail"

将本地hexo项目托管到github

按顺序执行命令如下:
hexo clean #每次更换主题后亦需要使用此命令,简写是hexo cl
hexo generator #简写是hexo g
(然后此时可以先执行hexo s –debug,打开浏览器,在本地查看过效果,确定满意之后,再用以下这一条命令来将本地博客项目部署到github
hexo deploy #简写是hexo d
完成之后,稍等一下,在浏览器打开“你的用户名.github.io”应该就能够看到由hexo生成的博客了。

绑定域名

此项作为附加设置,也可以选择用github pages的默认域名,不用再去进行注册、解析、绑定域名的操作。
域名解析:
1.在github page项目内建立文本文件CNAME(没有后缀名),内容是所注册的域名。
建议在Hexo\source文件夹内建立这样的一个文件,以后部署不需要再重新创建CNAME文件。
2.在域名服务商控制面板对域名添加解析,记录类型为CNAME,主机记录为www(若写blog,则blog.你注册的域名.后缀是你的博客地址), 记录值为github page分配的默认域名。

绑定域名方面,有多种方法,主要可参考以下链接:

搭建完成

利用github pages和Hexo搭建静态页面博客过程到此结束。

参考链接

整个过程中我参考了很多文章,以下提供一些我个人认为比较有参考价值的文章链接:

  1. 文中提到了Hexo各目录存放的资源及作用,还提供了seo优化、部分插件的安装以及国内外分节点等干货:使用jekyll和hexo搭建免费博客
  2. 作者列了一些他碰到的坑,也许你碰到的坑就在里面:搭建Hexo博客中碰到的坑
  3. hexo官网,查看文档是一种很棒的学习方法:Hexo