• 欢迎访问少将全栈,学会感恩,乐于付出,珍惜缘份,成就彼此、推荐使用最新版火狐浏览器和Chrome浏览器访问本网站。
  • 吐槽,投稿,删稿,交个朋友,商务沟通v:ai_draw
  • 如果您觉得本站非常有看点,那么赶紧使用Ctrl+D 收藏少将全栈吧

程序员如何写一本书?

Web前端 admin 8年前 (2015-11-22) 2155次浏览 已收录 0个评论 扫描二维码

我在过去的几年中,写了 4 本书。有传统意义上的两本实体书:《JavaScript 核心概念及实践》和《轻量级 Web 应用开发》,还有两本电子书《3 周 3 页面》和《函数式编程乐趣》。当然对我而言,主职工作是软件开发,写作是个副业。

在写作的过程中,有一些有趣的心得。

  • 写作本身是一个很好的学习过程(至少是一个驱动你学习的动力)
  • 写书非常枯燥,特别是校对的时候
  • 写作不会让你变得富有,但是有时候会让你开心(不总是)

写文章 vs 写书

写博客/文章和写书还是有很大差别的,一个明显的差异是写文章会比较随意,而且应该尽量保持精简。一篇文章提供一些信息即可,应该尽量远离细节(如果写一篇教程,则另当别论)。而写书则应该尽可能的深入细节,尽可能可以让读者依书自修。

投入与回报

首先要明白的一点是,不要指望用写书来赚钱,至少前 4 本是这样的。粗略的算一下:我的第一本书卖了
3000 册,每卖一本我可以得到 4 元 RMB,一共就是 12,000 元
RMB。而这本书我断断续续写了三年。那是很多个周末,很多个假期,很多个夜晚的付出换来的,如果真正要计算投入产出比的话(纯粹金钱上),这显然是一个
毫不合算的事情。

作为一个参考,IBM developerWorks 的投稿,千字 200 元,一般写5,000 字以内,也就是 800 元 RMB
左右。而要写一篇这样的文章,我只需要一天(当然需要数周/数月的积累)。12,000 元 RMB 需要写 15 篇文章,如果每周写一篇,不到 4
个月就可以写完,而且写文章比写书容易多了,毕竟篇幅比较短小,易于校对。而且对于大部分开发者来说,固定在一个主题上的难度要比 15
个独立的主题简单的多,因为无需特别深入。

所以根据经验,要抱着公益的情怀来写书。也就是说为了让知识更好的分享,让你学习到的先进科学技术来帮助更多的开发者,提高他们的开发效率,让他们可
以在周末多休息一天。而至于翻译技术书籍,那基本上就是免费的了,完全是一个公益活动(耗时数月,斟酌字句,推敲表达方式,但是价格极为低廉:千字 60
元 RMB),所以下次见了技术书籍的译者,就多少给他捐点吧,他们才是在为人民服务

知识的诅咒

“知识的诅咒”是指人们在获得了某种知识之后,就无法想象没有这种知识的情
况了。这种现象随处可见,比如一个你到了一个从未去过的陌生城市,遇到以为当地人,然后向他问路。当地人觉得已经说的很清楚了,但是你还是不知道该怎么
走。另一个例子是:假设你不认识泰文,然后你打开任何一本泰文写的小说,你只能依稀感觉到这是一种文字,除此之外你并不能从中获取任何的信息。但是当你学
习了一段时间泰文之后,再来看这本小说,之前的那种感受就再也没有了。

写书的时候,你首先需要具备某种知识。但是写书的目的是将这些知识传递给那些不具备此知识的人,而根据“知识的诅咒”,你又无法确知那些初学者会遇到哪些问题!解决这个问题的方法就是找初学者来试读。而且为了保险起见,还应该找尽可能多的人来试读。

写作方式

一种方式是自下而上的,写一些独立的文章,最后发现可以串起来,然后形成一本书,另一种方式是自上而下,但是又会逐步调整。根据经验,不论是写一篇简
单的博客,还是写一本书,都需要按照自上而下的方式。随心所欲的写下去,基本上都收不住,而且整个文章支离破碎,貌似有很多内容,但是不成章法,读者也无
法轻松的获取知识。

先列出大的章节,然后逐步细化,但是未必是按照顺序来写。先编写自己最熟悉的部分,然后逐步完善。例子的选取需要精妙而恰当,最好有图例来说明。

配图制作

一般而言,我在书中会使用两种图:流程图和一些截屏。截屏通常使用 Mac OSX 自身的功能就已经足够,而流程图我会采用一些额外的工具如:

  • graphviz
  • keynote/sketch

用 Graphviz 画图的好处就是可以将图像代码一样放入版本库来管理。

除此之外,我还学习了一些设计软件的基本用法,事实上只需要用一些简单的元素就可以做出非常专业的配图:

  • 字形/字体(大小,粗细的变化)
  • 颜色(基本的配色理论就可以做出很舒服的配色)
  • 层次(尺寸,位置,颜色的深浅)
  • 阴影

代码格式

书中实例需要很多代码来说明,如果是制作电子书的话,可以使用 Markdown 预处理器自带的功能来高亮。另外如果需要 RTF 格式,可以使用这些工具:

  • highlight 工具
  • intelij 中的插件copy on steriod

这里有一篇博客来说明如何将你的代码带着格式拷贝到剪贴板中,拷贝之后,就可以将这些内容粘贴到 Word 或者 Keynote 中了。

jest.dontMock (’../components/headline.jsx’);

describe (’Headline’, function() {
  var React = require (’react/addons’);
  var Headline = require (’../components/headline.jsx’);
  var TestUtils = React.addons.TestUtils;

  it (’#render’, function() {
    var text = "this is a title";
    var headline = TestUtils.renderIntoDocument (<Headline title={text} />);
    var title = TestUtils.findRenderedDOMComponentWithTag (headline, ’h4’);
    expect (headline.getDOMNode ()) .toBeDefined ();
    expect (headline.getDOMNode () .textContent) .toEqual (text);
  });
});

一些潜在的坑

在写作的过程中,会有一些潜在的坑。这些所谓的坑是新人可能无法想到的。相对于言之无物,不知如何下笔,最痛苦的其实在于平淡。大部分时候,你可能很容易就能写出开头,但是很难坚持到最后。即使好不容易写完了第一版,后续的重读和修改,会让你苦不堪言。

内容写好之后,样式是下一个重要的问题,好的内容需要有与之匹配的排版。在中国,作者不但要负责内容,还要负责一些排版的事情。这一点非常奇葩,但是又是实情。这也是我更推荐电子版的原因(排版更加美观,选择更加多样,而且一旦有问题可以更容易的修改)。

另外一个问题是错别字检查!检查错别字对于作者来说,是一件非常困难的实情。而对于读者来说,则是一件很容易的事情。这跟知识的诅咒的道理一样。

发布方式

实体书

传统的出版方式有一些明显的问题,这些问题已经和现代的知识传递方式产生了冲突:

  1. 时滞性(新技术的更新速度远远超过审批,印刷等流程的时间)
  2. 排版(如何低成本做到语法高亮,或者彩图)
  3. 更新频率(当技术更新之后,如何更新,是传统纸质书无法解决的问题)

传统的出版方式有点像传统的软件开发,一本书从开始写作到最终出版,要经过很多环节。忽略掉写作过程,从交稿到出版会经历很多次审核和校对,可能会历
时4-8 个月,着这个过程中,很多东西都可能发生了变化,一个典型的例子是《用 AngularJS 开发下一代 Web
应用》,原版为英文版,翻译成中文版再到出版之后,书中的很大一部分内容已经过时。读者拿到书之后,会发现书中的内容已经和当前的版本/文档不匹配了。这
种现状随着技术的更新速度和频率还会再加剧。

第二点是排版。我听说国内有些出版社已经开始接受 Markdown 作为稿件的格式,但是大部分还采用 Word 或者 WPS
等格式,这样排版就变成了一个大问题。以我自己为例,我的原稿用 Markdown 写,但是写了几章之后不得不切换到 Microsoft word
上,而我自己的 Mac OSX 下的排版到编辑的 Windows 下就会变样,而且还会涉及字符集,字体,Word
版本等等问题的影响,最后导致印刷出来和原始稿件出入很大。

最后一点是更新频率,如果发现了错别字或者错误的地方(即使之前检查过多次,仍然会有漏网之鱼),由于实体书的特殊性,一般需要等到再次印刷才能解决。这意味着先购买的读者会承担一些风险,更新后的版本又如何让读者看到呢?总不能又买一本吧。

但是这些问题都可以通过电子书来很好的解决。首先,电子书可以随时更新,最低限度的降低时滞性。排版上来说,作者可以使用 Markdown
来编写,而展现则可以应用一些预定义的模板来完成。最后,更新频率完全可以控制,对读者来说风险更低,因为电子版书籍的可以很容易的追踪交易记录,从而得
到免费的更新过的版本。

电子书

目前已经有很多的渠道可以发布电子书,比如 gitbhook,知笔墨。这些应用的出现,大大降低了发布书籍的成本,我的《函数式编程乐趣》,用了 3 天就完成了草稿,而发布只需要数秒。

另外一个问题是书籍的价格和作者的收入。一本书定价 50 元 RMB,出版社给作者的版税是8%,也就是说,没卖出一本,作者可以得到 4
元,如果你的书非常畅销,这还是一个不错的价格。但是可能 90% 的书籍都不会是畅销书(就好比每个班级都会有优等生,但是他们仅占全班人数的 10%
一样)。这对作者是一种浪费:你需要耗时数月甚至数年来写一本书,然后市场的反馈又非常慢(毕竟你无法出版一本未完成的书)。

我在 selfstore.io 上有两本电子书:《3 周 3 页面》和《函数式编程乐趣》,《3 周 3 页面》定价为 16 元,每卖出一本,扣除掉交易费之后,我可以得到 14.7 元。

对我来说,这样可以得到更多的回报,对于读者则可以更加快速的得到更新,而且由于有预览版和一系列的其他信息,还可以在很大程度上降低读者的风险(更
不用说快递费,等待时间等问题)。我在 gitbook 上的统计显示,《3 周 3 页面》已经被累计下载了 28,861
次,实际的读者也将近5,000。而且没有任何的审核流程,也没有排版的时间浪费,我只需要关注内容即可。

via:insights.thoughtworkers.org

转自:http://www.admin10000.com/document/6824.html

喜欢 (0)
[🍬谢谢你请我吃糖果🍬🍬~]
分享 (0)
关于作者:
少将,关注Web全栈开发、项目管理,持续不断的学习、努力成为一个更棒的开发,做最好的自己,让世界因你不同。
发表我的评论
取消评论

表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址