技术书出版,从这里开始

作者/分享人:杨海玲

技术书出版的开局

背景:一个很不错的选题点,作者也很不错,是相应技术社区比较活跃的技术人员,有实战开发经验,但很忙,没有写书经验。大纲很早就讨论好,并确定下来,但写作过程中迟迟没有按计划阶段性完成稿件,于是与作者电话沟通,得知其目前的进展和困惑,作者几近没有完成书稿的信心。

写书确实不是一件容易的事情,既有技巧,又需要毅力,这些都是需要慢慢积累的,遇到困难也很正常,不用太有负担。

针对咱们的书目前的进展和你所提的几个问题,我给你几个小建议,希望在写作过程中对你有用。

问题:有些内容就几句话就讲完了,每一章写下来都就几页,要写到计划的篇幅挺发愁的。

有一点要记住,就是书是写给不懂这一技术的人员看的,所以有些你觉得可以一句带过的内容可能真的需要详细交代清楚,这样自然也就从文字上保证篇幅了。

问题:目前获得的消息是,很快就要发布新版本了,是不是等新版本发布了,再继续写?

暂时不用估计版本更新的细节,把基本思路和知识点的部分先写好,知识点、原理、基本原则、技巧等无论实现的细节如何变化,基本都还是固定的,毕竟万变不离其宗,细节可逐步根据版本更新。

问题:目前很忙,没有整块的时间写作,每次想写完一章再沟通,但写出一章真的很难,这样写作过程中自己很没有成就感,坚持下来好难。

不要以很大的篇幅作为写作的单位,可以考虑以小节(大概也就几页)作为写作单位,逐个知识点展开,丰富内容。如果你一天就能完成一节,这样比较容易有成就感,有了成果就很好坚持。

问题:原来也是有一个按月做的写作计划,但两个月下来,发现每到月底才发现,离计划差好多,根本没有按计划完成。

要做一个详细的计划,把每天期望的进展列在计划中,然后每天记录一下完成情况,这样比较具体,既有动力,又有压力,效果应该不错。

问题:案例如何贯穿全文中一直想不好,所以案例也没开始落在文字上。

另外一块比较大的,就是把书中要贯穿的案例根据涉及的技术点单独整理出来,包括源代码部分,先不管书的知识点怎么构思和安排,先把案例彻底做好,这个对你来说应该不难。

问题:除了案例,还有哪些能提升书的亮点的内容要体现,给些建议吧?

然后把案例代码和各章节知识点整合起来,让案例的进展服从书的整体结构,在这个过程中可以充分加上你的经验、技巧的总结和分享,就有血有肉了,大致成型的书稿就有了。

问题:我一直在一遍一遍修改已经完成的部分,总是感觉不满意,总是有些内容觉得要补充,所以感觉书就停滞在已经完成的小部分章节,从章节上看,丝毫没有进展,很受打击。

最后做逐步细化,细化包括完善文字和表达,提炼经验和技巧,针对软件版本修改细节,对知识点的增删修改,更完善的书稿也就完成了。

如果按这个过程,是不是就不觉得书写起来没那么难?我根据你之前构思的大纲,大致帮你做了一个写作的计划,你可以尝试按此计划实施,相信很快我就能看到阶段性成果。

1. 写作大纲按之前的讨论和思考,定下来,不要摇摆。然后选一个样章,从结构到写作风格,到内容组织都想清楚,把样章作为其他章节写作过程中写作风格的参考。

2. 第4-9章:X天。这几章都是讲具体技术的知识点的,比较容易写,只要按目录,逐一内容写出即可。这部分内容不要嫌罗嗦和简单,重点是尽量在能体现这一技术的特色以及与传统技术的思维模式的差异、优势等的前提下讲清楚技术点和技术细节。

3. 第10-14章:X天。这部分是实战的内容,估计你比较驾轻就熟,平日也会有不少的积累。这部分重点是不要奢望初稿就能把自己肚子里的所有东西都倒出来,重点是把框架和思路想好,然后就开始动笔,在写作的过程中不断充实,整个写作过程中都可以不断补充。

4. 附录A-C:X天。这部分估计B和C一天就基本可以完成,重点可能是A。其实A的部分可以先前面已经写好的章节整理一部分出来,发现正文没有体现的还可以扩充正文的内容,这样两头互补,内容就会越来越充实。

5. 第1-3章:X天。其实都是写文字描述,可以整理一些现成的资料,然后按自己的思路、逻辑和语言归纳总结就Ok了。

按这个时间表,全书的初稿大致在X月就可以成型。这个初稿可能文字还不流畅,可能还会增删改,这都没关系的,以为后面还有X天左右的时间修改、丰富和润色。

如果你觉得我的这个计划可行,后面我会盯着你逐步完成,希望我们共同努力能出一本对读者很实用的好书!

微信扫描登录