神刀安全网

如何搭建一个独立博客——简明Github与Hexo教程


前言

买过域名和主机,折腾过wordpress,个人博客也搭建起来了,本来是准备写技术文章,分享,但是折腾那些东西花费了太多的时间,认真写作反而少了。现在决定换成hexo写博客,专注写作分享,少折腾。

本文主要参考cnfeat的《如何搭建一个独立博客——简明Github Pages与Hexo教程》,原文很详细,
还有Zippera的《hexo系列教程》

为什么选择Hexo

hexo是一个基于Node.js的静态博客程序,可以方便的生成静态网页托管在github上。作者是来自台湾的tommy351。作者对hexo只有一句话的介绍:

A fast, simple & powerful blog framework, powered by Node.js.
一个快速、简单并且强大的基于Node.js的博客框架。

我们可以用hexo创建自己的博客,然后托管到github上,也可以绑定自己的域名。

hexo的优势:

  • 简单:平常只需要hexo new,hexo generate,hexo server,hexo deploy四个命令,或者更少只需要hexo ghexo d两个命令。(hexo支持首字母命令)
  • 快:配置方便也容易理解,配置好后,马上就能看到效果。
  • 支持markdown,我觉得这是最大的一个优势了,wordpress上用markdown简直不爽。
  • 文章全都本地有保存,方便管理啊。(我一般本地写文章,然后利用网盘自动同步,还发布到博客上,这样再也不怕文章丢失了)
  • 其他还有支持Octopress扩展,兼容主流三大平台Win、Linux和Mac等等

为什么选择GitHub Pages?

GitHub Pages本用于介绍托管在GitHub的项目,不过,由于他的空间免费稳定,用来做搭建一个博客再好不过了。

github Pages可以被认为是用户编写的、托管在github上的静态网页。

优势:

  1. github pages有300M免费空间,资料自己管理,保存可靠;
  2. 学着用github,享受github的便利,上面有很多大牛,眼界会开阔很多;
  3. 顺便看看github工作原理,最好的团队协作流程;
  4. github是趋势;
  5. 就算github被墙了,我可以搬到国内的gitcafe中去。

本地博客的搭建

安装Git

Windows下直接下载安装就行,安装好后,会发现开始菜单里有Git Bash,这就表明成功了。
Linux(我只用过Ubuntu,以Ubuntu说明)下可以下载deb包安装,也可以终端输入

sudo apt-get install git

Mac土豪用户请看官方说明!

安装Node.js

安装方法同安装git差不多。
注意:Windows安装完后还需要添加环境变量,使npm命令生效。在环境变量的Path里添加npm的路径。比如我的是;C:/Program Files/nodejs/node_modules/npm,分号不能少。

安装hexo

上面两部成功后,打开Git Bash,输入

npm install -g hexo

安装hexo。(如果出现错误,可能是环境变量没有设置好,最好重启下,或者网上搜索解决办法)

hexo安装完成后,在你喜欢的文件夹里新建一个hexo文件夹(比如D:/hexo),然后在文件夹内点击鼠标右键,选择Git Bash,并且输入如下命令

hexo init

hexo就会自动在目标文件夹建立它所需要的文件了。
然后继续输入

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

安装需要的一下依赖包。

本地查看效果

经过上面三部,一个本地的博客已经建成功了,可以先来一睹为快。
继续输入如下命令

hexo g
hexo s

然后我们看到提示:

如何搭建一个独立博客——简明Github与Hexo教程

提示

这时在浏览器输入http://localhost:4000/,就能看到自己的博客了。
要结束预览只需要在Git Bash里同时按下ctrl+C

如果没有问题,本地的博客已经建成功了,注意,只是本地的。如果想其他人也能看到,就需要部署到github上了。(部署到其他地方也可以,但github最方便)

博客部署到Github

注册账号

访问Guthub官网:http://www.github.com ,输入用户名、邮箱和密码就行,很简单

配置SSH keys

觉得麻烦的这一步可以不弄,但是不弄的话,没有都要输入用户名和密码更麻烦。
这有个官方教程不过是英文的。

第一步:生成新的SSH keys

命令行输入下面的内容,并回车:

ssh-keygen -t rsa -C “your_email@example.com”

your_email@example.com换成你刚刚注册github时的邮箱。
然后有提示:

Generating public/private rsa key pair.
Enter file in which to save the key (/your_home_path/.ssh/id_rsa):

直接按回车键就好,然后系统要你输入密码:

Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

这个密码是在你提交项目时使用,为空的话就不用输入,为了方便我就没输密码,直接按了回车键。

最后会看到这样的界面,这就表明设置成功了:

Your identification has been saved in /your_home_path/.ssh/id_rsa.
Your public key has been saved in /your_home_path/.ssh/id_rsa.pub.
The key fingerprint is: 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

添加SSH key到Github上

用文本编辑器打开~/.ssh/id_rsa.pub(Windows下是C:/Documents and Settings/Administrator.ssh/id_rsa.pub),这就是刚刚生成的秘钥,这是隐藏文件,你需要设置显示隐藏文件才能看到,然后全选里面的内容并复制。

登陆github网站:

  1. 点击右上角的Account Settings—->SSH Public keys —-> add another public keys
  2. 把刚刚复制的内容粘贴到key里,title随便填,比如我加的是Ubuntu系统的,就写个Ubuntu。
    如何搭建一个独立博客——简明Github与Hexo教程

  3. 点击add SSH,这就完成了。
测试是否添加成功

命令行输入(不要修改下面的内容):

ssh -T git@github.com

你可能看到警告(也可能没有):

The authenticity of host ‘github.com (207.97.227.239)’ can’t be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

这个不用担心,直接输入yes就好,然后会看到:

Hi username! You’ve successfully authenticated, but GitHub does not provide shell access.

出现这就表明真的成功了。

设置用户信息

现在你已经可以通过SSH链接到GitHub了,还有一些个人信息需要完善的。

Git会根据用户的名字和邮箱来记录提交。GitHub也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字和邮箱是github注册时使用的那个。

git config –global user.name “your user_name”
git config –global user.email “your_email@example.com”

SSH key配置成功

到这Github本地全部配置完成了,如果有问题,请重新配置一次,或者google问题,解决就好了。

使用Github Pages建立博客

与GitHub建立好链接之后,就可以方便的使用它提供的Pages服务,GitHub Pages分两种,一种是你的GitHub用户名建立的username.github.io这样的用户&组织页(站),另一种是依附项目的pages。

想建立个人博客是用的第一种,形如user_name.github.io这样的可访问的站,每个用户名下面只能建立一个。

创建repository

在自己github主页右下角,创建一个新的repository。比如我的Github账号是wanyne,那么我应该创建的repository名字应该是[wanyne.github.io](wanyne.github.io)

如何搭建一个独立博客——简明Github与Hexo教程

然后填写项目信息:

project name:wanyne.github.io
description: The Spiritual Journey !

注:Github Pages的Repository名字是特定的,比如我Github账号是wanyne,那么我Github Pages Repository名字就是wanyne.github.io。description可以随意写,写你对这个博客的一句话介绍就好。

配置本地文件,链接github

打开之前新建的hexo文件夹,里面有一个_config.yml的文件,用文本编辑器打开,推荐用sublime text。然后编辑,在最下面deploy那修改为:

deploy:
type: github
repository: git@github.com:Wanyne/wanyne.github.io.git
branch: master

除了将两个wanyne改成你自己的github用户名,其他全部不要改,然后保存。

部署完成

在命令行输入:

hexo g
hexo d

如果最后出现:

[info] Deploy done: github

就说明部署成功,用浏览器打开wanyne.github.io(将wanyne改成自己的),就能看见自己的博客了,别人也可以访问了。

写博客文章

还是在hexo文件夹,右键打开Git Bash,输入(将name换成你要发表的文章的标题)

hexo new “name”

然后在source/_posts/里就能看到一个name.md的文件了,现在就可以写你想写的任何内容了。
也可以直接在source/_posts/里直接新建一个name.md的文件,注意开头要加入下面的内容

title: Test
date: 2014-12-19 23:37:07

tags:

发表文章

文章写好后保存,命令行输入:

hexo g
hexo d

就和之前一样,成功后马上就能你的博客上看到了。快去试试吧!
今后发布文章只有写个md文档,然后hexo ghexo d就好了,是不是很方便。

后记

这只是写博客的第一步,正在想要打造自己的博客,还需要自定义博客,还需要学会使用markdown写作等等,这些都挺有乐趣,感兴趣的可以多看看。最重要的是要坚持写,坚持分享!

推荐几个链接,都是精华的东西,值得一看。

  1. 献给写作者的 Markdown 新手指南
  2. 用 Markdown 写作用什么文本编辑器?
  3. 好用的免费图床七牛
  4. 为什么你应该(从现在开始就)写博客
  5. 如何搭建一个独立博客——简明Github Pages与Hexo教程
  6. hexo系列教程

微信公众号:lyishaou

如何搭建一个独立博客——简明Github与Hexo教程

微信公众号

转载本站任何文章请注明:转载至神刀安全网,谢谢神刀安全网 » 如何搭建一个独立博客——简明Github与Hexo教程

分享到:更多 ()

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址