写一本技术书

2021-06-06 23:47:18

在阅读类似的帖子后,我被激励写这篇文章,称为Serhack如何编写技术书。不是因为他们的帖子有点问题,但因为我想更多地关注你的选择是什么,并且还展示了我喜欢的工作。

在过去的十年中,我发表了关于编程的六本技术书籍。他们中的大多数是自发布的作品,但我最近用JavaScript发布了Roguelike开发,并获得了一个针对其编程书籍而闻名的传统出版商。我的第一个热门的书是很久以前发布的Firefoxos编程的快速指南。我真的很喜欢它当时在Leanpub Bestseller中得到特色,让我真的很自豪。除此之外,我在过去十六年度为英语中印度文学的主要出版商工作。

告诉你所有这一切的原因是因为我对书写的理解随着时间的推移,我认为今天的最佳方式是写一本书的最佳方式并不一定与过去的选择相同。基本上,我不希望你重复自己的错误。

每本书项目都需要通过所有这些阶段,而最重要的阶段,如果是第三个,那么实际上会导致你的书失败的阶段。人们经常忽略营销和发射策略的重要性。按发布并认为读者将简单地涌向你的书是一个神话。另外两个步骤可以在您正在处理它们时修复,即使它们不完美,您的书也可能是成功的。让我们更深入地潜水。

您需要制作的第一个重要决定是您对书籍项目需要多少参与,因为如果您允许它,一本书项目将从您开始升至宇宙的最终热死亡的那一天吞下所有空闲时间。一本书可能只是一个业余爱好项目,或者它可能是你的工作。

你必须花多少时间来决定推出它需要多长时间。书籍项目的一个重要方面是您使用的工具和工作流程来生产本书。在那里有一个转弯解决方案,需要很少使用努力,为这些工具进行选择将释放时间让您专注于其他阶段,例如写作本身,另一方面,选择更复杂的工具和工作流程将增加您在项目中的控制和机构数量,但将增加摩擦和使用更多时间预算。

我将在关于_Writing_的部分上详细探讨这些工作流程,但是要尽早使用工作流程的决定,最好是在您开始撰写本书之前。

您的大纲是组织思想的第一步。大纲中最重要的部分不是它中的东西,但你遗漏了什么。书籍,如果留给自己的设备,将尝试成长为维基百科大小的内容。您需要将您的项目限制为您实际上可以得出的事情,这对您的受众仍然有意义。

我喜欢做一个轮廓的方式是在英雄的旅程中融合这本书。您的读者正在进行一段旅程,除了一个促进者。你不是在那里教他们,你在那里提供了他们自己学习所必需的工具。随着书的进展,读者呈现出增加复杂性的概念。在整本书中,这些概念需要将用户建造的样本项目融合,以解决他们的理解。

这意味着读者不一定在书中构建一个大型项目,而是几个小项目。他们可以一起撰写到更大的项目中,但他们应该足够谨慎,因为阅读者在阅读本书时尝试它们,而不仅仅是在他们完成它时。样本不适用于本书,本书正在提供样本。样本是建立起来的用户在学习旅程中的进步。

通过以这种方式推理您的书,您将自然地创建一个项目,其中读者是关注的焦点。这是他们的旅程。这使这本书有趣,并避免了自己的经验中最重要的缺陷之一,这是一本书,它正在写一本书,如字典或百科全书。我发现那种有用的书籍有用的参考资料,但是当你试图将它们从前面读回来时,他们通常不会成为令人愉快的阅读体验。

我的轮廓是基于第二章。我将写下读者应该在该章中学到的所有秘书初步标题和项目会议列表。将组织章节,以便编写所有内容以应对读者的需求。该需求的答案可能是新概念的形式,或以前看到的概念的新应用。

对于Roguelike开发书中的许多章节,读者正在建立一个带有固定的地牢布局的地牢爬行游戏。在他们了解Roguelike发展的基础之旅中,他们需要了解有关地牢生成的更多信息。使用BSPTREES建立一个全新的样本只是为了教导基本地牢生成;本章是写的,以呈现这些概念,但它是读者实施实际解锁学习经历的样本的行为。以下章节是前一个概念的新应用程序,基于BSP的生成器用于创建多级地牢。通过用代码进行修补,这是一个理解的旅程。

重要的是要理解大纲不是用石头写成的,就像你写下书一样,如果你意识到它实际上没有工作,你就可以修改它并从根本上改变它。

与您的轮廓一起开发样品非常重要。除非您在您的书中持有所有心理能力的精神能力,否则您将在此阶段中的实际动手方面受益。

如果每个章节都包含一个示例,请在写大纲时立即构建它们。这将帮助您通过在您对草稿的许多单词提交太多单词之前介绍您的计划的问题来调试自己的概要。

一旦你的轮廓和样本对你来说足够好,就是时候开始起草了。

从未写过一本书的人往往认为写作是艰难的一部分。它不是。这是一个容易的部分。创建您的第一款技术书籍草案很容易。难以编辑和修改它,以便您的选秀变得足以分享的东西。

如果您的大纲通过构建所有样本发生的初始调试,并且一切都很好,计划和样品都很好,那么写作应该感觉到您的计划的自然后果。应该有很少的摩擦,因为关于每个章节的所有决定已经制作了,只是时间写内容(我知道,更容易说完,但比许多人更容易)。

这也是您需要决定工作流程的地方,就像科技界的任何东西一样,有太多的选择,不可能推荐完美的解决方案。这些是您决定的一些事情:

许多人认为自我出版是作者应该选择的最后一个选择。它只发生在他们被太多出版商拒绝之后发生的,他们放弃和自我发表。这不能从真相中进一步。许多作者,我包括,将首先考虑自我发布,如果他们能找到一个非常好的原因,只能去传统的路线。

关于这一决定的讨论对于我来说太复杂,因为我在一个简单的小节中解决,所以现在让我为每个人做一个简单的专业子弹列表。

Pro:您无需担心该过程的发布部分。

康明:出版和营销往往是黑色盒子,你不是对计划的特权。

CON:将本书进入书店仍然很难,因为大多数出版商是没有从科技领域的真正着名作者的书籍的豆荚,你仍然可以从书店订购这本书,但他们可能不会在商店携带股票。

如果您选择使用传统的出版,这就是您需要停止并开始向发布商达到的地方。计算机编程生态系统中的一些很酷的人是务实的程序员,没有淀粉,反对,PAKT,曼宁。

您应该找到谁是您想要发布的区域的收购编辑器是在发布者中您想要的工作。做出好的方法是选择竞争对手书籍,看看他们的阵线,看看编辑是谁。它们通常是远离您的LinkedIn或Twitter消息。用一个球场到达他们。如果他们喜欢它,他们会告诉你他们的提案过程如何工作。您需要将轮廓调整到出版商需要的任何内容,然后按照他们的工作流程进行操作。

通过自我发布路线为您提供更多选择。我不能超过类似的选项,就像Web开发人员一样,无法列出创建Web应用程序的所有可能方法。我可以告诉你的是,有一些非常简单的方法可以做到这一点,还有一些更有涉及的人。

在我个人和非常主观的观点中,自我发布的最简单方法是通过Leanpub,这是一个SaaS平台,不仅为您提供书写书的工具和工作流程,还可以为您提供手段用自己的商店销售所有物流和付款。您在Leanpub中的前100本书是免费的,但在此之后您需要参加支付计划之一。根据您的需求,它可能值得与他们的Pro计划一起提供更多功能,如打印就绪PDF导出。我是一个亲用户,并与他们发布了四本书。

一个新的让服务 - 所有你的作者 - 需要的解决方案在我心中生长很多是reedsy。他们提供了一个市场,帮助您遇到您需要的各种专业人士,编辑器,副本,蓬蓬镜头,封面设计师,Beta读者等 - 但他们也有一个踢屁股在线编辑,供您撰写您的书。您可以使用他们的平台来写这本书,雇用在那里列出的专业人士在书上工作,并且来自同一平台生成电子书和准备打印的PDF。

此外,他们有一个美妙的YouTube频道和博客,有很多关于创意写作的内容。他们的平台更适合非技术书籍,但仍可用于创建它们。

说实话,我没有覆盖他们所提供的一半。只需检查他们的页面。他们很棒。

您更喜欢使用桌面应用程序吗?我也是。因此,该行业的宠儿是一个名为Scrivener的应用程序。值得全力投资。如果你不会记得这个(非常广泛的)博客帖子的任何东西,请记住:Scrivener是值得黄金。

我不能强调你的写作职业的好评者是多么好。值得购买许可证,并致力于掌握它。您将能够在整个年内使用它,它将成为您的忠实乡绅,随时准备在您的旅程中伸出援助之手。

您可以使用它来管理您的大纲,您的研究,写下您的草稿,做所有的修改,然后生成电子书和PDF。

如果你想要更漂亮的电子书,那么将Scrivener与另一个名为Vellum的应用程序组合,你很高兴。 vellum ops是mac。

是的,我打赌你中间的盛华读者已经很紧张,上面列出的所有专有软件,对吧?好吧,有很多腐铜选择。您可以使用NovelWwriter,这是一个我最近发现的工具,尚未使用,但似乎非常有前途。

它让我想起了Scrivener,但随着Markdown的优势,我很热衷于一天地试试。不幸的是,它似乎没有生成正确的电子书。

福斯世界的瑞士军刀出版的书籍出版物是潘多,它实际上是由许多桌面应用程序和萨斯的现场使用。它是一个极其灵活和强大的工具。掌握它需要一段时间,可能超出你愿意做的事情,但它是值得的。

另一个重要应用程序是Scribus,它实际上是桌面发布应用程序,如Adobe Indesign和Affinity Publisher。您可以使用它来布局您在别的地方写入的书,但与本文中列出的所有软件相比,它具有急需的学习曲线。

一旦您决定使用您所使用的工具,就是时候汇票了。您的稿件是您在布局和排版之前的书的内容。您将通过创建多个修订来发展稿件。您的初稿将转到编辑,初始通行证后会将其退回给您。您将在编辑,副本,技术审稿人和艺术家中重复这个Ping Pong,直到所有利益相关者都足够高兴。

第一次草案有时类似于最后一本书很少,在其他时候,编辑基本上是一些小小的语法错误。这不仅取决于您的草稿,还取决于您的编辑。一些出版商可能会受到压缩,他们的编辑没有足够的时间在您的项目中投资,您可能是自我发布和支付的,只需为简单的复制编辑而不是发展编辑。

重要的是要意识到这个初步草案不是你的最终产品。它需要通过修改,并且修订目标超出了修复语法和拼写错误。您可能需要更多地重构更多。那是alpha读者变得非常有价值的时候。将书送给信任读者,让他们帮助您弄清楚需要更改的内容。如果您进入酿造,请在公开开发书,让贡献者一直帮助您。

哦,男孩,我在这里脚上射击自己。在博客文章的一部分中,不可能涵盖所有人需要知道的所有这些。让我先插上在线课程:自我发布公式。他们有很多课程,一个播客和一个涵盖你所需要的社区,在你实际写完这本书之后让你的书取得成功。它不便宜,但它将涵盖这么多内容。它会教你这么多的东西。如果你算上你花钱的时间来研究和学习所有这些,你最终会花更多的时间和金钱,而不是实际支付课程。我是一个幸福的学生。请注意,该课程专注于小说而非技术出版,但是该方法和工具在那里提供了技术书籍。

有营销计划很重要。击中发布无法保证成功。除非您已经有了很大的次数,否则读者不会神奇地出现。哎呀,也许你是evan你在写一本关于Vue.js的书,当你打发布时,读者肯定会涌向你的书。哎呀,我会买你的书。但对于大多数作者来说,拥有营销计划是必须的。

在您的书主题周围积极参与社区。活跃并不意味着继续堵塞你的书,这意味着在那个社区中是一个很好的公民,并帮助他人而没有持续的upselling。

根据您的利基,您需要支付广告。我没有任何经验,但上面提到的该课程。

让读者可以轻松与您聘用。他们的成功将为你的脸带来微笑。

如果是作者是你生活的一部分,你可以看到自己出版更多书籍。创建邮件列表以跟踪您的写作。鼓励您的读者用读者磁铁注册。

即使您不是自我发布,您需要积极推广您的书籍。 传统的出版商每年将把太多书籍放出太多书籍,他们只会在大卖家上营销努力。 您需要帮助销售您的书籍,没有人会为您做(除非您当然雇用某人,除非去看Reedsy)。 无论如何,这是一篇巨大的博文。 有点大脑倾倒。 如果您想了解更多关于这里写的任何方面的信息,请感受到鼓励到达我的推特,乳房或媒体。 联系人在这篇文章下面。