搭建基于hexo的个人博客

写在前面:

首先,这个教程是我自己安装一遍之后写的,所以里面的一些坑也走过,于是总结出了下面的步骤,希望你们少走弯路。

其次,因为是第一次安装,所以是参考了别人的教程做的,但是按照自己的理解之后,重新编排了步骤,使之更容易安装成功

最后,希望看完这边教程之后,你们也可以有一个属于自己的blog

安装Node

作用:用来生成静态页面的

注意:直接去人家官网下载,但是速度可能会慢一些

安装Git

作用:把本地的hexo内容提交到github上去.
注意:在mac平台上,如果已经安装Xcode,那么可忽略此步骤

申请GitHub

作用:是用来做博客的远程创库、域名、服务器

  • 3.1 SSH配置(用于将本机与Github关联)

    • 3.1.1 检查SSH keys是否存在Github

      执行如下命令,检查SSH keys是否存在。如果有文件 id_rsa.pub 或 id_dsa.pub,则直接进入步骤3.1.3将SSH key添加到Github中,否则进入下一步生成SSH key。

      1
      ls -al ~/.ssh
    • 3.1.2 生成新的ssh key

      执行如下命令,email填写你注册GitHub时的邮箱。这个过程可能会让你输入生成文件名和路径,自己随便填一下吧。但是系统会默认会在相应路径下(~/.ssh/id_rsa.pub)生成 id_rsa.pub和 id_dsa.pub两个文件。

      1
      ssh-keygen -t rsa -C “your-mail"
    • 3.1.3 将ssh添加到GitHub上

      进入你设置的文件路径,打开id_rsa.pub文件,复制ssh信息,或者直接command+A

      1
      打开GitHub,Setting,SSH keys,add keys  command+V

正式安装hexo

  • 4.1 创建一个blog文件夹(任意名字都行),以后的操作都是基于这个路径

  • 4.2 执行命令

1
2
3
4
安装hexo:sudo npm install -g hexo
初始化:hexo init blog
安装npm:npm install
开启hexo服务器:hexo s

至此,在浏览器上输入:http://localhost:4000,应该能看到hexo的欢迎界面了!


创建GitHub仓库

  • 5.1 创建属于你的第一个仓库

    登录GitHub,创建属于你的第一个仓库,仓库名必须为 【your_user_name.github.io】

  • 5.2 配置_config.yml文件

    回到你的blog文件夹下,有一个_config.yml文件,在终端下通过vim命令(vim _config.yml)打开并编辑(vim相关操作自行百度),打开之后,翻到最后一页,看到了deploy: 重点来了!!!

1
2
3
编辑deploy冒号后的属性,这里有严格的格式要求:
1. 每个属性冒号都要空格
2. 四个属性都要写
1
2
3
4
5
6
7
8
9
10
11
12
13
模板:
deploy:
type: git
repo: <repository url>
branch: [branch]
message: [message]

实例:
deploy:
type: git
repo: https://github.com/myname/myname.github.io.git
branch: master
message: helloworld
  • 5.3 最后部署
1
2
3
npm install hexo-deployer-git --save
hexo generate
hexo deploy(这一步之后可能会让你输入你GitHub的账号密码,正常输入就好了)

到这里,在浏览器上输入myname.github.io,就可以看见上面和localhost一样的页面了!!!

###标志着你的blog创建完毕!!!

补充

  • 6.1 发布文章

    • 1.在blog目录下,找到->source -> _posts文件夹,创建makedown文件,编写完成之后,执行第二步

    • 2.hexo generate

    • 3.hexo deploy

  • 6.2 常用命令
1
2
3
4
5
6
7
8
9
10
11
12
13
14

hexo new"postName" #新建文章

hexo new page"pageName" #新建页面

hexo generate #生成静态页面至public目录

hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)

hexo deploy #将.deploy目录部署到GitHub

hexo help # 查看帮助

hexo version #查看Hexo的版本