在github上搭建hexo静态博客

以下针对的是mac,系统是OS X EI Capitan 10.11.3 ,安装的Node.js是5.5.0,hexo是3.1.1版本,不同的版本可能显示的不一样,或者有一些命令不太一样,如果按照如下教程,需要注意这点.至于git的客户端,假定你机子上已经安装了苹果的xcode,xcode自带了git的命令行了.可使用命令 git –version 来确定机器上是否安装了git
本文的csdn链接 http://blog.csdn.net/yohunl/article/details/50638022

hexo简介

hexo是一个基于Node.js的静态博客程序，可以方便的生成静态网页托管在github和Heroku上。作者是来自台湾的@tommy351,官方网站hexo,其github页面在(https://github.com/hexojs/hexojs.github.io)

###配置环境

####安装node.js

首先肯定是要安装Node.js了,因为Hexo是基于Node.js的,安装Node.js的几种方法

  1. 你可以去官网https://nodejs.org/en/ 下载dmg文件安装
  2. 通过brew来安装(brew install node),homebrew是一个mac平台的包管理工具,http://brew.sh 其是通过ruby安装的,ruby是mac自带的,当然了你也可以安装更新的ruby环境
  3. 通过nvm来安装,要安装命令nvm,这个命令可以通过brew安装,brew install nvm,之后就可以使用nvm命令来安装node.js了,nvm的命令有 nvm install 5.0 或者nvm install v4.2.0 ,怎么知道有哪些版本可以安装呢?nvm ls-remote查看远程有多少可以安装的版本,nvm ls 查看本地nodes版本, nvm current当前本地使用的版本 nvm use 5.0 使用5.0版本的node.js
    当然了.安装nvm也可以使用官方的方式curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.30.2/install.sh | bash,我个人使用的是官方这种方式,安装时候出现了下面的情况
    1
    2
    3
    4
    5
    6
    7
    8
    9
    => Profile not found. Tried  (as defined in $PROFILE), ~/.bashrc,     ~/.bash_profile, ~/.zshrc, and ~/.profile.
    => Create one of them and run this script again
    => Create it (touch ) and run this script again
     OR
    => Append the following lines to the correct file yourself:

    export NVM_DIR="/Users/yohunl/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"  # This loads nvm
    => Close and reopen your terminal to start using

nvm这个错误,会导致什么问题呢,就是你输入nvm命令时候,提示你找不到这个命令!!!!
解决方式:在你的用户目录下,如果放在根目录下是不行的开始,我就是放根目录下,导致不行的,手动建立文件 .profile,再次运行这个命令,就可以了,这个命令会将

1
export NVM_DIR="/Users/yohunl/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"  # This loads nvm

写进去的,以后就可以直接命令行使用了.

安装hexo

由于现在的node安装都带了npm包管理,所以npm是不需要单独安装的,hexo是利用npm来安装的

1
npm install hexo -g  #-g表示全局安装, npm默认为当前项目安装  npm install -g hexo

如果已经安装过的,可以升级hexo到新版本

1
npm update hexo -g

建立博客站点

随便建立一个用于存放博客站点的文件夹,cd命令进入,例如hexoBlog

1
yohunldeMacBook-Pro:~ yohunl$ cd /Volumes/macHDD/test\ Projects/hexoBlog (我机子上的绝对路径,你的肯定不一样的)

站点的初始化

1
hexo init #来初始化这个站点

1
2
3
yohunldeMacBook-Pro:hexoBlog yohunl$ hexo init
INFO  Copying data to /Volumes/macHDD/test Projects/hexoBlog
INFO  You are almost done! Don't forget to run 'npm install' before you start blogging with Hexo!

这句命令运行完成,文件夹下

这里为什么 会提示 要先运行 npm install呢,如果你不管它,直接像网上说的那样运行
hexo generate （hexo g 也可以） 则会出现如下提示

66666.png

很明确的告诉你,没找到local hexo

所以hexo init后要接着npm install 或者 npm install hexo –save
这条命令时间可能有点长,等待它完成 , 当然,你也可以两个命令一起运行 hexo init && npm install
在目录下,多了一个目录node_modules

Uploading 33333_647536.png . . .]
接下来就可以生成静态页面了 #生成静态页面，会在public 目录下生成一系列html，css等文件。

1
hexo generate （hexo g  也可以）

生成之后,就可以启动本地预览了

1
2
3
4
5
hexo server (hexo s) #启动本地server


yohunldeMacBook-Pro:hexoblogs2 yohunl$ hexo server
INFO  Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

打开浏览器,输入 http://0.0.0.0:4000/,或者http://localhost:4000 都可以打开博客了,port 预设为 4000，可在 _config.yml 设定

将本地搭建的这个博客放到github上的个人页面去

github-page是一个免费的静态网站托管平台，由github提供,每个帐号只能有一个仓库来存放个人主页，而且仓库的名字必须是username/username.github.io，这是特殊的命名约定。你可以通过http://username.github.io来访问你的个人主页

进入你的github,新建一个项目，项目名为：你的用户名.github.io必须为这个名字,例如我的yohunl.github.io

建立好了后,我们需要进入刚刚创建的本地博客站点的目录下,打开_config.yml配置文件
最后,在这个文件的最后,将deploy:改为

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

注意这里,网上很多教程都是 写的github,但是从hexo 更新到3.0之后，deploy的type 的github需要改成git

忘了说了，我没用SSH Keys如果你用了SSH Keys的话直接在github里使用ssh方式也可以,上面的http模式,在命令deploy的执行过程中需要输入github账号的用户名和密码。

接下来就可以部署了

1
hexo deploy

注意上面的 type: 和git之间有一个空格,如果你没加,那么deploy命名就起不了作用了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
ERROR Deployer not found: git 这个你可能会遇到的,遇到的解决方式
ERROR Deployer not found: github
npm install hexo-deployer-git --save
再执行 hexo deploy
yohunldeMacBook-Pro:hexoBlog yohunl$ hexo deploy
INFO  Deploying: git
INFO  Setting up Git deployment...
Initialized empty Git repository in /Volumes/macHDD/test Projects/hexoBlog/.deploy_git/.git/
[master (root-commit) 0fa6454] First commit
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 placeholder
INFO  Clearing .deploy folder...
INFO  Copying files from public folder...
[master 2171193] Site updated: 2016-02-05 02:32:14
 29 files changed, 5746 insertions(+)
 create mode 100644 2016/02/05/hello-world/index.html
 create mode 100644 archives/2016/02/index.html
 create mode 100644 archives/2016/index.html
 create mode 100644 archives/index.html
 create mode 100644 css/fonts/FontAwesome.otf
 create mode 100644 css/fonts/fontawesome-webfont.eot
 create mode 100644 css/fonts/fontawesome-webfont.svg
 create mode 100644 css/fonts/fontawesome-webfont.ttf
 create mode 100644 css/fonts/fontawesome-webfont.woff
 create mode 100644 css/images/banner.jpg
 create mode 100644 css/style.css
 create mode 100644 fancybox/blank.gif
 create mode 100644 fancybox/fancybox_loading.gif
 create mode 100644 fancybox/fancybox_loading@2x.gif
 create mode 100644 fancybox/fancybox_overlay.png
 create mode 100644 fancybox/fancybox_sprite.png
 create mode 100644 fancybox/fancybox_sprite@2x.png
 create mode 100644 fancybox/helpers/fancybox_buttons.png
 create mode 100644 fancybox/helpers/jquery.fancybox-buttons.css
 create mode 100644 fancybox/helpers/jquery.fancybox-buttons.js
 create mode 100644 fancybox/helpers/jquery.fancybox-media.js
 create mode 100644 fancybox/helpers/jquery.fancybox-thumbs.css
 create mode 100644 fancybox/helpers/jquery.fancybox-thumbs.js
 create mode 100644 fancybox/jquery.fancybox.css
 create mode 100644 fancybox/jquery.fancybox.js
 create mode 100644 fancybox/jquery.fancybox.pack.js
 create mode 100644 index.html
 create mode 100644 js/script.js
 delete mode 100644 placeholder
 To https://github.com/yohunl/yohunl.github.io.git
 +f9914b9...2171193 master -> master (forced update)
 Branch master set up to track remote branch master from               https://github.com/yohunl/yohunl.github.io.git.
 INFO  Deploy done: git

经过deploy,等待
这过程中会让你输入git的用户名和密码
会在目录下生成

33333.png
,hexo会将其部署到github上,

44444.png
可以看到,部署到github上的,就是这个.deploy_git中的内容

打开域名
http://yohunl.github.io 就可以看到啦

###备注

####查看hexo版本

yohunldeMacBook-Pro:hexoBlog yohunl$ hexo -v
hexo: 3.1.1
os: Darwin 15.3.0 darwin x64
http_parser: 2.6.0
node: 5.5.0
v8: 4.6.85.31
uv: 1.8.0
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 47
openssl: 1.0.2e

####参考

使用github搭建静态博客hexo
如何搭建一个独立博客——简明Github Pages与Hexo教程
一步步在GitHub上创建博客主页-最新版
http://www.jianshu.com/p/465830080ea9
使用Hexo在github上搭建静态博客
通过Hexo在Github上搭建博客教程

本文标题:在github上搭建hexo静态博客

文章作者:Yohunl

发布时间:2016年02月06日 - 16时34分

最后更新:2016年02月07日 - 17时37分

原始链接:http://yoursite.com/2016/02/06/在github上搭建hexo静态博客/

许可协议: "署名-非商用-相同方式共享 3.0" 转载请保留原文链接及作者。

文章目录
  1. 1. hexo简介
  2. 2. ###配置环境
    1. 2.1. 安装hexo
    2. 2.2. 建立博客站点
    3. 2.3. 将本地搭建的这个博客放到github上的个人页面去
,