最近闲着无聊,突发想搞一个自己的博客。于是就有了这个blog。在搭建的过程中也出了许多的问题,不过最后还是搭建完成了。现在我把我搭建的过程记录下来,作为备忘和分享。
首先是我自己机子的环境介绍以及各种组件介绍
我的机子操作系统为ubuntu 14.04。必要的软件为node.js与git。我的博客部署是在gitcafe上,使用的hexo的框架搭建。使用的主题的Next主题的Mist风格。
首先是必要的软件安装工作
首先安装node.js与git。ubuntu下的安装非常的简单,使用apt就可以完成。
sudo apt-get install nodejs
sudo apt-get install git
两条命令解决,当然也可以选择下载源码编译的方法完成。
然后是安装hexo
sudo npm install -g hexo
现在必要的软件就已经下载完成了。
接下来的任务是配置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 来看看效果了。以后也可以用这种方法来预览自己的博客。
既然已经在本地可以看到页面了,那么剩下的就是将他部署到gitcafe上面去了。(首先,你要有个gitcafe账号)
首先在gitcafe中新建一个项目。如图:
注意项目的名字要与自己账号的用户名相同。
然后要为gitcafe添加一个SSH的公钥。
首先要在你的主目录下要有一个.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
进入账户设置 –> SSH公钥管理 –> 添加公钥
把刚才生成的gitcafe.pub中的内容全部复制到公钥框中,名称随意,最后再输入你的用户密码就可以了。
ssh -T [email protected] -i ~/.ssh/gitcafe
用这条命令检测一下是否可以连接。第一次连接前会有一个警告,输入yes确认。然后如果可以看到这一条信息
Hi XXXXX! You’ve successfully authenticated, but GitCafe does not provide shell access.
说明连接成功。
编辑你hexo目录下的hexo_config.yml文件,在文件的最后添加如下的信息
deploy:
type: github
repository: git@gitcafe.com:yourname/yourname.git
branch: gitcafe-pages
注意,每个项目后要紧跟一个冒号,然后必须要有一个空格,接着是参数的内容。还有注意后3个参数前要有空格缩进。
然后将youname替换成自己的gitcafe用户名就可以了。
最后一部,部署
hexo deploy #或者使用简写 hexo d
然后你就可以在在http://youname.gitcafe.io 上看到你自己的微博了。
如果已经成功的搭建起了你的blog。那么接下来要做的就是找一个漂亮点的模板,写文章以及添加各种插件了。
首先是如何添加新的文章。可以用命令
hexo new “title”
这条命令会在你的hexo目录的source/_post目录下生成一个名为“title”的的markdown文件。只要编辑完成后用hexo g
命令就可以自动的为你生成一篇新的文章。
当然你也可以自己创建一个markdown文件再拷贝到source目录下。不过要注意的是hexo使用的markdown文件需要在开头包含这一些内容,如果是hexo n
生成,会自动写入上这几项,而且会自动的填上title和data的数值。如果要手动创建,就需要自己写入。
title: 在gitcafe上部署hexo博客方法介绍
date: 2015-07-29 10:29:07
tags: [hexo,入门]
categories: 不务正业
---
注意,和刚才配置参数的时候一样,冒号后要有空格。
至于markdown的编辑器,可以看各自的爱好。我使用的是haroopad编辑器。
然后是要换一个好看的主题,这个就看自己喜欢了。我用的是Next的主题 –> 传送门在此
作者也在github上写了非常详细的教程,非常实用,即使不使用这个主题,也可以看看作者的教程。
接下来的工作就是给你的博客添加诸如多说的评论系统,谷歌或者百度的网站统计插件。再申请一个七牛来存放你的各种图片等资源。
总之just enjoy it