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

2020-10-22 17:56:11 浏览数 (1)

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
代码语言:javascript复制
hexo generate --deploy
hexo g -d
  • 一些其他的实用功能也很多,例如:根据markdown#标题,自动生成toc目录;可以方便的引入各大评论网站的脚本,只需要账号,第三方存储评论留言不需要维护;引入百度/busuanzi等的访问量统计;文章字数统计和预计阅读时间;等等很多,不一一例举。总之DIY自由度极高,适合开发者

写在最后

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

本文素材来源

ScarSu

- END -

0 人点赞