如何分8步编写第一本技术书

最初发布在 https://www.fernandodoglio.com/blog/how-to-write-your-first-tech-book-in-8-steps

到目前为止,我已经能够成功出版3本书,在这一年(也许是明年)的过程中,还将出版另外2本书。 从本质上讲,这使我有资格撰写有关该过程的文章。

到目前为止,我还不是专家,但是对于普通和畅销书作者来说,过程是相同的,所以我想告诉您有关情况,以防您想知道要真正摆脱其中一个坏男孩需要什么。

免责声明:我不会谈论自我发布,我从未做过,所以我没有资格告诉您有关自我发布的信息。

出版第一本书的第一步是克服心理障碍。 我过去曾写过这本书:写书比看起来容易。

您不必一定要精通,甚至(在非常极端的情况下)对您正在写的主题也很了解。 您仅需了解大量有关该过程的知识即可。 无论您是否使用过往的技术,都应该使用过去的天气,始终建议研究最新的趋势和技术水平。 亲自学习这一困难的方法时,当我编写第一个标题“使用Node.js进行PRO REST API开发”时,我确定我了解REST的工作原理,但实际上,在此过程中,我对主题的看法发生了很大变化写这本书。 我进入该项目时以为我知道很多,然后从另一端出来了,比我原先认为的要多得多。

因此,在步骤1中,停止听那个声音,告诉您您做不到,您实际上可以并且会做。

您不需要写整本书,初稿或类似的东西,这绝对比写虚构的书还要好,在那儿您通常需要准备完整的手稿,出版商才能看到您。

您最初需要的只是一个想法,您想写些什么? 如果听起来好像没有人会足够在意它(我去过那里),请不要担心。 只需执行以下操作:

转到amazon.com并搜索您的主题,尝试不同的组合并查看获得的结果。 如果您的想法很具体,例如“使用JavaScript中的驼峰表示法编写单元测试的好处”,请尝试不同的组合,例如:

  • JavaScript中单元测试的好处
  • JavaScript中的单元测试
  • 单元测试的好处
  • 骆驼案编写单元测试

依此类推,您可以了解潜在书籍的市场类型。

现在打开一个文档,然后开始下一步。

这很重要,因为a)发布者将在您的提案中要求它,并且b)它会为您提供如何发展您将要写的主题的想法。 认为您将要编写有关使用JavaScript中的驼峰案例的测试与说要撰写以下章节并不相同:

  1. 什么是单元测试
  2. 测试代码的好处
  3. 如何用JavaScript编写测试
  4. 什么是CamelCase表示法,以及它如何更改您的测试代码
  5. 可用于在JavaScript中进行CamelCase测试的模块
  6. 实例和效益分析
  7. 在野外使用CamelCase的案例研究

突然,您的想法现在由7章组成,它具有结构,最重要的是,可以对其进行估算。 是的,您将必须估算您的目录,这是您第一次进行时会很复杂的事情,因为还会要求您提供每个章节的大概页面数实际要花多长时间才能完成。

根据您联系的发布者,您可能会获得有关这些数字的一些帮助。 在Apress.com上,他们非常乐于帮助新作者起草建议书,因此,如果您有扎实的想法,他们可能会指导您完成整个过程。

是的,这有点糟,因为您将不得不花一些时间来编写而不实际知道您的想法是否会被任何人接受。 大多数发布者会要求提供示例章节,主要是为了了解您的写作方式,他们不了解您,因此他们需要电子邮件以外的其他内容。

不必太担心本章的内容和篇幅,一旦开始工作,这可能最终会改变。

作为建议:不要写第一章或最后一章,不要在中间写东西,这样可以避免诸如结语或欢迎读者阅读书本之类的事情,并坚守书本的坚韧不拔。

到现在为止,您已经拥有了目录和示例章节,甚至对书的市场和竞争都有了了解。 您现在准备好将您的想法发送给发布者。

是的,您是向他们发送提案,通常,如果您访问发布者的网站,他们将在描述其过程的过程中具有某种链接,以下是其中的一些:

  • Apress.com:https://www.apress.com/la/write-for-us
  • NoStarch出版社 :https: //nostarch.com/writeforus
  • 实用的书架 :https://write-with-us.pragprog.com/
  • PacktPub :https: //www.packtpub.com/books/info/packt/contact-us (请注意,您不能直接向他们发送建议,而可以发送您的姓名和专业领域,他们会发送以自己的方式预定提案)。

当然还有其他一些,这些是我过去与之交互/发布的内容。

其中一些发布商甚至提供了提案的模板,在这种情况下,您应始终尝试遵循它们,否则,在他们考虑之前,可能会要求您更改提案,因此请花一些时间并确保您发送他们要求的一切,这将节省每个人的时间和精力。

现在,除非您尝试编写已完成的工作,否则您可能会从中获得认可,并且过程将继续进行,或者您将获得一些指针来完善您的想法,在这种情况下,我建议您跟着他们。 记住:他们知道什么在卖,什么不卖。

提案被接受后,您需要签订合同,这是一个标准流程,在流程中,他们将定义以下内容:特许权使用费(每次销售能赚多少钱),预付款(您能赚多少钱)在重新开始之前,请记住,一旦您用特许权使用费支付了您的专利使用费,就将开始从中获利),目录,章节和预定截止日期等。

不必担心这个过程,因为它通常不是一个很大的文档,如果您对条件不满意,可以肯定地退后一步。 这里重要的是,如果您签字,则取决于您自己保持进度,因此请确保日期有意义。

现在是您开始工作的时候了,我的建议是每天写。 是的,在每个紧张的日子里,这样您就可以不断取得进步,用这种方式来管理事情要容易得多,而不必费力地拉着三个小家伙来完成一章。 通过每天进行工作,您将获得更多时间来考虑要添加到章中的内容,返回,更改,重写并总体上提供比用3篇完整内容编写的产品更好的产品天。

编写过程从您开始,但在交付章稿时并没有结束。 对于技术书籍,出版商通常会为您提供技术评论员。 这些是其他技术人员,他们将审阅您的草稿并添加有关您工作的所有技术方面的注释。 如果您要独奏,这通常是无法获得的惊人奖金(当然,除非您为此付费,但这里是免费的!)。 您应该利用这一点,并密切注意审阅者所说的话。 尽管您总是可以退后而忽略这些评论,但是请确保您有充分的理由这样做,而这并不是您的自负。

您的草稿通常还会经过样式审阅者,他们将检查您的写作风格,他们会忽略技术内容,而专注于确保语法和语法在整章中保持不变,从而以最佳方式向读者致意。可能。 同样,如果他们给您笔记,请注意它们。

交付所有章节草稿后,他们会将它们连同评论一起发回。 查看完评论后,进行必要的更改,然后再次发送第二稿,他们将全部接收并发送给生产。 这意味着(并且我在这里没有编辑,因此,根据我所能收集的信息,)它们将使书本格式看起来不错。 它们将介绍您章节的格式,修复所有需要修复的内容,并创建PDF格式的第一本书草稿(通常),您将在其中看到封面,封底,其中的所有副本以及内容。 基本上,您将看书的电子版本(至少是书的第一稿),将要求您对其进行审查,然后再次提供您可能需要的任何反馈。

之后,该书将被发行。

现在完成! 恭喜! 你做到了! 您从一个简单的想法就设法制作了一本完整的书,现在您可以坐下来,放松一下,喝点您想喝的任何形式的庆祝饮料,您毕竟已经获得了。

你会赚多少钱?

简单的答案:不是很多,至少如果您只是想写作和坐下来放松一下,至少不会。 进步并不大,但是有些出版商愿意付出比其他人更多的钱。 我见过的数字从每本书2k到8k(但以后没有使用费)。 如果您想以金钱为目的,则不能将预付款视为其主要来源。 网上有很多地方,他们讨论从书本中被动赚钱的策略。 我建议调查一下。

这需要多长时间?

有一阵子,你需要耐心。 写作需要花费时间,特别是如果您不把它作为主要工作(我假设您在这里有一份全职工作)。 以我为例,我的书相对较短(约200–250页),写书大约需要2到3个月,之后您必须增加评论和最终制作过程所需的时间。 因此,对于小书来说,总共要花6个月的时间(如果您打算写更多的页面,则肯定会更长)。

这绝对不是一件容易的事,但是它比人们想象的要容易和容易得多,因此,如果您一直在尝试这个想法,我建议您尝试一下。 去做就对了!

另外,即使这不是一个大卖家,您认识多少人在他们的房屋上写了一本书? (您通常会免费获得书籍copies)