TableOfContents

1. 后记故事

满纸轻松事儿,一把辛酸泪

1.1. 成书感言

"写本给不知道Python 的人,或是想学习Python 的人的有用的书"

• 从来没有想到这个忽然间的念头能成为现实...

1.2. 缘起

• 成书的经过,当然就得追溯历史了... 就我个人来讲,从 2000 年通过PHP接触到Python,到 2002 年才真正开始使用,再到2004 年掺合 python.cn社区开始大规模接触同好的行者们,对 Python 的兴趣和信心是一直增长着的, 但是发觉世人对这一优秀语言的认知识非常非常的有限,不许在各个综合技术社区中专门板块的兴起,又或是Google 公司的成功,在中国都没有促动起 Python 的发展; 这才开始思考 Python 的推广,反思自个儿的 Python 学习体验, 寻找是否有有好书可以促进Python 在中国落地生根; 又通过对社会化学习方面的参考,才意识到:

学习的阶级

从高到底是:

• 知己不知<知己知<不知己知<不知己不知

为什么这么说?

• 开始涉及一个全新技术领域时,我们不知道我们对这个领域的任何信息,也就是连不知道什么都没有概念
• 后来,通过不自学的,或是继续的学习,已经获得了部分相关信息,但是从来没有考虑使用这领域的知识来解决问题,所以,不知道自个儿已经知道了哪些领域内的实用信息
• 再来,通过实践,切实掌握了领域的关键知识,并对领域内的所有方面都有所了解,明确在领域内自个儿掌握了什么;好比举着油灯进在一个大图书馆中,刚好照亮了一整书架,但是不清楚在光圈以外还有多少书架;
• 最后,推而广之,对领域相关的所有知识领域都有所了解,掌握了领域间的关系,明白自个儿究竟还有多少知识不知道;好比那个大图书馆中,打开了所有的电灯,明白自个儿身边这一整书架同整个图书馆其它书架的关系;

  感觉,只有快速达到知已知的阶段,才可能事半功倍的高效率/自信/自觉的继续学习下去; 幸好,Python 又的确是个易学好用的语言,怎么向其它没有摸到 Python 秉性的人们宣传这种体验呢? developerWorks 中 David Mertz 创作的“可爱的 Python”系列 ：

  http://www.ibm.com/developerworks/cn/linux/theme/special/index.html#python 就成为我想成书的原型了: 将 Python 最可爱的方面,以小篇幅的形式组织发布出来;

1.3. 社区

那些风花雪夜

• 2007.2.1 在邮件列表中一个小白苦恼的心聲

  http://wiki.woodpecker.org.cn/moin/ObpBroadview/2007-02-01 激发出了行者们成书的狂想,经过讨论,定名,定内容,定大纲, 可爱的 Python 就在社区活跃分子的相互鼓励中开始了:

  建立维基主页: http://wiki.woodpecker.org.cn/moin/ObpLovelyPython 在会课中专题讨论,建立工程环境,建立专用邮件列表,建立进度讨论IRC聊天室,建立项目管理网站... 一点点,一滴滴,一页页,就积累起来了... 本来以为是可以快乐的轻松组织完成的,没有想到博文注意到了我们的想法...

1.4. 撰写

• 编辑主动找到我们,并快速由副总出面在北京宴请当时的主创人员,确立了图书的基本思路和网络/图书双版权发布的基调,将社区视作独立的单位进行协商,一下子,游击队变成了正规军...这感觉,怎么说呢?... 蝙蝠侠说:"能力越大，责任越大" 我们则是:"期望越大，压力越大" 我们期望写出 第一本中文Python 原创图书，第一本原创入门Pythonq图书,第一本原创畅销Python 技术图书...

  但是！我们只能 快乐并痛苦着写:

  • 一想到这些文字是要付梓成书的，就不敢象邮件列表中痛快的表白
  • 但是又想到得将快乐的Python 体验原味传达给未来的读者,这又得表白的痛快...

    林林总总,在对自个儿对编辑对文字对代码对截屏,等等纷繁的矛盾中努力的码字的同时,还要完成各种工作任务,挣来口粮,才能支持自个儿继续 快乐并痛苦着写...

甚至于在不断的"煎熬"中总结出了:

如何组织在线图书工程

• 态度决定一切!~兴趣才是网络团队的最稳定动力

在线分布式团队的构成,更加要求臭味相投,最好是一个稳固的社区中的老朋友们

选题的有趣和有用,也是图书成功的绝对必要条件

图书也是工程!~在资源方面,要大力使用基于互联网的服务

• 就按照软件工程的方式来组织大家都习惯且有效!
• 网络中的对应免费服务是齐全的:
  • 版本控制~ code.google 等等免费工程管理服务
  • 日常沟通~ groups.google 等等免费列表服务
  • 知识积累~ wikidot.com 等等免费维基服务
  • 实时讨论~ IRC at freenode.org 等等聊天服务
  • 项目管理~ Everydo 等等免费管理服务
    • 进度计划~ google.com/calendar 等等在线日历服务

没有规矩不成方圆~有了团队,一直要组织和管理的

• 定期的IRC会议非常有助于鼓励士气,協商进度,调节任务
• 一定要有热心的核心人物来協調和决定所有变更(前期应该是发起人,后期由编辑分担比较合理)
• 200页以内的小书,团队有多少人是没有关系的,因为任何偏差都可以快速修订
• 大于300页的图书,写作团队应该控制在5人以内,否则,沟通将是没有尽头的事儿了:
  • 合理的团队构成:
    • 2~5人的撰写成员
    • 4~15 人的校对成员
    • 尽可能多的关注/宣传成员
    • 1~2 名稳定的责任编辑
• 一定不要使用任何 Office 格式文档来进行交互组织!这是无法进行版本控制的二进制东西!
  • 结构化文本/纯文本/HTML/TeX 文本
  • 等等都是可以良好的通过版本控制环境进行充分管理的格式!一定要坚持使用!
  • 即使在交付前统一倒入 Word 之流来统计字数,也要坚持使用!

出版是不比撰写轻松的复杂工程!~理解出版社的工作方式后,才可能有良好的配合

• 国家法令法规,行业潜则,市场反应,目标人群,流行模式,排版风格... 都是出版方面的专业知识,不是软件行业行者可以轻易体悟的到的!
• 有技术背景的编辑是个宝!
• 固定的编辑是永远的朋友!
• 固定的编辑追随进行田间管理是种幸福,否则是很郁闷的事儿~你得将相同的话,不断的反复说给不同的负责编辑
• 不使用 M$ Office 的编辑在中国是神话! 但是,技术社区撰写,完全不应该使用 Office 工具来进行...
经验

• 沟通:沟通比一切都重要,让所有人及时知道所有事儿,是在线分布式社区化写作的最基础原则! 因为社区式工程,无法象公司式组织,人员/时间/场地是固定的,所以,面对不断流动的团队成员,作为图书工程主持人,我发布的维基文章/列表邮件/IRC聊天沟通/MSN協商/会课谈话记要等等沟通用文字总量比图书本身的内容要多10倍有余!深深感受到:

  • 沟通需要代价,改进由我作起!

  • 想进行有效图书工程沟通得注意:
    • 自个儿首先得有谱,有整体的图书内容思路,想法,设计,原则,规范
    • 有统一的文档发布,将以上的整体设想,及时发布成在线文档,有助于全体及时理解
    • 统一确定的时间段来沟通,在同一时刻大家同时来解读相同的内容比较有效率,因为人的注意力不是那么简单的可以随时集中在某件事儿的,在约定的时间,大家相互激励,比较容易专注
    • 对于沟通的结论,最好统一格式统一地点统一发布!以便形成积累,给后来加入的新人一个有时间顺序的学习资料集

• 资源:

  • 用于工程的各种资源/工具,最好是基于互联网的,这样可以吸收最大范围内的力量,有网络,就有可能!

• 法律:

  • 一定要有合同! 在有社区背景的图书工程中,出版社对版权/署名的理解是不同的,一定要事先沟通好,否则,会有解释不清的麻烦，对社区贡献也是个隐患
• 签定合同时,一定要有法人资格的社区出面来交涉,出版社会比较重视...

1.5. 摧生婆们

• 在图书完成的后期,发觉几个技术图书出版社也有各自的专题邮件列表了,也是从技术图书出版社列表中,知识了图书编辑的"田间管理".. 在图书从想法到成书过程中,适时的配合,反馈,沟通,促进.. 这是编辑保证图书不跳票的有效手法,也是作者们写作的动力之一..就和写Blog 类似,有人追着看,评论的Blog 作者总是积极一些的..
• 毕竟网络团队化社区式群体写作,存在沟通不直接,大家的时间无法保证的问题,和自由软件不同,软件的版本发布时机是社区主动把握的,而簽定了合同的图书工程,是不能轻易跳票,改发布日期的哪...
  • 所以,除了一直在关注图书的社区行者们,掺合撰写的伙伴们,最令人感动的就是那些"摧生婆"们了:
杨编
• 是最早关注了社区动向,并将其作为一个图书选题来进行主动沟通的"摧生婆" 正是他的促动,从而令图书正式的成为博文的图书立项,开始了这次成书之旅,可惜,从来不是本书的责编,而且不久离开了博文,没能看到图书成型...
方编
• 是最早的责编,因为同是程序员出身,是最明白技术的编辑,在内容方面给出了非常多的建议,很大程度上使我们这本内容很另类的技术入门图书被出版社接受,方编居功致伟!不久也离开了博文,没能看到图书完成...
彭编
• 是临危受命的责编,虽然跟的时间不长,但是非常耐心的全盘接受并理解了我们的意图!尽而也非常开放的共同使用我们建议的网络服务进行编辑事务的透明沟通...
赵编
• 是最后一位责编,跟的时间不是最长的,但却是跟的最紧的,在他的任期,合同以哲思自由软件社区的身份签定了,版权的分离也成功达成了理解,而且美术编辑的跟进,也是赵编从中艰难的在共同摸索全新的模型...

1.6. 成了?!

• biu~~的一声,从吃过接风宴,开始写,到现在一下子快两年了,这其间,俺从北京跳到了珠海,到完成了过程改进专员到过程改进经理的飞跃,同时,间杂的,还利用组织 可愛的Python 一书的经验,组织了另外两本Python 技术图书的翻译校对和另外一整本原文图书的快速翻译...

• 时间,真的在不知不觉中飞速的消逝了,真的非常敬佩博文出版社的执着,所以,冲刺!不断的,每次,都在社区列表进行倡议,摇旗声援的不少，真正投入到撰写的也着实不多，但是，书是真正在不断的完善中，可是，随着完成度的增长，也越来越对内容，有所挑剔，总是感觉有更加好的表达方式...

• 另外一方面,Python 也在不断的进步,两年里版本增长了三次,而是象周蟒这样的项目,更加是从无到有的成长了起来,
  • 对图书的内容也更加的惶恐:"足够有趣,足够有用嘛?会有人买来看嘛?"
• 幸好,编辑一直在肯定的说,这样整一定成的,但是什么时候是真正的成了?
• 突然的有一天,在不断的相互督促中,焦虑中,突然发现,成了,所有章节都完备了,可以了... 这种意外的巨大的惊喜,不比那日意识到自个儿在使用 Pythonic 来编程时顿悟般的快乐...
• "发表是最好的记忆" ~ 台湾候捷 老师的感想,也是我们的感想,一定要纠集可能多的同志們共同来成书,就是想分享这最好的记忆;但是成书的那一刻,就是我们忘记这本书,向下本书进发的时候,因为成了的书已经属于读者了!也属于社区,将在网络中长久的修订/增补/完善下去!

2. 编辑故事

2.1. 夫复言无Python入门之佳作(Rev2)

杨编者说::

• [http://docs.google.com/Doc?id=ah9sz7kfxfhz_131hpn9gvgk 夫复言无Python入门之佳作] ^杨编者说

前247年，李斯跪别恩师荀老夫子及好友韩非，只身向西，奔赴秦国，只为实现己之伟大理想。辗转艰辛，蒙贵人郑国之荫，终成秦相国吕不韦3000门人之一。此去无多日，李斯才华尽显，遂被吕(不韦)拜为上宾。

为安息同僚（3000门人），李斯以四大公子为前鉴，说服吕不韦召3000门人合力著书，历时七载，终成《吕氏春秋》，实为亘古未有之壮观。此工程之浩大，为万众瞩目，真乃秦600余年划时代之大事。书成之后，吕（不韦）大摆宴席，广邀百官，共襄盛事。酒过三巡，始于席间传阅《吕氏春秋》，百官们管窥锥指，难尽全貌，无不为之称奇，以为万世之盛举。然众人皆贺之时，唯李斯（此时李斯已贵为客卿）不贺相国。众人无不惊讶，吕(相国)亦尴尬难当，风景大煞。李斯见状，慢道：”李斯不贺相国，只因《吕氏春秋》历时七载，一朝告竣，非相国之喜——实为大秦之喜也。大秦得此书足堪传诸久远，子孙受益······，李斯贺我大秦，再贺后世学子······“

时六国兵强不如秦，法制不如秦，民富不如秦，而素以文化蔑秦，笑秦为弃礼仪而上首功之国。自《吕氏春秋》著成，驰传诸侯，广布天下，六国不复言。

公元2006年，吾入行未久，因工作之需，终日闲游于CPUG，幸识得周老夫子。是时，Python之作寥寥，而从之者甚众。吾遂生请周老夫子著书之念。待告知周老夫子吾之所想，岂料二人皆有同感，只叹相议恨晚。然此后时日，吾因他事，未能续与周老夫子议书，抱憾至今。

其间，周老夫子行吕（不韦）之事，履吕（相国）之职，召CPUG众人合力著书，两载后终成《可爱的Python》。著述此书工程之浩大，若论之功，周老夫子当居首也。书成之日，众人皆来贺，贺周老夫子，贺CPUG之同仁，贺莘莘Python学子······

过往，众人皆怨无Python入门之佳作，而今《可爱的Python》不负众望而出，万人空巷之盛景可期矣！是也乎？

2.2. 兴奋又惶恐的心情

~赵编者言

• 今天我负责的《可爱的python》有了较大的动静，一直以来，我都在尽力推动本书的成形，其间也存在不少困难，我兴奋过，气馁过，妄想过，现实过，现在总算把心沉了下来。在推动本书的成形过程中，我不断的修正自己的目标，也不断通过打破流程来给作者们一些能够看到的东西，这样，他们才更有动力前进，因为我知道，每个人都是孤独的，有了同伴的呼应，大家才会忍住各自的艰辛，继续前行。感谢这些pythonic们，正是他们的分享和奉献，这本书才有了成形的可能。现在，我已经看到了希望，大家的兴趣开始提高了，从我收到的邮件列表的数量就可以感受出来。虽然，这仅仅是开始后的一小步，离成功还非常遥远，但我相信大家有了共同的信念，会共同前行的。虽然，在随后的一个月里，各种问题会曾出不穷，但是我坚信一点，办法总比问题多，各种解决方案也会纷沓而至。作为小编，这里非常汗颜，能够帮助作者的地方并不多，只能尽自己的一份力，尽量做好自己份内份外的事情，更希望能将本书做好。正如Zoom.Quiet提到的，本书虽然不是中国第一本原创Python 图书，但是绝对是第一本分布式社区开发式的原创图书。我愿意为这个第一而努力！！！

• http://swim1975.blog.sohu.com/80578420.html 《可爱的python》策划分析小记

• 当我拿到这个选题的样章时，感觉很乱，不仅在于其语言不符合正规的出版读物,它是具有很强的网文风格的，而且，其各个章节关系也没有很好的联系起来，各个部分都由不同的作者完成，其写作风格各异。让我这个新人把它捏成一本书!O!My God！这可和我想象到的策划编辑的工作不一样啊，我还以为要么出一个策划的点子要么负责书稿的校对工作呢！事已至此，也没有更好的办法了，硬着头皮上吧！从小到大，我的语文成绩从来没有好过，每每我发些感慨想写点东东给别人看看，考虑到自己的文笔，也就cancel掉了。这次不同了，关系到我的饭碗，兹事体大，不行也得顶上去啊！

  • 先找到作者群的负责人Zoom.quiet，得到的答复是本书已经基本完成，其它的作者由我去负责跟踪，听到这里我头都大了，本书的主线是什么我都不知道，面对他我都不知道如何面对，和其他的作者我如何去沟通呀！Zoom.quiet给了我一个建议：好书是编辑催出来的。怎么催啊？不知道！没有办法再谈下去了！我找不到和Zoom.quiet的有效沟通方式，只好想别的办法，去找其他作者，看看有没有好的建议。发邮件给黄毅，没有回复，这条路也被堵死了。好在本书是python语言的入门书籍，python

2007年的年度语言！（TIOBE），前景看好。这个让我产生了学习python的兴趣，心想，即使本书做不下来，根据里面的内容学习一下python总也有点收获吧！正好春节到来了，我也有了一定时间可以学习这门语言了。

3. 行者故事

3.1. 热烈祝贺可爱的python顺利成书;-) 黄毅

• “你以为不宣传我就找不到你吗？没有用的，你是那样拉风的语言，不管在什么地方，都好像漆黑中的萤火虫一样，亮得鲜明，亮得出众。你那完美的语法，优美的缩进，神乎其技的标准库，还有那无数超强的第三方库，都深深的迷住了我。”
  • ——致派松
  遥想大三当年，初识python，顿时被python深深吸引，义无反顾地加入到了hacker的行列，从此踏上了python这条"不归路"。 还记得祖母奇号召出书的那一天，邮件列表顿时风起云涌，隐隐竟有王者之气显露。 不过写书毕竟是个体力活，还是持久战，过程中颇多坎坷，现在回想起来依然唏嘘不已。向那些艰苦奋斗一直到最后的同志至于最崇高的敬意！ 终于好事多磨，艰苦奋斗没有白费！希望有更多人从通过python得到启发，也希望和更多人一起分享学习python的乐趣吧。

::-- ZoomQuiet [DateTime(2008-04-26T06:35:09Z)] PageComment2