【技术向】高可定 低维护の博客搭建指南

Markdown赛高

d=====(￣▽￣*)b

正文共：2331 字 8 图

预计阅读时间： 6 分钟

为什么要有博客

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

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

• 从技术角度考虑，技术的提升依赖于专业知识的学习以及实际经验的积累，而人的大脑需要不断地进行重复记忆，才能将这些知识经验留在自己的知识库里。因此，无论是学习新知识还是通过实践得到的经验，有了即时的输出记录，才便于复盘与巩固。
• 在实际工作中，当我们面临复杂大型的项目，和其中大量的代码时，如果只根据个人喜好而不根据代码规范去开发，写完后不留存开发文档以及接口文档，必然给项目的维护带来更高的代价，给团队中的其他开发者带来困扰。因此，代码规范和开发文档的输出也相当必要。

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

• 例如IT圈出名的阮一峰，张鑫旭，stormzhang(这位已经不再分享技术了)等等大佬，他们有今天这种影响力的一个重要因素就是输出分享；
• 我也曾不止一次吸取前辈的经验以及建议，前端圈的小爝大佬在知乎的某个回答当中提到过“长期坚持技术输出和总结分享”在找工作面试中是一个亮点和加分项；
• “前端桃园”公号的运营者桃翁也十分提倡坚持输出，他在他星球小圈子中给我们分享过他自己 因为坚持输出提升了影响力 而多次收到阿里面试邀请的经历。

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

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

如何选择博客

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

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

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

作为一个博客，我最重视的有两个方面：

• 可自定义，可个性化。

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

• 高效转化。

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

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

Markdown是一种轻量级的「标记语言」，通常为程序员群体所用，目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。 非技术类笔记用户，千万不要被「标记」、「语言」吓到，Markdown的语法十分简单，常用的标记符号不超过十个，用于日常写作记录绰绰有余，不到半小时就能完全掌握。 就是这十个不到的标记符号，却能让人优雅地沉浸式记录，专注内容而不是纠结排版，达到「心中无尘，码字入神」的境界。

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

• 通过Hexo，你可以高定制化的DIY自己的博客
• 搭建后，只需要将md文档源文件丢进指定目录，输一个命令，hexo就可以自动生成页面
• 生成静态文件后，可以无需服务器+域名，直接将静态文件丢在GithubPages上即可

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

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

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

主题默认样式如图：

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

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

配置:

post.pug模板代码:

实现效果：

• 其他的各种折腾，其实原理都类似，找到对应的pug模板代码进行增删改即可，包括样式、脚本、内容。（注：pug，即前jade，前端的一种模板引擎，api参见https://pugjs.org/api/getting-started.html）
• 调试的过程也很方便，使用hexo server命令可以启动本地环境，并且会自动watch你的更改（包括配置+scss+pug模板），并自动重新生成，这个过程也很快，大概一口茶不到的功夫。
• 搭建完成后，日常使用只需要将md源文件放入source/_post文件夹下，再运行一个简单的命令，即可自动生成+部署到git

hexo generate --deploy
hexo g -d

• 一些其他的实用功能也很多，例如：根据markdown#标题，自动生成toc目录；可以方便的引入各大评论网站的脚本，只需要账号，第三方存储评论留言不需要维护；引入百度/busuanzi等的访问量统计；文章字数统计和预计阅读时间；等等很多，不一一例举。总之DIY自由度极高，适合开发者

写在最后

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

本文素材来源

ScarSu

- END -