Hexo + github page + markdown 搭建静态博客

学习是一个渐进式是过程,需要不断摸索前行,凡是遇到好玩都去尝试,然后就会发现更多有趣的东西。

我最开始是想要在github上了解一些开源的项目,然后注册了账号,然后就学习使用Git进行版本控制;因为要写readme,然后了解了markdown,学习了基本语法,然后习惯使用它写文档;通过github page搭建静态博客,学习了一点html,后来发现了hexo,然后使用hexo + github page搭建博客…做了一个简单的脑图:

img

我一开始并不知道想做什么或是如何去做,所有的都是因为好奇,然后不断尝试。这一路走来,也可以说是踩坑无数。接下来就记录一些遇到的坑以及解决办法。

1、关于Git和GitHub

关于Git

Git是目前世界上最先进的分布式版本控制系统(没有之一),是 Linus Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的分布式版本控制系统。据说是Linus 花了两周时间自己用C 写出来的!

在这里也没有必要列举Git的优点和其具体的工作原理。关于Git的使用教程,网上更是一大堆,学习起来并不难,如果有Linux基础的话进更是得心应手。这里推荐两个教程:

第一个是:廖雪峰Git教程

第二个是:RUNOOB网站Git教程 http://www.runoob.com/git/git-tutorial.html

Git学习最开始比较难的是命令记不住,比如git commit,git branch等等,很容易记混乱,需要多加练习才能熟能生巧。

我遇到过的几个问题:

  1. 不熟悉命令,只会 git clone,后来通过耐心学习教程,并通过实践,慢慢的才领悟到Git的精髓。

  2. 不会多人共同开发项目,多人开发也不好亲自实践。比较麻烦,为了体验学习多人开发项目,最后不得已又注册一个github账号(感觉都点傻),做了模拟开发体验。

  3. 也就是因为注册了两个github账号,可我只有一个Git呀,所以要配置环境,生成两份秘钥,使用Git时要区别是哪个账号,这个坑花费了我好长时间才解决的。现在想想还是觉得挺值得的。毕竟以后可能要在不同平台上进行代码托管。

总的来说,学习Git还是比较容易,用到什么学什么是比较快的。最好作一些记录方便下次使用。当然如果有足够的时间和精力,可以根据教程进行系统详细的学习。

说说github

说到 git 就必须要提一下github,作为最大的开源代码托管平台,对于程序猿都应该不陌生。这个平台汇聚了巨大的资源,包括开源项目,以及一些教程,还有很多的awesome summary。

github优点有很多,当然也有一些缺点,在这里不多评说。针对开源托管平台,类似网站有很多,包括gitlab,码云等等,不过这些都可以通过git进行版本控制的。

github使用很简单,就是注册账号,配置信息进行,如果只想体验或看项目的话,甚至不需要学习git。

关于github注意几点:

  1. 注册时起一个有意义的名字,看个人情况吧,尽量避免花里胡哨(程序员的强迫症 >_<)。

  2. 遵守一些相关规定,比如说文明上网,不要发布一些不好的东西。尊重作者和版权信息,虽然是开源,但还是有必要对作品一些信息进行声明,不要抄袭。

  3. 学会写readme,如果要维护一个开源项目,希望可以写出相关的说明文档,还有就是尽量使用English。

关于github如何使用,有官方的指导教程,网上也有很多教程和博客,写的都很详细,在此就不写了,可以参考以下两篇文章:

Github使用教程(一)https://www.cnblogs.com/liuleilei/p/6486665.html

Github 简明教程 http://www.runoob.com/w3cnote/git-guide.html

关于github page

github page 是 github 提供的一个站点平台,可以利用它写文档,搭建博客。而且github本身也有很多主题可以选择,关于这方面也有很多教程。我也不想写具体搭建过程了。

我最开始就是使用github page,说实话不是很方便,而且我也不会HTML,因此我还学了一段时间的HTML5,写了几个简单网页,CSS真的很烦人,后来终于从入门到放弃了。

然有找到了一个很好用的 blog 模板(那时候还不到hexo)。然后就git clone 下来,修改配置。根据网上一步一步的弄,终于搞定了我的 第一个版本 blog ,后来在此基础上修改了很多。但是发现通过这种方式搭建博客越来越不方便,而且觉得那个博客太花里胡哨,最终….我开始使用 Hexo 了。

使用Hexo + github page 搭建博客太方便了,接下来看看如何使用hexo + github page搭建静态博客以及需要主要的问题。

2、使用Hexo + Github page 搭建博客

前面文章已经介绍了有关 github 和 git 的使用说明方法,有讲了自己通过github page搭建静态博客的踩坑经历,现在来说说自己通过Hexo + github page搭建博客遇到的问题。

关于Hexo

Hexo是一个比较简单的站点生成工具,而且它有很多博客主题,生成,发布都是十分方便的,所以也广受大家喜欢,因此也有很多关于hexo搭建博客的教程,它自己也有官方的使用指导说明。

使用Hexo 首先需要安装 node.js 。一开始我不知道这是什么,也不知道怎么使用,没时间且怕麻烦,所以一直没有安装。后来才发现特别简单,根本不麻烦,而且很好用。随便网上一搜就有安装教程,而且对Windows用户也很友好,只需一点基本的命令行命令就行。(经验:管它会不会,先安装,再捣腾)。

选择主题

Hexo有很多主题可以选择,网上参考推荐也有很多,看个人爱好吧。这个可以参考一个知乎的回答:

有哪些好看的 Hexo 主题?

为了避免以后折腾,建议选择一个比较满意的且个性化配置多一点主题,方便自己调整,也省去一些不必要到重复修改。

修改配置

首先需要访问博客主题开源主页,基本上都有详细的使用说明,按照使用步骤操作就行,其中可能会用到一些 js的包,使用npm直接安装就行。配置教程网上有很多,还有许多个性化的配置。我也就不写了,但是我配置时也是参考网上的教程。有两篇比较全面并且不错的教程可以参考:

hexo的next主题个性化教程 https://www.jianshu.com/p/f054333ac9e6

hexo + next主题优化 https://blog.csdn.net/sunshine940326/article/details/69933696

需要说明的是,每个主题的配置是不一样的,但绝大多数时类的。善于使用搜索引擎,不会就搜就行。需要注意的是:边配置边测试,使用hexo server做本地调试,方便查找因为配置错误而出现的问题。

生成创建发布

主要是利用Hexo进行生成创建发布,需要的是熟悉hexo的几条常用命令。

1
2
3
4
hexo new post post-name //创建新文章
hexo server //本地调试
hexo g //生成
hexo d //发布

这里需要注意的发布到github平台或者其他,需要进行配置,主要修改的是根目录下的 _config.yml 配置文件。只要配置OK,其它一切都好办。

遇到的问题

在搭建博客我也遇到很多问题,有很多想法也试着去实现,有些成功了有些失败了。遇到一个需要注意的问题:

  1. 一定要详细阅读hexo主题说明,按照指导进行配置。
  2. 一定要分清楚是Hexo根目录下的 _config.yml 配置文件还是hexo 主题的的 _config.yml 配置文件。
  3. 个性化配置时,遵守一定的规范,修改一些css样式和js时一定符合规范,不要强制更改。
  4. 需要安装插件和资源包时,先查阅说明,如果遇到网络问题可以想想办法。比如使用淘宝镜像cnpm代替npm。

小结一下

其实在使用hexo搭建博客时会遇到一些没有见过的问题,不过通过搜索引擎基本上都能解决,顺便培养一下信息检索能力。关于配置,并不是三言两语就能说清楚,通过一些教程说明,可以详细的了解很多。我自己在搭建博客时遇到的一些问题,大多都解决了,实在解决不了就换个方法尽量避免。

3、介绍Markdown

对于markdown,用两个字形容就是“好用”,写文章方便,语法简单,不需要为排版烦恼。特别是配上 Typora 编辑器,更加顺手,标题段落分明,注释超链接方便,支持代码公式块,可以导入导出。而且现在好多平台都支持markdown了。

现在我已经是比较熟悉markdown在来写markdown使用方法和基本语法意义基本不大。但刚开始学那会儿不太熟悉,还是走了很多弯路。建议还是什么不会查什么,边学边记录。如果要系统的学,推荐官方使用说明:

MarkDown-语法说明 http://www.markdown.cn/

关于写文章

通过hexo + github page 搭建的博客平台,支持的就是Markdown编写的博客文章。如果熟悉markdown,写文章也就没什么讲究。

注意几点:

  1. 分清楚文章层次结构,各级标题含义清楚
  2. 正文内容要求不大,可随意发挥。
  3. 链接使用要规范,包括文字链接,图片链接。
  4. 代码公式引入最好使用块结构。

总的来说,写文章要求不是很多,更需要注重的文章本身的内容。当然需要注意的是图片如果使用URL的话,选择稳定的图床,要不然可能会失效。

总结

本篇大致对使用Git,搭建博客,写文章进行了总结。但多数是一些自己的经历,觉得需要注意的点。没有涉及太多技术层面的东西,一是因为网上有很多,我不见得写的比他们详细;二是好多东西我已经掌握,再来写已经意义不大。所以引用了一些比较好参考链接,方便以后查阅学习。

私以为工具很重要,只要用好工具,效率就会提升,当然能力就会提高,最后也会孰熟能生巧,做更深入的学习探讨。