如何用Markdown创建电子书(附代码)

555 阅读2分钟

我目前有15本免费的书,我免费分享给订阅我的电子邮件通讯的人。

其中一些书已经是第二版了(关于JavaScript和React的书),因为技术发展很快,我们必须跟上。

第一本是2018年的。

在不久的将来,我想重新组织我的免费电子书收藏,重新审视其中一些,甚至可能添加新的。

自从我上次更新到美妙的2021 MacBook Pro 14 "后,我不得不再次在我的Mac上设置我的图书创作工作流程,所以我借此机会写了这篇文章。

我使用一个叫做 honkit.

它是另一个工具的分叉,这个工具叫gitbook ,我以前一直在用,但现在已经被废弃和抛弃很久了,不能再使用了。

honkit 很好用。它是一个免费的工具,可以用Markdown创建一本书,并生成一个PDF/ePub/Mobi版本。

我可以更新一本书,用一个命令就可以把它上传到我的网站,让CloudFlare分发。

据我所知,这是有史以来最简单的工具,能够生成所有这些书的版本。

其他一些工具也存在,但不具备所有这些能力。

这里是如何开始的。

创建一个文件夹,并在其中添加一个book.json 文件

{
  "author": "Your name",
  "title": "The book title"
}

创建一个cover.jpg ,用于封面的垂直图像。如果你也想制作ePub/Mobi版本,请添加一个cover_small.jpg

创建一个带有ToC的SUMMARY.md 文件:

# Summary

- [Preface](README.md)
- [First chapter](content/1-first.md)
- [Second chapter](content/2-second.md)

现在添加一个README.md 文件,这是序言的标记文件。

添加一个content/1-first.md ,那是第一章的标记文件。

以此类推。

现在下载Calibre并安装它(或者使用Homebrew(brew install --cask calibre on macOS)。

然后运行:

npx honkit pdf  ./ ./book.pdf
npx honkit epub ./ ./book.epub
npx honkit mobi ./ ./book.mobi

就这样,PDF、ePub和Mobi(Kindle)格式的书就会出现在文件夹里了。

还有一件事!⚠️ ✋

在一月底,我将组织网络开发训练营

这是一个为期10周的同学会在线课程,我将指导你成为一名Web开发人员。

这不仅仅是 "一个课程"。它是我每年组织一次的大型活动。

我们将从零开始,学习网络开发的基础知识,HTML,CSS,JavaScript,Tailwind,Node.js,然后我们将学习React,JSX,如何使用PostgreSQL,Astro,Next.js,Prisma等等

在前10周结束时,你将知道如何创建网站和网络应用程序,我将为你解锁Bootcamp的第二阶段:你将获得Bootcamp毕业生专属的大量项目,所以你可以按照我的指示建立像带有认证的私人区域,克隆Twitter YouTube Reddit等流行网站,创建电子商务网站,等等。

因为一旦你掌握了基础知识,你只能通过在真正的、令人兴奋的项目上工作来学习。