程序员必知必会之blog篇

转载 2007年09月25日 09:52:00
本文最初发表于恋花蝶的博客(http://blog.csdn.net/lanphaday),欢迎转载,但请务必保留全文完整,不得用于商业目的。
缘起
虽然我写博客到现在只有两年多时间,但因为文章多是原创,还经常被推荐到CSDN首页,又在几个杂志上灌过水,所以也有不少朋友问过我相同的话题:我在学习/工作中有很多感悟,但我写不出来啊,有什么好方法吗?问这个问题的有师弟师妹,也有朋友同事,甚至有一些是有近十年经验的资深技术人员。
后来看到CSDN blog开通了近20万个专栏,却只有不到55万篇原创文章,平均一个专栏还不到三篇文章。这说明有很多程序员,想写却写不出来,写了却没能坚持下来。这终究是一个方法问题。
向我咨询的一位有十年经验的资深技术人员,他给我看了一些他的作品。我惊叹于其中的技术,极力鼓吹他把其中的技术体会写出来,但他的回答是:我也想写出来给大家参考,但我下笔写不了三句话啊!
眼看着一个个技术专家有心无力,无可奈何地看自己的技术流失;眼看着一个个年轻后进无法分享学习路上遇到的困难和解决方案;眼看着大家上穷碧落下黄泉,用尽谷歌加百度也无法找到有效的参考方案。我感到自己有责任站出来,分享自己写文章的心得和套路,让更多人能够写博客、乐于写博客;把自己的所得分享给大众,回报行业,回报社会。
看图作文
无论现在你的成就多大,你也不得不承认在小学(甚至是幼儿园)学到的东西让你终生受用无穷。看图作文就是这样一门有用的学问。
(本图纯属非商业用途引用,版权归原作者所有!)
看着上面搞笑的漫画,无论是谁都能写上一两百字吧?
其实,看图作文法是写博客的好帮手哦!君不见多少网站编辑就靠这招就能混得人模狗样有房有车么?千万不要小看啊!我们写技术文章的时候,可以套用这样一个套路来写文章:
1、 先画几幅图,如软件需求图、架构图、界面图、细节图等若干;
2、 针对每一幅图写一段话,三五句,讲清这幅图的功用即可;
3、 去掉图片,通读全文,做好各段的衔接;
4、 修改文章,直到满意为止。
一开始我们就多弄点图,像太平洋电脑网的评测文章一样。慢慢地,图的数量降下去,文字的数量升上来。最终,您终于修练成Word无图而心中有图的不二法门,就神功已成了!
回眸说明文
咳,大家都还记得说明文是我们学习过的众多文体之一。但作为一个技术博客的作者,写的文章大多应该是说明某一种技术(或算法或架构)实现。因此掌握说明文的写作有着举足重轻的意义,在继续下一步之前,我们有必要再复习一下说明文的一些要素。
说明文是解说事物、阐明事理的文章体裁,最重的是要把特征、本质和规律讲清楚明白。说明文通常都具有知识性,这种知识可能来自于文献资料、研究数据或者自己的实践和调查所得。说明的时候要有一定的条理性,也就是顺序,必须搞事物特征或者人的认识规律来安排。知识性和条理性方面最好的范文就是各种药物的说明书了。在这里有一份“小儿甘草锌片”的说明书http://www.chinapharm.com.cn/html/database/drugmanual/730/TYV30243701092005KPD.html,如果大家对照葫芦画瓢,把自己要分享的技术(或算法或架构)以这种填表式表达出来,未尝不能达到清晰明了的效果。您可能会笑话我竟然把技术跟药品混为一谈,并认为他们风牛马不相及,但我给你举个例子,你看看有着最完善的技术文档之称的MSDN,是不是像极了药品说明书?下面看个.net类库里的Keyboard类的文档:http://msdn2.microsoft.com/zh-cn/library/microsoft.visualbasic.devices.keyboard(VS.80).aspx,语法、备注、示例、层次、安全、版本和参考信息,一类一类列下来,简明清晰,我等学习的典范。
说明文主要是说明事物给人知识,所以既可以写得平实(如MSDN),也可以写文艺化一些(如我的博客上的《Mixn扫盲班》http://blog.csdn.net/lanphaday/archive/2007/06/18/1656969.aspx)。说明的方法有下定义、作诠释、作比较、打比方和分类别等等,具体的可以再参考当年的教科书。
十句作文法
上面废话了这么多,难得您还能忍着呕吐感看到这里。为了报答您对我的赏识,我决定在这一节开始白话一下我的两个独门密招:十句作文法和测试驱动写作。咳,虽然我号称独门,不过据我所知,用这两招的人非常多,相当多;特别是苦难的高考期间紧张在黑色六月的祖国的花朵们,经常用这两招。
十句作文法不是我原创,是中学的时候,我的英语老师教我的。那时我数学经常考一百分,语文就差了点。我的老师看在眼里急在心里,为了培养一个能文能武的学生,他在某个冬日的午后,在痛批恨铁不成钢之后把这个独门秘方传授于我,从此我就走上了作文高分之路。
首先要指出的是十句作文法并不是一定要写十句,通常是8-12句。这种方法对付考试是最有效的,但也可以应用在我们的技术文章写作当中。十句作文法其实是最低阶的写作方法,汗,我在前面似乎把它吹得太神乎了?因为十句话往往只有200个字左右。200个字能说清楚些啥啊?没关系,只要我们不停地迭代(不知道什么叫迭代?)和递归(不知道什么叫递归?)应用这个方法,200个字也能清易扩展到2000个字。古龙曰过了,最简单的,就是最有效的。
文章就像水,没有固定的形状。不过,文章也像水,有源头、有主体和终端;就像再长的河流也最终也要流入大海,再长的文章,也逃不过“始、中、终”三个字。只要我们掌握了这一点,自然就能一切通杀了。
有了上述理论(气宗)指导,下面十句作文法(剑宗)就显得相当简单了:
始(第一段):
       主题句一句,通常应用开门见山法。
       扩展句一句,用以深化主题,通常应用烘云托月法。
中(第二段):
       简介一句,通常应用承前启后法。
       下面用时间、空间、逻辑、总分、并列或者因果等法讲述事物/事理,共六句。要用的方法有彩线穿珠、小中见大、顺应时空、尺水兴波和联想对照等。
终(第三段):
      
结束句一句,用以总结全文、升华主体思想,最典型的做法是:啊,多么伟大的中国人民啊,他们创造了与世无匹的世界奇迹!
       有了这十句之后,我们就可以以小段为大段,以句为小段,对每一句再应用一次十句作文法,文章自然就体积胀大,而且结构分明,看起来蛮像一回事了。(附注:如果有读者正在考英语四六级之类的考试,十句作文法绝对可以帮到你!)
本文最初发表于恋花蝶的博客(http://blog.csdn.net/lanphaday),欢迎转载,但请务必保留全文完整,不得用于商业目的。
测试驱动写作
       虽然十句作文法是老师传授于我,但测试驱动写作却是明明白白的我的原创。证据?还真没什么证明,不过在百度上搜索”测试驱动写作”,找到的网页数目为零,也算是一个证据了吧?http://www.baidu.com/s?ie=gb2312&bs=%BF%AA%C3%C5%BC%FB%C9%BD&sr=&z=&cl=3&f=8&wd=%22%B2%E2%CA%D4%C7%FD%B6%AF%D0%B4%D7%F7%22&ct=0
       测试驱动写作的灵感来自于编程界流行的测试驱动开发(Test Driven Development,简称TDD),简称TDW。因为TDW和着与TDD相同的血统,所以TDW也有着TDD的优势。文章简洁可用是TDW的目标,它通过先思考如何撰写文章,并罗列相关的问题要点,然后再写出文字;通过比对问题要点,循环修改添加其它观点,直到文章完成。大家都是程序员同行,TDW的优点我就不说了,请参考大家耳熟能详的TDD优点;下面我只是谈谈TDW的过程:
1) 明确要写的主旨和内容,最好是列一个提纲。
2) 在表格上写明这篇文章要达到的目标、效果、字数甚至体裁和段落,作为测试用例。
3) 利用十句作文法(或者其它方法)快速完成一个文章原型。
4) 针对测试用例比对,记录下未完成和完成得不好的地方(Bugs)。
5) 修正Bugs,然后再回到第4步
6) 对文章进行重构,润色。(放到blog上的话,这一步可以不做)
7) 文章完成。
由TDW的过程可见,十句作文法是TDW的基础,要进行TDW,必须有一种快速的原型开发方法。TDW是对十句作文法的扩展和迭代,是弥补十句作文法写的文章有骨无肉缺陷的有效手段。只要掌握了这两种方法,肯定能写出受人肯定的技术文章,为自己的博客添光彩。
Next Works
诗人陆游《示儿》诗中说:“诗为六义一,岂用姿狡狯。汝果欲学诗?功夫在诗外!”
是啊!云对雨,雪对风,晚照对晴空。要学会这些套路并不是难事。就像武学一样,在学会长拳通臂之后,讲究的是融汇贯通。无敌寂寞到左右手互博的周伯通也打不过杨过单手黯然消魂掌,是因为杨过已经把他对生活的感悟融进了功夫之中。李杜两人领衔中国诗界一千余年无人出其右,也正是因为他们的诗已经融入了他们对生活的感情!放翁一句“春如旧,人空瘦,泪痕红浥鲛绡透”让多少人为之泪流,也是因为《红酥手》这首词融入了他几十年的情感!
相信通过我的文章,读者能够掌握一些写作的方法和技巧。也许在一段时间之后,您也喜欢上了写博客,喜欢上了与大家分享自己的所得所思。这时您可能想把自己的文章写得更有文采一些,也许您仍然会回来问我,希望我再跟您交流经验。我在这里先说一句吧,我不是大文豪,如何把文章写更富有文采和风格,那不是我能回答的问题。我只有一句话也大家共勉:
功夫在文外,文章不够好,归根结底是因为对生活的积累太少。
相关文章
程序员必知必会之maillist篇
http://blog.csdn.net/lanphaday/archive/2007/06/27/1669326.aspx
程序员必知必会之Email篇
http://blog.csdn.net/lanphaday/archive/2006/06/29/850059.aspx
  

mysql必知必会pdf

下载地址:网盘下载 内容简介 编辑 《MySQL必知必会》注重实用性,操作性很强,适用于广大软件开发和数据库管理人员学习参考。 作者简介 编辑...
  • cf406061841
  • cf406061841
  • 2017年06月03日 22:55
  • 707

SQL必知必会学习笔记大总结

第一课:了解SQL 数据库:保存有组织的数据的容器(通常是一个文件或一组文件)。注意误用混淆:数据库软件被称为DBMS,数据库是通过DBMS创建和操纵的容器模式:关于数据库和表的布局及特性的信...
  • basycia
  • basycia
  • 2016年09月11日 11:31
  • 2288

《SQL必知必会》(1-7)

《SQL必知必会》读书笔记 说明:本书SQL语句均使用PLSQL Developer客户端,在oracle数据库中实践。 1. 基本概念 表(table):某种特定类型数据的结构化清单。 模式...
  • Regina_niu
  • Regina_niu
  • 2016年12月21日 09:33
  • 413

SQL必知必会第4版读书笔记

SQL必知必会_4 前言 @author 鲁伟林 在读电子版> 第4版时,做了下笔记。供以后自己或者其他学习者参考。 电子版>和书中使用的数据库和表的源代码, 请参看地址:https://gi...
  • thinking_fioa
  • thinking_fioa
  • 2017年10月17日 20:21
  • 10605

正则表达式必知必会

正则表达式必知必会本文共有2571字,阅读耗费11分钟。本文首发于个人博客:http://tanlehua.top/posts/tech/others/learn-regex/...
  • TellH
  • TellH
  • 2016年10月06日 15:21
  • 1225

SQL必知必会 第4版pdf

下载地址:网盘下载 内容简介  · · · · · · SQL语法简洁,使用方式灵活,功能强大,已经成为当今程序员不可或缺的技能。 本书是深受世界...
  • cf406061841
  • cf406061841
  • 2017年06月03日 23:18
  • 4462

《mysql必知必会》笔记(一)

一:了解SQL 1:列是表中的字段,所有表都由一个或多个列组成的。行是表中的记录,表中的数据都按行存储。          2:表中每一行都应该有可以唯一标识自己的一列或一组列。主键(一列或一...
  • gqtcgq
  • gqtcgq
  • 2014年10月27日 09:18
  • 2401

sql必知必会(第四版) 学习笔记一

温习一遍简单的sql语法,把自己掌握还不够的地方,做了些笔记.... 1 去重复关键词,distinct     select distinct sname from student;   2...
  • Dreamworker007
  • Dreamworker007
  • 2013年10月26日 23:02
  • 8038

C++必知必会(1)

条款1数据抽象 抽象数据类型的用途在于将变成语言扩展到一个特定的问题领域。一般对抽象数据类型的定义需要准训以下步骤: 1.     为类型取一个描述性的名字 2.     列出类型所能执行的操作...
  • walkerkalr
  • walkerkalr
  • 2014年05月23日 19:38
  • 930

正则表达式必知必会(修订版)整理教程

正则表达式必知必会(修订版)整理教程 1.   正则表达式入门 1.1  用途:是一种工具,主要用途是搜索变化多端的文本。匹配       到我们想要的信息。 1.2  使用正则表达式:在线测试工具:...
  • T1DMzks
  • T1DMzks
  • 2016年07月03日 01:33
  • 10394
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:程序员必知必会之blog篇
举报原因:
原因补充:

(最多只允许输入30个字)