如何搭建github+hexo博客-转

一、前言

其实早在这以前我就一直想过写博客,但因为种种缘由一直没有去学习这方面的知识,最近半个月(从开始动手到搭建好)一直陆陆续续的在着手这方面的工做。从开始到搭建完成的过程当中遇到了不少困难，由于在这以前对Github一点了解都没有致使满头雾水,不断的跳进一个又一个坑,甚至想过放弃.但最后结果想必都知道了。在写如何搭建以前我以为咱们应该先从头开始了解。

那么我为何要创建本身的博客？——引自:为何你要写博客？—陈素封

1.“提升将事情讲清楚的能力”.

在写博客以前你须要花更多的时间来表达出你的想法，表达你想法以前你得先对你要表达的东西充分理解并理清思路和逻辑。

不少东西你觉得懂了，但当你在写下来的时候，你就以为无从下手了。

2.分享带来的连锁反应

“经过分享，你得到了直接而快速的回报，你最终或许会发现你已将版权和“保留全部权利”抛诸脑后。新的经济学准则是：参与你做品的人越多，回报越高。在分享主义里，若是你愿意你能够保留全部权，可是我乐于分享。” by 毛向辉 《分享主义：一场思惟革命》

3.记录成长

咱们每一个人都应该有这样的经历:隔了好久咱们回头看看之前的本身会发现特别傻x,但正是由于这些傻x的岁月让咱们不断成长,你在成长的过程当中不断的修正本身的错误。

4.探索未知的世界

世界不止是你的家，你的公司，你的朋友圈，你应该去发现一个更大的世界，经过写博客，你会知道世界上还有不少人像你同样在写博客，这些人和知识正在世界的某个角落在等着你。

5.帮助更多想要获取帮助的人

这点我相信你们由为感触,在你探索一个未知的知识领域的时候,每每被撞的一鼻子灰.幸运的人很快就能找到一个“师傅”或一篇很好的文章,但大多数每每在找“教程”的过程当中就已经放弃了.由于他们没可以找到恰好理解的文章.

1、开始搭建Github Pages

参考:傻瓜均可以利用github pages建博客
参考:手把手教你使用Hexo + Github Pages搭建我的独立博客
能够选择阅读完以上两篇教程后倒回来看不懂的地方.

1.使用前了解Github

GitHub是一个共享虚拟主机服务，用于存放使用Git版本控制的软件代码和内容项目(引自维基百科）

2.为何选择Github?

github有一个颇有爱的项目，叫作github pages，这个项目是给开发者创建一个私人页面，上面用来分享新颖的想法和本身写的代码.

3.注册属于你本身的Github帐号

首先进入Github站点,而后进行注册(此处不作详细说明可自行阅读github教程：[1]注册github)

注册完毕后你就拥有了本身的代码仓库了.

4.建立仓库

在Github首页右上角头像左侧加号点选择 New repositor(新存储库)或点击这里进行建立一个仓库.

5.开启Github Pages

进入设置

找到这一块

当你的仓库名为：用户名.github.io 以后默认开启Github Pages

如今随便选择一个主题,选择上图的 Choose a theme 以后会跳转到下面这个页面

设置完毕后你就能够经过 username.github.io(username为你的用户名访问你的博客了)

6.下载Github 客户端

根据本身的系统自行选择下载安装

点击前往Github下载

下载安装好以后登录你的github.

从你的仓库添加到本地

接下来就须要搭建Hexo了

2、Hexo

要使用Hexo,须要安装Nodejs以及Git

安装Node.js

下载Node.js
参考:安装Node.js

安装Git

下载Git

一路点击Next就好了.

安装Hexo

在你须要安装Hexo的目录下(新建一个文件夹)右键选择 Git Bash

npm install hexo-cli -g   
hexo init #初始化网站   
npm install   
hexo g #生成或 hexo generate   
hexo s #启动本地服务器 或者 hexo server,这一步以后就能够经过http://localhost:4000  查看了

详细命令请参考Hexo文档

这里介绍一下怎么建立一篇文章

hexo new "文章名" #新建文章
hexo new page "页面名" #新建页面

经常使用简写

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

新建一篇文章后就能够预览了,在hexo new以后执行一次生成hexo g再执行hexo s启动本地服务器,若是以前还在hexo s 按Ctrl + C 结束.

添加主题

安装主题(yilia主题):

hexo clean
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

启动主题

找到目录下的_config.yml 文件,打开找到 theme：属性并设置为yilia

更新主题

cd themes/yilia
git pull
hexo g
hexo s

此时刷新http://localhost:4000/页面就能看到新的主题了.

使用Hexo deploy部署到github

仍是编辑根目录下_config.yml文件

deploy:
    type: git
    repo: git@github.com:cczeng/cczeng.github.io.git  #这里的网址填你本身的
    branch: master

此处感谢有网友帮忙指出错误,原文自第二行起因为疏忽没有缩进

具体配置可参考个人博客备份

保存后须要提早安装一个扩展：

npm install hexo-deployer-git --save

接下来就是将Hexo部署到咱们的Github仓库上

3、部署到Github

1.检查SSH keys的设置

如下命令均是在Git bash里输入

cd ~/.ssh
ls
#此时会显示一些文件
mkdir key_backup
cp id_rsa* key_backup
rm id_rsa*  
#以上三步为备份和移除原来的SSH key设置
ssh-keygen -t rsa -C "邮件地址@youremail.com" #生成新的key文件,邮箱地址填你的Github地址
#Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车就好>
#接下来会让你输入密码

以后就能够看到成功的界面。

2.添加SSH Key到Github

进入github首页

添加SSH Key。

找到 系统当前用户目录下(开启查看隐藏文件) C:\Users\用户名\ .ssh id_rsa.pub文件以文本方式打开。打开以后所有复制到key中

到了这就能够测试一下是否成功了:

ssh -T git@github.com
#以后会要你输入yes/no,输入yes就行了。

设置你的帐号信息:

git config --global user.name "你的名字"     #真实名字不是github用户名
git config --global user.email "邮箱@邮箱.com"    #github邮箱

3.部署到github

hexo d

这时再刷新 username.github.io 就能够看到你的博客了。

到了这你觉得就结束了吗？没有，还有坑没有给大家填好。

4、最后的填坑

1. 不知道怎么修改yilia主题?(修改themes/yilia/_config.yml)请参考一个简洁优雅的hexo主题
2. Hexo主题配置(根目录_config.yml文件)
3. 电脑重装了系统/多台电脑写博客？那就赶忙戳这里使用hexo，若是换了电脑怎么更新博客？
4. 不知道如何编写Markdown语法？Markdown——入门指南
5. 想要给网站添加图片？请把图片放入根目录 source\ 下创建一个文件夹，当你执行hexo g的时候此文件夹自动生成到public中。

最后

可能有部分细节疏漏，请参考：
全文参考:傻瓜均可以利用github pages建博客
全文参考:手把手教你使用Hexo + Github Pages搭建我的独立博客