如何对现有的预订文档使用电子书函数epub_book和kindlegen()？

Question

我在github上找到了一些预订文档(即Hadley的R数据科学和有效R)，我想从源代码中构建这些文档作为电子书。这些文档都是用Bookdown编写的，它有两个函数，即epub_book()和kindlegen()来构建电子书(而不是github图书站点)，这样我就可以在Kindle上阅读这些书了。

我看过这些功能的预订文档，但不知道如何/在哪里使用这些函数来构建电子书文件和/或我需要编辑的代码中是否已经有输出选项。

Answer 1

它们是结构。你应该这样做

render_book("file.Rmd", epub_book())

来制作电子书。一些变量可以传递给epub_book()。

你可以看看https://bookdown.org/yihui/bookdown/。这是一本关于下订书的书。

Answer 2

您可以手动使用kindlegen()函数的方法如下：

1. 安装Kindlegen (这是一个来自亚马逊的免费命令行工具，用于将.epub转换为.mobi)。
2. 将Kindlegen的路径添加到path环境变量。
3. 运行Run，构建.epub版本(生成面板(默认情况下是右上角)> Build book > bookdown::epub_book (取决于您的_output.yml配置))。
4. 在您已经有了epub版本之后，在控制台面板(默认情况下是左下角部分)中，运行bookdown::kindlegen()。

Kindlegen将找出在哪里找到.epub版本，并将其转换为.mobi。

要将其添加到构建过程中，您的_build.sh可以如下所示(注意最后一行)：

#!/bin/sh

set -ev

Rscript -e "bookdown::render_book('index.Rmd', 'bookdown::html_book')"
Rscript -e "bookdown::render_book('index.Rmd', 'bookdown::pdf_book')"
Rscript -e "bookdown::render_book('index.Rmd', 'bookdown::epub_book')"
Rscript -e "bookdown::kindlegen()"

您的_output.yml需要为html_book、pdf_book、epub_book定义配置，如下所示：

bookdown::html_book:
  toc: yes
  css: style.css
  split_by: chapter
bookdown::pdf_book:
  includes:
    in_header: preamble.tex
  latex_engine: xelatex
  citation_package: natbib
  keep_tex: yes
  template: null
bookdown::epub_book: default

在此之后，Build book > All formats应该生成所有的HTML、PDF、EPUB和MOBI格式。