写好一篇技术博客的正确姿势是什么

写好一篇技术博客的正确姿势是什么 

    今天写博客的时候,发现不知道怎么构思,怎么布局了。然后就想到了以下这些问题:

    怎么写出来对别人更有价值的文章,同时也更方便自己下次阅读,方便读者阅读?

    为什么别人写的博客文章,这么多人阅读,评论,转发,带来巨大流量与关注。而你也写了这么多篇,阅读者却寥寥无几?

    网上搜索了下,发现有几篇好文章,摘抄总结其中几条:     

1. 主题明确,定一个好的标题。     

2. 条理清晰:

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

什么是七何分析法:     

    1、WHY——为什么?为什么要这么做?理由何在?原因是什么?     

    2、WHAT——是什么?目的是什么?做什么工作?     

    3、WHERE——何处?在哪里做?从哪里入手?     

    4、WHEN——何时?什么时间完成?什么时机最适宜?     

    5、WHO——谁?由谁来承担?谁来完成?谁负责?     

    6、HOW——怎么做?如何提高效率?如何实施?方法怎样?      

    7、HOW MUCH——多少?做到什么程度?数量如何?质量水平如何?费用产出如何?  )     

3. 层次分明有节奏感

写博客的正确步骤:  

    碰到了问题,如果解决不了,而又比较有价值的话,就先记录下来,作为一篇博客的开篇。

    首先,先自己分析问题,基于已有的现象,思考,在笔记本上记录问题与可能的思路。 

      其次,从外界获取经验或者知识,比如请教别人,google等,学习他们,在笔记本上记录关键点。

    然后,在实际中用学来的方法去解决问题,笔记本做好记录,要像水流过水渠一样流淌前面记录的思路。

    最后,拿过笔记本,将以上过程再总结成一篇博客。

      技术博客不是论文,技术博客由其实用性。当然,也有将论文发在博客上的,比如技术博客的作者大部分应该是工程师,而不是学院派。一篇技术博客可以 是小到的一个编程技巧,可以写该技巧的原理、实现方法、好处,但不要写前500300年的历史介绍和展望未来。技术博客通常关心技术的实用性,而非技术 背后理论的复杂性。技术博客也不应该过分求全责备,把文章写的大而全,而应该追求小而精。

    技术博客应以陈述语气,个人感情色彩应该过滤掉,技术不是生活的全部。有人写技术博客,常喜欢加入自己的心情,xxx让我好烦啊”、“xxx很难,我一直持续搞了两天没睡觉”,我个人拒绝这种“呻吟”的风格。

    忌罗列代码。代码是实现的过程,而不是原理,列代码是为了看清流程,而非为了列代码而列代码。我个人的习惯是尽量少列代码,如果能够使用校小的篇幅就能说明原理,绝不使用大篇幅的代码。但是如果简单的罗列代码能够一目了然,也绝不浪费过多的笔墨去描述过程。 图片胜过文字。

    图片配文字比单纯的文字更加方便理解,甚至一张图就可以省略文字了,多画图,少写字是个原则。

    考虑时间成本。博客基本上是以时间换知识,因此需要越来越快,记录时间也很必要。 列出时间遗留问题,以备以后解决。

 参考文章:  http://www.jianshu.com/p/75e694a59bd7  http://www.oschina.net/news/46714/howto-write-a-good-technical-blog  https://www.zhihu.com/question/40716838      

 

本文章来自行果博客,转载请保留原文了链接:https://www.cnblogs.com/xinggood/p/6812158.html

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值