登录站点

用户名

密码

如何写好一篇技术博客

已有 35 次阅读  2018-09-14 13:45   标签技术博客 

引子

这篇文章只针对技术博客,从自身以及结合现状论述一个好的技术博客应该是如何的,怎样去写好一篇技术博客。其他的博客不在讨论范围之内。

什么是技术博客

所谓技术博客,当然是以技术为主,一个博客里面九成以上的内容应该是与技术相关的。当然不是说不能分享生活相关的内容,但是我觉得生活方面的内容可以放到微博上,然后在技术博客留个微博链接,那些觉得你博客不错然后想深入了解你的人自然会去关注你的微博。技术博客就应该以技术为主,不应该掺杂太多非技术的因素。

技术博客现状

作为一个程序猿,平常当然离不开google(如果你还没开始脱离百度的话,赶紧去买个vpn翻墙吧)。但是除了google某些异常信息这种特定的信息,想要了解某个方面,比如jvm gc、事务等。大部分都是只告诉你是什么,或者说怎么配置,深入探讨做到深入本质的博客并不多。另外大部分的技术博客只是流于表面,人云亦云,千篇一律,这种技术博客读完又怎么能给别人带去收获呢?更有甚者,对于技术博客的态度极其恶劣,通篇博客错误百出,或者窃取他人的劳动成果为己用且不注明来源。如果人人都是这样,都是这种态度,国内的环境如何好得起来?正是看多了国内技术博客的种种弊端,决心写这样一篇文章来说说从我的角度出发,如何写一篇好的技术博客。

如何写好一个技术博客

其实如何写好一个技术博客就是探讨一个好的技术博客应该由哪些因素构成的,两者之间差别不大。大体上可以从两个方面讨论

内容方面

  • 主题明确:这是最重要的方面。一个好的博客首先要有一个好的博客题目,让人一看就知道这篇博客讲了什么,对自己有没有用处。不应该让读者自己去猜博客讲了什么,技术人员的时间都非常有限,如何在浩如烟海的文章中找到自己喜欢的有用的文章很不容易,这时候如果一个博客题目正好符合心中所想,是否会有一种如释重负的感觉?其实对于每个人都是这样,都希望快速的找到符合自己需求的文章,为了自己也为了他人,一个好的博客题目都是很重要的。
    那什么是好的博客题目?一个好的博客题目不要太宽泛,越窄越好。比如spring浅析这种题目就不是很好,会让人觉得不知所云,毕竟spring是一个很大的话题,但是spring配置浅析就会让人很明确的知道这是针对spring配置方面的,就是一个不错的题目。

  • 条理清晰:所谓条理,就是文章整体要讲的几大部分。诗经中有赋比兴手法,现代也有针对问题的七何分析法,或者更加简单的提出问题分析问题解决问题。这些都有助于确定一篇文章的结构,当然,如果你可以使用比如xmind之类的思维工具协助分析,那么也会有事半功倍的效果。如果文章很长,生成导航目录也是很有必要的。

  • 层次分明:这一条看似跟条理清晰有所重复,但是各有侧重点。条理是文章的整体结构,而层次则是文章内容上下彼此的联系。所谓层次感,就是文章的行文要符合人正常的逻辑思维,而不能跨度太大。行文之间应该有所联系,层层展开,娓娓道来,让人看完有种原来如此的感觉,而不是如坠雾里。文章层次感是行文中最难的部分,需要不断的去练习,阅读相关的文章,千锤百炼,才能达到下笔神助的效果。

  • 注意事项:当然除了必要的因素还有很多行文需要注意的地方。
    1.与主题无关的尽量少出现。诸如表情包、吐槽点等适当出现可以,但是太多肯定是不合适的。当然如果是生活文章另当别论。
    2.行文力求精简,废话少说。要有最少的语言表达出想要表达的内容
    3.切忌引用未求证的论据,除非论据来源值得相信(你也可以注明来源,错了也不是你的锅→_→)。
    4.切忌过长。太长的文章会让然感到乏味,即使读完了可能也收获不了多少。主题太大时可以写成系列文章,每篇只针对一个重点讲解。

行文风格

每个人的行文风格都各不相同,有的偏向朴实,有的偏向诙谐。这里不是统一每个人的行文风格,而只是对行文中应该注意的一些共同的地方总结。

  • 谦虚:这是行文中最重要的一点。尚书·大禹谟中早有满招损谦受益一说。每个人不可能了解每个技术的方方面面,在行文中要持有谦虚的态度,对评论中的中肯意见虚心接受。
  • 求真:没有调查就没有发言权。做技术要认真,一个技术自己没有了解过不要妄下论断。talking something you don't know is stupid.对自己没有证实的结论、论据要慎重,不要只会夸夸其谈。
  • 诙谐:技术博客不是论文。通篇的严禁难免让人觉得无趣,技术博客行文中带有一点诙谐,或者恰当的类比,不仅让人会心一笑,也会让你把要讲的东西讲的更加明白,透彻。

结语

以上就是我对如何写好一个技术博客的理解。当然,每个人对于技术博客都有不同的见解,希望我的见解能给看到这篇文章的人一点启迪,有抛砖引玉之效。这篇文章也就有所价值了。

作者:jatesun
链接:https://www.jianshu.com/p/75e694a59bd7
來源:简书
分享 举报