Ibis 电子书制作工具
发布于 作者: Eric L. Barnes
Ibis 是 Mohamed Said 开发的一款新应用,可以帮助您将 Markdown 文件发布为电子书,并提供生成明暗两种主题电子书的功能,以及自定义字体等更多功能。
Ibis 从您的 Markdown 文件生成电子书,包含以下内容:
- 封面照片。
- 可点击的自动生成的目录。
- 代码语法高亮。
- 提供两种主题:明暗主题。
以下是在 Mohamed 的新电子书 Laravel Queues in Action 中使用示例的两种模式。
让我们看看如何使用 Ibis 创建自己的电子书。
Ibis 安装
要开始使用 Ibis 发布您的第一本书,请先运行安装命令:
composer global require themsaid/ibis
接下来,创建一个目录来存放您的电子书:
ibis init
运行 init 命令后,您将拥有以下目录结构:
/assets/assets/fonts/assets/cover.jpg/assets/theme-light.html/assets/theme-dark.html/content/ibis.php
创建您的第一本书
现在您已经准备好了基本设置,第一步是编辑 ibis.php 文件,它是一个设置数组。
<?php return [ /** * The book title. */ 'title' => 'My First Ebook', /** * The author name. */ 'author' => 'Eric L. Barnes', /** * The list of fonts to be used in the different themes. */ 'fonts' => [// 'calibri' => 'Calibri-Regular.ttf',// 'times' => 'times-regular.ttf', ], /** * Page ranges to be used with the sample command. */ 'sample' => [ [1, 3], ], /** * A notice printed at the final page of a generated sample. */ 'sample_notice' => 'This is a sample from "My First Ebook" by Eric L. Barnes. <br> For more information, <a href="https://news.laravel.net.cn/">Click here</a>.',];
注意: 字体部分已注释。如果您想使用自己的字体,请将 .ttf
文件添加到 assets/fonts
目录中,并在配置中指向文件名。
创建您的内容
下一步是使用 Markdown 创建您的内容。您可以创建一个大型的 Markdown 文件,或者将其分成章节或部分。需要注意的是,当您构建电子书时,它会按字母顺序扫描 content
目录,因此您应该遵循一个命名模式,将内容按您的书籍顺序排列。例如,在我的演示书籍中,我将文件名命名为:
./1-introduction.md./chapter1.md./chapter2.md
准备好所有文件后,就可以添加电子书封面图像。此图像应大约为 2481 × 3508 像素,并放置在 ./assets 目录中,命名为 cover.jpg
完成上述操作后,您可以通过运行以下命令来构建书籍的第一个版本:
ibis build
默认情况下,这将创建一个明暗主题版本,您也可以使用以下命令创建一个暗主题版本:
ibis build dark
生成的 PDF 将包含封面图像和目录,并放置在您的 ./export/
文件夹中。
生成示例电子书
现在您已经掌握了生成用于发布的电子书的基本知识,您可能希望将电子书出售,但也想免费赠送某些部分作为样本。在这种情况下,Ibis 可以帮助您生成样本。再次打开 ./ibis.php
文件,向下滚动并编辑 sample 和 sample_notice 部分。
'sample' => [ [1, 3],], /** * A notice printed at the final page of a generated sample. */'sample_notice' => 'This is a sample from "My First Ebook" by Eric L. Barnes. <br> For more information, <a href="https://news.laravel.net.cn/">Click here</a>.',
在这里,您可以定义要导出的示例页面以及要在书籍末尾显示的提示。这将允许您导出某些章节或部分,并附带购买完整版或其他提示的链接。要生成此内容,您只需运行以下命令:
ibis sample
它将进行处理,并将此示例 PDF 放置在同一个 export 文件夹中。
总结
希望这能为您提供对 Ibis 及其工作原理的快速概述。我有幸使用它来构建一本名为“您的第一个 Laravel 应用”的电子书,并且当您加入我们的每周 Laravel 新闻稿 时,我会免费赠送这本书。您还应该查看 Mohamed 的 Learn Laravel Queues,并在您想发布下一本电子书时尝试使用 Ibis。它是一款简单但功能强大的应用。