在Gitcafe上部署hexo博客方法介绍

最近闲着无聊,突发想搞一个自己的博客。于是就有了这个blog。在搭建的过程中也出了许多的问题,不过最后还是搭建完成了。现在我把我搭建的过程记录下来,作为备忘和分享。

##0x00
首先是我自己机子的环境介绍以及各种组件介绍
我的机子操作系统为ubuntu 14.04。必要的软件为node.js与git。我的博客部署是在gitcafe上,使用的hexo的框架搭建。使用的主题的Next主题的Mist风格。

##0x01
首先是必要的软件安装工作

首先安装node.js与git。ubuntu下的安装非常的简单,使用apt就可以完成。

sudo apt-get install nodejs
sudo apt-get install git

两条命令解决,当然也可以选择下载源码编译的方法完成。

然后是安装hexo

sudo npm install -g hexo

现在必要的软件就已经下载完成了。

##0x02
接下来的任务是配置hexo

###创建目录
首先选择一个地方创建的hexo的主目录,以后所有的文章的markdown源,以及各种主题配置等都会放置在这里。
我选择在将它放在我的用户主目录下

mkdir ~/hexo
cd ~/hexo
hexo init

在你指定的目录下执行hexo init命令就会自动把相关的文件拷贝的进来。

###安装依赖包
这一部很重要,许多时候出现错误就是因为这一步没有到位。

sudo npm install

有些时候还需要手动安装一些plugins,以防万一,最好安装一遍。

sudo npm install hexo-renderer-ejs --save
sudo npm install hexo-renderer-marked --save
sudo npm install hexo-renderer-stylus --

###本地测试
hexo在安装完成后就自带了一篇Hello world帮助的博文。所以可以直接进行本地的测试,稍后再介绍如何创建新的文章。
本地测试很简单。

hexo generate #生成,可缩写为hexo g
hexo server #启动服务,可缩写为hexo s

首先是generate通过它就可以自动的为你生成博客的所有页面。每次更新完博客或者改变参数设置之后都需要重新生成一次页面。
然后就是server启动本地的服务。
然后就可以访问http://0.0.0.0:4000 来看看效果了。以后也可以用这种方法来预览自己的博客。

##0x03
既然已经在本地可以看到页面了,那么剩下的就是将他部署到gitcafe上面去了。(首先,你要有个gitcafe账号

###设置gitcafe
首先在gitcafe中新建一个项目。如图:
img

注意项目的名字要与自己账号的用户名相同。

###添加SSH公钥
然后要为gitcafe添加一个SSH的公钥。

####1.生成公钥
首先要在你的主目录下要有一个.ssh的目录。如果没有则手动创建

mkdir ~/.ssh

然后生成一个新的RSA公钥

ssh-keygen -t rsa -C “你的邮箱@xxx.com” -f ~/.ssh/gitcafe

生成公钥时会提示输入密码一个,可以为空,如果不为空,则每次更新博客时会提示输入

现在在你的.ssh目录下就已经有了下面两个文件

gitcafe
gitcafe.pub

然后需要在.ssh目录下生成一个配置文件,我用的是nano,vi或者任何编辑器都可以

nano ~/.ssh/config

在其中写入如下的内容

Host gitcafe.com www.gitcafe.com
IdentityFile ~/.ssh/gitcafe

####2.添加SSH公钥
进入账户设置 –> SSH公钥管理 –> 添加公钥
img2
把刚才生成的gitcafe.pub中的内容全部复制到公钥框中,名称随意,最后再输入你的用户密码就可以了。

####3.测试是否可以连接gitcafe

ssh -T git@gitcafe.com -i ~/.ssh/gitcafe

用这条命令检测一下是否可以连接。第一次连接前会有一个警告,输入yes确认。然后如果可以看到这一条信息

Hi XXXXX! You’ve successfully authenticated, but GitCafe does not provide shell access.

说明连接成功。

###配置hexo设置

编辑你hexo目录下的hexo_config.yml文件,在文件的最后添加如下的信息

1
2
3
4
deploy:
type: github
repository: git@gitcafe.com:yourname/yourname.git
branch: gitcafe-pages

注意,每个项目后要紧跟一个冒号,然后必须要有一个空格,接着是参数的内容。还有注意后3个参数前要有空格缩进。
然后将youname替换成自己的gitcafe用户名就可以了。

最后一部,部署

hexo deploy #或者使用简写 hexo d

然后你就可以在在http://youname.gitcafe.io 上看到你自己的微博了。

##0x04
如果已经成功的搭建起了你的blog。那么接下来要做的就是找一个漂亮点的模板,写文章以及添加各种插件了。

###添加文章
首先是如何添加新的文章。可以用命令

hexo new “title”

这条命令会在你的hexo目录的source/_post目录下生成一个名为“title”的的markdown文件。只要编辑完成后用hexo g命令就可以自动的为你生成一篇新的文章。
当然你也可以自己创建一个markdown文件再拷贝到source目录下。不过要注意的是hexo使用的markdown文件需要在开头包含这一些内容,如果是hexo n生成,会自动写入上这几项,而且会自动的填上title和data的数值。如果要手动创建,就需要自己写入。

1
2
3
4
5
title: 在gitcafe上部署hexo博客方法介绍
date: 2015-07-29 10:29:07
tags: [hexo,入门]
categories: 不务正业
---

注意,和刚才配置参数的时候一样,冒号后要有空格。
至于markdown的编辑器,可以看各自的爱好。我使用的是haroopad编辑器。

###更换主题
然后是要换一个好看的主题,这个就看自己喜欢了。我用的是Next的主题 –> 传送门在此
作者也在github上写了非常详细的教程,非常实用,即使不使用这个主题,也可以看看作者的教程。

###other
接下来的工作就是给你的博客添加诸如多说的评论系统,谷歌或者百度的网站统计插件。再申请一个七牛来存放你的各种图片等资源。
总之just enjoy it