为什么要有博客

博客之于程序员意义重大,因为,输出是一个程序员的基本素养和技能,开源分享是科学技术发展和人类社会进步的重要美德和推动力,而博客正是输出分享的重要途径之一。

为什么输出分享对程序员来说十分重要,我有以下几点看法。

如果你还不相信,坚持输出给程序员带来好处的例子很多,我随意举几个。

还有很多例子,不一一例举,分享本文的原因也就写到这,不再赘述。

(当然输出分享的途径很多,本文以介绍博客为目的,如果选择其他途径可以忽略下文)

如何选择博客

现在网络上有各式各样的博客,有基于第三方的平台(如博客园、csdn 等)

也有可供个人搭建的工具(如 Hexo、Ghost、wordpress、jekyll 等)

自建博客的选择丰富多彩,选择一个最适合自己的最重要。

作为一个博客,我最重视的有两个方面:

  1. 可自定义,可个性化。

因为每个人追求的博客风格不同,想要展示的内容和格式也有所不同。

  1. 高效转化。

我指的转化,是你的输出原文档 到 博客文本的转化,这一转化的过程对于想要存档原文,或不习惯于博客编辑器,不习惯于博客网页格式的人之分重要。

我推崇用 markdown 来写笔记,因为 markdown 足够简约优雅,兼容性也十分强,

Markdown 是一种轻量级的「标记语言」,通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。

非技术类笔记用户,千万不要被「标记」、「语言」吓到,Markdown 的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。

就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

因此今天推荐的博客搭建工具,就是Hexo.

Hexo 博客搭建 & DIY & 使用指南

具体 api 请看 hexo 官网文档,下面只分享搭建+DIY+使用流程

  1. 安装 node 和 git
  2. npm 安装 hexo 和相关依赖
  3. 根据 hexo 命令 初始化 博客文件夹,在 config 中添加博客相关信息和配置
  4. 在 hexo 官网/themes 选择相关主题,或使用默认主题,以我使用的简约主题maupassant为例

主题默认样式如图:

maupassant

  1. 除了默认的首页/归档等 tab 页,可以在配置中添加更多 tab 页,tab 的内容也可以从 markdown 渲染。

例如添加/Demo 分页,可以再配置文件中新增一项 tab 配置,在 source 文件夹下添加/demo/index.md 即可,可以在 post.pug 模板中更改 tab 分页渲染 index.md 的方式。

配置:

hexo1

post.pug 模板代码:

hexo2

实现效果:

hexo3

  1. 其他的各种折腾,其实原理都类似,找到对应的 pug 模板代码进行增删改即可,包括样式、脚本、内容。(注:pug,即前 jade,前端的一种模板引擎,api 参见文档
  2. 调试的过程也很方便,使用 hexo server 命令可以启动本地环境,并且会自动 watch 你的更改(包括配置+scss+pug 模板),并自动重新生成,这个过程也很快,大概一口茶不到的功夫。
  3. 搭建完成后,日常使用只需要将 md 源文件放入 source/_post 文件夹下,再运行一个简单的命令,即可自动生成+部署到 git
1
2
hexo generate --deploy
hexo g -d
  1. 一些其他的实用功能也很多,例如:根据 markdown#标题,自动生成 toc 目录;可以方便的引入各大评论网站的脚本,只需要账号,第三方存储评论留言不需要维护;引入百度/busuanzi 等的访问量统计;文章字数统计和预计阅读时间;等等很多,不一一例举。总之 DIY 自由度极高,适合开发者

写在最后

最近有一些感悟,以技术为目标的人,不要浮躁,莫逞他人嘴上快,莫争浮世虚功名,心无旁骛,沉下心来钻研技术就好。