hexo建站完整步骤(Windows环境)

文章更新

  1. 20161021-初次成文
  2. 20170804-文章终结

为什么会有这篇文章

在另外一篇帖子里,内容和这个基本重复了,传送门请戳这里

环境安装

需要预先下载Git和Node.JS,并且安装。

Windows 环境下,安装git for windows和node.js

MAC OS环境下,安装Homebrew,并使用brew命令安装Node.js和NPM,方法参考这里

全局安装hexo的命令航工具hexo-cli

npm install -g hexo-cli

目前我个人对-g--save的理解还比较粗浅,比如对Hexo-cli这种包,应该使用-g让npm将hexo安装到全局,以便你可以在任何目录下都使用hexo init来初始化一个hexo的项目,而对于--save则是将让npm将这个包安装到当前项目下,以便当期项目可以使用这个包,比如hexo-deployer-git这样的包就需要使用--save参数。

初始化项目

这里使用blog作为项目名,你可以随便使用其他任何名称,这里仅作示例。

hexo init blog

如果已经在blog目录下面了,直接使用’hexo init’命令即可。

运行hexo

cd blog
hexo server

如果4000端口没有被其他程序占用,就可以通过浏览器,查看 http://localhost:4000/ ,访问hexo初始化后的默认内容。

Github上创建项目

在Github上,上创建两个项目,一个私有的项目用来存放Hexo的源文件(markdown格式),另外一个公开项目,用来存放展示的html文件。

需要注意的是,用来公开展示的项目名称需要和你的账户名一致。

将本地的hexo代码上传到Coding.net

首先使用git remote -v查看目前的远程仓库推送和拉取方式

如果返回值为空,说明你的.git/config文件缺少 [remote "origin"] 内容,需要使用下列的命令进行添加

git config branch.master.remote origin
git config branch.master.merge  refs/heads/master

这样就有了内容,如果你发现git remote -v返回的是https方式,那么需要修改为git方式

从https修改为git方式

git remote set-url origin git@git.coding.net:tinyvane/hexo.git

这样再次运行git pull/push就不会再要你输入密码了。

也可以通过下面的命令,从git方式修改为https方式

git remote set-url origin https://git.coding.net/tinyvane/hexo.git

Pages服务有个特点, 如果项目名和用户名一样. 就可以使用 username.coding.me 访问发布的网站, 否则则是 username.coding.me/projectname

开启Pages服务

进入项目页面的Pages服务那一栏,立即开启. 默认使用了coding-pages的branch

绑定ssh证书

首先要在本地生成ssh证书,ssh-keygen -t rsa -C "you@youremail.com",把证书的公钥(~/.ssh/id_rsa.pub)的内容拷贝到coding个人账户下的SSH公钥里面

配置hexo的deploy方式

在hexo目录(本文是blog)下面找到_config.yml,在文件末尾加上deploy到coding的配置

deploy:
  type: git
  repo:
    coding: git@git.coding.net:username/projectname.git,coding-pages

注意coding.net的配置是 coding:{项目git地址},{branch}

生成静态文件

hexo g

由于coding.net的Pages服务是默认执行jekyll项目, 静态项目需要一个.nojekyll文件标识.

所以第一次执行, 需要在生成的public文件夹中加入一个 .nojekyll 空白文件

部署命令

hexo d

就可以发布成功了

访问hexo

默认访问地址是username.coding.me或者username.coding.me/projectname

后面每次更新博客的时候, 就只需要重复上面的命令hexo g && hexo d就可以立刻发布

查看实例 http://www.wuliaole.com

参考文章

  1. http://www.jianshu.com/p/f104e6b7c0c5