如何写出一篇好博客
目录
规整优于杂乱,归类优于混沌。对于一名合格的技术人来说,写好博客是一项重要的技能,今天我就来谈谈我对于怎么写出一篇好博客的思想。首先,我的理论依据来自于亮点,正如文章开头所说,第一是:规范,第二是:分类。
不同的博客有不同的内容,而不同的内容又有不同的特点,所以针对不同的内容来构建不同的结构更利于博客的阅读。根绝我的目前的经验,我暂时将博客内容分为三类:(1)概念介绍类;(2)问题解决类;(3)编码技巧类。当然还有其他的各种类别,包括心得以及工具使用等等,但是我个人更倾向与将这些内容记录在ONENOTE里,所以就不再这里做介绍。
概念介绍类文章的核心在于概念以及概念之间关系的介绍。概念可大可小,大概念下可包涵多个小概念,小概念下又可包涵更小的概念,这个依据于抽象的层次决定,用一种数据结构来表示这种的概念的层级关系的话就是树。
在概念介绍类的文章里应该要注意的一点是,尽量避免介绍哪些不可分的孤立概念,也是就是那些叶子概念。但是我们经常会碰到这种单个的概念,我的做法是先将学习的孤立不可分的概念记录的ONENOTE里,等到碰到同一范畴下的孤立概念多了以后,将这一级的概念抽象到更上一的概念,对这一高阶概念进行学习,分析,了解其子概念之间的联系,进而形成一篇博客。总的来说就是,概念介绍类的博客介绍的概念尽量是有相互关联的子概念的。下面是我给出的此类文章的结构。
A)目录
B)简介(概念,目的,用途;分条目罗列清楚)
C)概念1+代码演示
。。。
E)概念N+代码演示
F)[概念之间的关系]
G)总结
H)参考文献
问题解决类文章的核心在于记录问题核心所在以及问题解决的方法。在写这类文章的时候,切不可直接贴满篇代码,一定要先对问题有一完整的描述,包括问题发生的前提,问题导致的结果以及问题的核心原因。对于解决过程的描述,首先应该理清解决思路,其次才是对于过程的细化描述,在描述的过程中尽量使用图片或者代码来表述,避免大段大段的文字,代码部分应该核心代码,保持精简而且做好注释,这样会使文章更加直观。下面是我给出的此类文章的结构。
A)目录
B)问题描述
C)核心原因
D)解决步骤
E)总结
F)参考文献
此处的编码技巧类指的是比传统方法效果更好的新的实现方式。其核心在于对于新实现方式的介绍以及新老方式优缺点的比较。而且应该先交代应用场景,其次才是对于老方法和新方法的介绍。这类文章应该着重解决过程的展现,实现过程要清晰明了。下面是我给出的此类文章的结构。
A)目录
B)应用场景
C)传统解决方案
D)存在问题
E)新的解决方案
F)优缺点
G)参考文献
(1)文章避免太长;
(2)不要带入个人情感;
(3)使用书面用于,避免口水话;
(4)排版清晰;
作为一名技术人,写好博客不仅能加深我们对于知识的理解,更能扩大我们自身的技术影响力,在以后的工作路上能够成为我们自己的一张闪亮的名片。另外,博客的种类还有很多,这里只是说了其中的几种,而且好博客的标准也各有不同,但是唯一的共同点就是内容一定要清晰明了。本文的观点仅仅是我通过自身的经验,总结提炼而成,希望能对大家有所帮助。