转载请注明出处:http://blog.csdn.net/My_TrueLove/article/details/72895870
访问 ruicb.com,一键抵达我的博客!
一篇让人看了就懂的技术博客,我们不能因为其涉及的知识点简单就说它不好;
反过来,一篇语无伦次、不知所云的技术博客,我们不能因为其阐述的知识点高级反而觉得好。
所以,一篇好的技术博客,何谓 “好”? 好或坏,与讲解的知识点深浅无关,而是能否将一个知识点阐述清楚。
毕业后坚持写博客也快一年了,笔者虽技术能力一般,但一直在用心分享有关初级技术、职场或生活的感悟。
这期间,许多身边的朋友、或素不相识的读者,都说我写文章的思路好,知识点阐述的特别清晰,总是循序渐进带动读者思考,进而理解知识点。
你可能会觉得我语文好,可我想说高考语文都 TM 走题的人,语文好?真不是这样,事实上写技术文章,不需要华丽的辞藻,有话好好说就行,非搞的文绉绉的才让读者别扭呢。
那到底如何写好一篇技术博客?今天我毛遂自荐,与大家分享我的一些心得,希望能给你一些参考,同时也欢迎你在文末留下你的看法,我们一起交流。
第一步 选题
一般我的选题都来自于:
-
工作上的知识点;
-
别人提问,我不懂的我会主动去汲取;
-
自己主动想了解的知识点;
-
没事胡思乱想灵感突现…
这里的选题,小到可以是一个简单的知识点,大到可以是一系列文章,完全取决于我们对知识点的理解程度,理解了就可以尝试写下来与他人分享,分享过程中我们会对该知识点有进一步的理解。
在这里,千万不要犯眼高手低的陋习,觉得某个知识点简单没什么好写的,那是因为没深入了解。
所以,选题并不难,都来自于工作、生活的方方面面,只要我们用心留意,就不至于被困在第一步。
第二步 梳理和再学习
确定了选题,接下来不是立马下笔写,也不是着手思考怎么写,而是 再学习。
换言之,就是将已掌握的知识点梳理一遍。
梳理的过程中,我们肯定会产生一些新的疑问,如果这些疑问不通过学习解决掉,而是在写博客时避开不谈,那么读者读了我们的文章,肯定会产生一样的疑问,就无法通过我们的文章完全弄懂这个知识点。这样,即使我们阐述的知识点再高深,也不能被定义为一篇好的博客。
所以,我们需要再学习,去解决自己的疑问。学到什么程度呢?不说自己最后完全懂得原理、精通这块或者完全掌握(可以的话当然最好了),最起码要做到能让大多数读者觉得学到了,并且能够应对实际工作需求。
这一阶段是学习的过程,是对自我认知的检索和提升,每个人都应该有自己的学习和思考的方式,就不再展开讲了。
第三步 下笔写作
能做到这一步,开始下笔写作的人,原因无外乎有二:
-
喜欢记录,防止自己后期遗忘;
-
具备热爱与他人分享的精神;
二者本身不冲突,记录的同时,与大家分享。如果我们只是备忘,不与人分享,也无可厚非。只是这么做的话,不知不觉我们对文章的质量要求就低了,因为不需要对读者负责,同时也没有读者与我们交流,指正我们。
有了开始的动力,那就正式写作吧。
在我看来,写作的过程,其实就是自己与自己对话的过程,我们应该不断追问自己:
-
这个知识点确定说清楚了吗?
-
如何带动读者更好的思考?
-
这块的是不是可以阐述得更精简一些?
-
......
只有在不断的追问中,才会有意识调整自己的写作思路,争取将知识点阐述的更清晰,并努力带动读者去思考、循序渐进,这样我们的文章就耐读了。
然而,说起来简单的事情,当我们真正开始动手写的时候,突然发现无论写什么,都与自己的知识储备、文笔、写作风格、写作思路脱不开关系,而这些是需要在长年累月的写作中去锤炼、体会的。怎么办?
要我说没必要担心,尽管动手去写就对了,慢慢的就可以找到感觉。以上说的四点,其实我们已经基本具备了:
-
知识储备:按照我说的方法选题、再学习,知识点肯定没问题了;
-
文笔:小学到高中,作文写了那么多,文笔能差哪去?又不是写散文,要求优美,有话好好说就行了。
-
写作风格:这完全取决于个人了。写技术博客,我推崇写的有故事性、趣味性一点,这样才耐读,毕竟学习技术对于大多数人来说是件很枯燥的事情。
-
写作思路:就是如何把自己的思路,以最清晰的方式全部表达出来。
这四点要说难,就属 “写作思路” 了, 我想有许多人会有这样的痛点:
我想写的有很多,但是总表达不清楚,或者总写不全。
这块我后面有时间会补充一篇,聊聊写作思路,从而让我们能够以最清晰的方式,将想说的全部表达出来。
第四步:打磨
不知不觉已经走完了前三步,一般而言,经过前三步我们已经顺利产出一篇博客了。但是这样还不够完美,此时我们需要打磨一下,通过打磨:
-
修正文中有瑕疵的地方(错词错句,重复啰嗦);
-
调整上下文衔接比较牵强的地方,使得文章更顺畅,经得起推敲;
-
适当的通过加粗、划线等方式突出重点,但记住:过多重点等于没有重点;
-
合理的分段,给与读者视觉和思想上的舒缓,以便更好的思考;
-
别忘了还有排版,尤其是代码。
打磨文章,往小了说,可以让文章更完美、更耐读;往大了说,就是对读者负责。换位思考下,我们拜读别人的文章,结果文中错字、病句百出,上下文因果关系对不上,我们会怎么想?
如果我的文章这样,你作为读者,看后只是说一句 “写的什么玩意儿”,我觉得对我就已经很客气了。
总结
按照上面四步,相信你一定可以写出一篇令自己满意的博客,久而久之,希望大家都能养成写博客的好习惯。
我打个比喻来总结并结束本文:
写文章就好比做一件衣服,别人用好的布料(高深知识点),而我们只有粗布(初中级知识点)。
只要我们用心设计(思考),别出心裁(写作思路),做出来的衣服耐穿(文章质量),后期再处理下线头、边边角角(打磨),就一定会得到别人的认可。
同时,在这过程中我们慢慢有了更多收获,到那时我们也可以用好的布料做衣服。值得庆幸的是,这过程中我们锻炼了自己的技术(写作能力)...
就这样,过了很久......
很久......
很久......
很久......
很久......
喂,醒醒!同事摇了摇你: Bug 改完了吗?咋睡着了,腿还一直抖好像在踩缝纫机,做衣服呢?
扫描下方二维码,关注我的公众号《Android进阶之旅》,及时获取最新文章推送!