Hexo静态博客搭建教程
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。生成静态网页可以托管在github。下面简单介绍一下hexo的安装部署步骤,以免新手或重新配置时走弯路。
1.安装Git
官方下载地址:https://git-scm.com/
下载 并执行默认安装 即可完成安装。
2.安装Node.js
在 Windows 环境下安装 Node.js 非常简单,仅须下载安装文件并执行即可完成安装。这里我下载的是V4.4.1LTS
3.安装hexo
利用 npm 命令即可安装。(在任意位置点击鼠标右键,选择Git bash)
1
|
npm install -g hexo |
可以通过一下命令查看hexo的版本
1
2
3
4
5
6
7
8
9
10
11
12
13
|
$ hexo version hexo: 3.2.0 hexo-cli: 1.0.1 os: Windows_NT 10.0.10586 win32 x64 http_parser: 2.5.2 node: 4.4.1 v8: 4.5.103.35 uv: 1.8.0 zlib: 1.2.8 ares: 1.10.1-DEV icu: 56.1 modules: 46 openssl: 1.0.2g |
3.1创建Hexo文件夹
安装完成后,在合适的磁盘内新建一个文件夹作为博客目录 (如E:\Hexo),执行以下指令(在E:\Hexo文件夹内点击鼠标右键,选择Git bash,注意后面的命令都是在此文件夹内执行的 ),Hexo 即会自动在目标文件夹建立网站所需要的所有文件。
1
|
hexo init |
当然也可以在上面的命令后方加上文件夹的路径,这样就不用像上面一样先新建文件夹了。
3.2安装依赖包
1
|
npm install |
3.3本地查看
现在我们已经搭建起本地的hexo博客了,执行以下命令(在E:\Hexo),然后到浏览器输入localhost:4000看看。
1
2
|
hexo generate hexo server |
hexo 也支持缩写命令:
1
2
3
4
|
hexo generate = hexo g hexo server = hexo s hexo deploy = hexo d hexo new = hexo n |
好了,至此,本地博客已经搭建起来了,只能在本地访问 。下面,我们要部署到Github。
4.将博客部署到Github
4.1注册Github账号
已有账号可以跳过,没有的,请在此进行注册,很简单,这里就不介绍了
4.2创建repository
在自己Github主页右上角,点击加号, 创建一个新的repository。比如我的Github账号是stellar91,那么我应该创建的repository名字应该是stellar91.github.io。
4.3部署
编辑_config.yml(在E:\Hexo下)。你在部署时,要把下面的stellar91都换成你的账号名。
1
2
3
4
|
deploy: type : git repository: https: //github .com /stellar91/stellar91 .github.io.git branch: master |
最新版本的hexo 中,这里的 type 要写成 git,而不是 github。另外尤其要注意不要删除上述文件中的空格,冒号后面都紧跟了一个空格
在正式部署之前,新用户需要设置 SSH。SSH 的介绍和设置方法按照官方教程的四个步骤很容易完成(真的很容易 )。
接下来安装部分模块,执行下面的命令
1
|
npm install hexo-deployer-git --save |
在第一次使用Git时,需要用户名和邮箱两个信息 。具体通过以下命令设置:
1
2
|
git config --global user.name "stellar91" git config --global user.email "muyuxingguang@163.com" |
最后执行下列指令即可完成部署。
1
2
|
hexo generate hexo deploy |
第一次使用可能要输入GitHub的用户名和密码。 命令执行过程中只要不是error可以忽略,(确实会出现很多空格编码的warning )
Notes:每次修改本地文件后,需要hexo generrate才能保存。每次使用命令时,都要在E:\Hexo目录下。每次想要上传文件到Github时,就应该先键入hexo generate保存之后,再键入hexo deploy。
我们的博客已经完全搭建起来了,在浏览器访问stellar.github.io访问博客了!(可能需要等一会儿才会生效 )
5.绑定自己的域名
在域名解析服务中 添加为CNAME记录,记录值就是stellar91.github.io这种形式。比如这里我绑定的是blog.star91.net
接下来需要去自己的hexo进行域名设置,,进入source文件夹,创建名为CNAME的文件(没有扩展名的哦 ),第一行写入你的域名:
1
|
blog.star91.net |
这样就设置好了,域名解析需要一定时间生效, 访问http://blog.star91.net就能看到自己的博客网站了。
如果出现404NOT FOUND二等情况,需要在E:/Hexo下再次执行:
1
2
|
hexo generate hexo deploy |
执行完上述命令,CNAME的文件就会出现在Github的仓库,这样就可以通过自己的域名访问了,当然你也可以直接在Github上创建这个文件。