hexo 简单搭建（一）

发表于 | 更新于 | 分类于 | 评论数： | 阅读次数：

简单记录下搭建hexo的过程。

首先介绍一下本文中hexo搭建的大致流程：

  1. 完成准备工作：安装git；安装node.js；bash下hexo init安装hexo;bash下npm install安装依赖包。
  2. 本地查看：使用hexo g生成；使用hexo s打开服务器；在浏览器输入127.0.0.1:4000或localhost:4000查看。
  3. 部署到github：创建repository；添加ssh key；在hexo配置文件hexo_config.yml中修改，完成部署。
  4. 查看：浏览器访问yourname.github.io就可以查看了，看不到可以稍等几分钟。
  5. 写博客：创建博客hexo new "testname"；完成后hexo g生成，hexo s本地查看（修改）；定稿后hexo d发布。
    这样就可以在yourname.github.io查看到自己的博客了。

具体如下。

安装Git

下载并安装。
鼠标右键看到Git Bash说明安装成功。

安装Node.js

下载，安装并配置环境变量。
注意： 在官网下载的exe文件不能安装，会导致在安装hexo的过程中各种提示command not found，例如提示“sh: npm: command not found”。
因此，直接点击“install”，保存.msi文件，再安装node.js。

安装hexo

在任意位置点击鼠标右键，选择Git bash。输入以下命令：

1
npm install -g hexo

创建hexo文件夹并安装依赖包

在H:\hexo内右键，选Git bash。输入以下命令

1
2
hexo init
npm install

本地查看

输入以下命令后，在浏览器查看。端口为4000。（127.0.0.1:4000或localhost:4000）

1
2
hexo generate
hexo server

generate也可简写为g，同理，server为s。

注意：

1.hexo s无效并出现如下提示信息时

1
2
$ hexo s
Usage: hexo <command>

使用以下命令安装server

1
npm install hexo-server --save

2.打开localhost:4000，显示Cannot GET /
重新npm install，就好了。

现在只能在本地查看，下面部署到github。

创建repository

创建方法为+New repository —> 输入Repository name —> Create repository。

注意： repository名字必须与github上名字一样！！即格式必须为yourname/yourname@github.com或yourname/yourname@github.io。

添加SSH key

参照GitHub官网给出的方法。
下面简单写一下。

1.检查电脑是否已经有SSH key
在用户主目录下，看看有没有.ssh目录，如果有，再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件，如果已经有了，可直接跳到步骤3。
或者用以下方式查看。

1
2
$ ls -al ~/.ssh
# Lists the files in your .ssh directory, if they exist

2.如果没有SSH key，则创建新的SSH key（Windows下打开Git Bash）。

1
2
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
# Creates a new ssh key, using the provided email as a label

觉得不需要设置密码就一路回车。
完成成功后可以在用户主目录里找到.ssh目录，里面有id_rsa和id_rsa.pub两个文件，这两个就是SSH Key的秘钥对，id_rsa是私钥，不能泄露，id_rsa.pub是公钥，可以公开。

3.将.ssh文件中id_rsa.pub中的内容拷贝，添加到github。具体：在GitHub右上方点击头像，选择”Settings”，在右边的”Personal settings”侧边栏选择”SSH Keys”。接着粘贴key，点击”Add key”按钮。

部署

编辑H:\hexo_config.yml。

1
2
3
4
deploy:
  type: git
  repository: https://github.com/yourname/yourname.github.io.git
  branch: master

执行以下命令完成部署。

1
2
hexo g
hexo d

其中，d为deploy。

休息一会，喝几口冷水，再在浏览器访问yourname.github.io就可以看到自己的博客了。

注意：

1.如果在执行hexo d时，报错如下（找不到git部署）

1
ERROR Deployer not found: git

解决方法如下

1
npm install hexo-deployer-git --save

再重新执行g，d即可访问。

2.如果执行hexo d时，提示如下

1
2
3
4
5
6
7
8
9
*** Please tell me who you are.

Run

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

to set your account's default identity.
Omit --global to set the identity only in this repository.

按照上面的提示输入email和name。

1
2
git config --global user.email "you@example.com"
git config --global user.name "Your Name"

3.不论在创建repository时是yourname/yourname@github.com还是yourname/yourname@github.io，都必须访问yourname.github.io才能访问。yourname.github.com是不能够访问的。

写博客

新建博客，在bash下输入以下命令就可以完成名为testname.md博客文件的新建，在H:\hexo\source\_posts可以找到。

1
hexo new "testname"

写完博客后，使用如下命令生成并发表。

1
2
hexo g
hexo d

发表前可以使用hexo s本地查看一下，修改定稿后再hexo d发布。

参考