第 3 章 输出格式

bookdown 软件包主要支持三种类型的输出格式：HTML、LaTeX/PDF 和电子书。在本章中，我们将介绍这些格式的可能的配置项。输出格式可以在书籍的第一个 Rmd 文件中的 YAML 元数据中指定，也可以在书籍根目录下名为 _output.yml 的单独 YAML 文件中指定。以下是前者的简要示例（输出格式在 YAML 元数据中的 output 字段中指定）：

---
title: "一本令人印象深刻的书"
author: "李雷和韩梅梅"
output:
  bookdown::gitbook:
    lib_dir: assets
    split_by: section
    config:
      toolbar:
        position: static
  bookdown::pdf_book:
    keep_tex: true
  bookdown::html_book:
    css: toc.css
documentclass: book
---

这是 _output.yml 的示例：

bookdown::gitbook:
  lib_dir: assets
  split_by: section
  config:
    toolbar:
      position: static
bookdown::pdf_book:
  keep_tex: true
bookdown::html_book:
  css: toc.css

在这种情况下，所有格式配置都应该在顶层，而不是在 output 字段下。在 _output.yml 文件中你不需要这三个破折号 ---。