文章目录
  1. 1. 初衷
  2. 2. 搭建
  3. 3. 完成

初衷

  在学习中,发现对很多东西都是一知半解,知识结构比较混乱,虽然也有在笔记本上记录自己的学习过程,但终究达不到总结的作用。固搭建此博客,意在记录自身的学习过程,与志同道合之人聊聊技术,分享所学心得。

  以前有了解过用wordpress搭建博客,但最近从朋友中了解到用github也可以,于是心血来潮,建成此博客。

  此博客的搭建快速简单,容易上手(对于程序员来说),但其中也遇到一些坑爹问题。希望这篇博客对大家搭建自己的博客和解决遇到的问题会有所帮助。

  下面开始博客搭建之旅吧~~

搭建

博客搭建的原理是用静态页面生成静态博客,使用github pages来搭建,不过github pages只有300M免费空间,所以尽量省着点用吧。但一般生成的html都不会很大,主要是图片占空间。为了节省空间,图片可以使用图床保存然后接网址过来。。
  
准备工作可以参考以下网址:

在上面的链接中,如果你没有购买域名,没有关系,可以直接跳到安装准备软件步骤。首先,你要准备好以下软件(注意安装路径不要有中文字符,安装位置随意):

  • Node.js
  • Git

然后按照教程注册一个github并且配置SSH keys。成功后,如果没有购买域名,忽略将独立域名与 GitHub Pages 的空间绑定这一步以及后面的步骤,因为其实没有什么用处。
接下来可以查看这个链接继续:

前面有些重复的步骤可以不用理,跳到安装hexo这里,用命令行安装,这步需要按照hexo官网上的安装命令来安装,因为有可能更新了安装命令。后续步骤按照这篇博客进行安装即可。
(如果在hexo init这步在git bash中没有反应就在命令行中进入到文件夹位置再输入命令行)

注意:到部署这一步时,根目录下_config.yml文件的最下面deploy的配置应该为

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:xurna/xurna.github.io.git
branch: master

其中每个属性后面都要加一个空格!!!并且type的属性值为gitrepository改为repo,repo的属性值为你刚刚在github所建的**.github.io仓库的SSH地址,复制下来即可。

最后的hexo deploy命令需要在git bash中进行,在执行 hexo deploy 后,如果出现 error deployer not found:github 的错误,解决办法是输入命令npm install hexo-deployer-git --save,然后在部署,问题解决。

tips
hexo现在支持更加简单的命令格式了,比如:

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

这样,博客就部署到网上了,试试在新的网页中打开你刚建立的**.github.io网址,如果页面正常显示,那就大功告成了,恭喜你拥有了属于你的个人博客。

完成

  进行到这步,你的搭建博客之旅算是到了尾声。但是,挑剔的人会觉得博客的主题并不好看,其实还有很多hexo主题的,我用的是jacman主题,在github中搜索“jacman”,找到“wuchong/jacman”就可以查看相关文档。
在git bash中在你的博客文件夹目录下输入:

1
$ git clone https://github.com/wuchong/jacman.git themes/jacman

就可以把主题克隆下来,然后修改配置文件_config.yml:

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: jacman

theme的属性值改为主题的名字jacman

1
language: zh-CN

如果一开始出现繁体字,可以加上语言设置,一般情况下最好设置一下,更多样式修改请查看配置文件。

这样就可以使用

1
hexo new "blog name"

开始建立自己的第一篇博客了,博客语法为markdown语法,这里不详细说了,可以查看文档http://www.markdown.cn/.

建成了个人博客,是不是有点小激动和成就感?

文章目录
  1. 1. 初衷
  2. 2. 搭建
  3. 3. 完成