Happy3w

如何写技术博客blog/技术文章

2017.01.06
转眼写blog一年了,虽然断断续续,但是累计也有100多篇,主要都是技术类博文。 最近一位经验丰富的IT developer说不知道如何写,也不知道写什么。觉得特别不理解,作为一名在IT界战斗这么多年的developer,TA看过的技术blog/文章堆积如山,遇到的问题、解过的问题也能汇聚成河,更何况还奔走在技术的前线。这样的人不写blog简直太浪费了,要是能记录下TA趟过的那些坑,不知能挽救多少夜猫子,节约多少生命投入。TA居然说不会写,Why,到底是不会写还是不愿意写?!TA说真的不会写。好吧,到底是什么问题呢? 1、想写得简单些(因为看过很多的文章长篇大论写得很细,很多内容对自己没用,都不想看),但是自己写完又觉得内容太少,总感觉文章没结束。 2、想写详细一些,分支又很多,写不清楚。 其实,作为一名技术人写技术Blog比写散文、小说之类的好写多了,经历越多、经验越丰富越容易写。如果不是,就很难写。不像小说、散文有感而发、灵光乍现,可能就出来一个非常好的作品。写技术Blog必须要有技术经历,最好能亲自尝试,不然,就不要写了,害人害己。 下面乐3巫根据自己一年来的体验总结一下写技术博文/文章的几个要点: 1、前提条件 怀揣一颗分享的心。 其实,任何技术人员都可以写出自己的技术Blog,因为你遇到的问题,别人也可能遇到,你的分享随时可能给TA带来一些帮助。 2、写什么 一定要写自己熟知的领域,不要写听来的东西。下面几类是常写的: 1)技术问题/问答类 比如工作中遇到的问题,将问题的解决过程和解决方案写下来,以供读者借鉴。 2)技术介绍 向读者介绍一项你了解的技术,以便读者快速了解或掌握这项技术。 3)技术体验 这个可以是对技术介绍的展开,通过实操案例帮助读者了解和掌握技术。或者是展示你最近研究或体验的新技术(新技术是相对的,只要你第一次接触的,或者其它你认为有意思的都可以)。 3、怎么写 1)问答类 这个好写,问题描述清楚,解决方案描述清楚就行。如: 问:wordpress怎么添加超链接? 答:在文本编辑框工具栏-〉点link->输入url、超链接文本。如图所示…… 然后可以再配个图。 2)技术介绍/技术体验 这些技术博客其实是向人们提供一个解决方案,所以主要需向读者描述清楚如下几个问题: 1)Why do(为什么用这项技术) 这项技术能解决什么问题,给了人们什么好处。人们不会无缘无故看一篇技术blog,这不是娱乐新闻,看技术blog时,肯定是带着问题来的。只有能解决问题,才会继续往下看。 2)What(这项技术是什么?) 这项技术有哪些特点,基本原理是什么,可简要介绍,也可以详细介绍,取决于作者自己。 3)How to do (如何做) 这部分内容是为了带领读者进行实际操作,所以需一步步图文并茂地详细介绍。这部分内容可能比较多,可切成若干篇blog有浅入深分开介绍。但是保证每篇文章解决一个完整的问题而不是问题的一部分,也可在文内通过提供超链接来保证完整性。