- name: toc
  alias: table-of-contents
  tags:
    formats: ["!man", "!$docbook-all", "!$jats-all"]
  schema: boolean
  description:
    short: "Include an automatically generated table of contents"
    long: |
      Include an automatically generated table of contents (or, in
      the case of `latex`, `context`, `docx`, `odt`,
      `opendocument`, `rst`, or `ms`, an instruction to create
      one) in the output document. This option has no effect
      if `standalone` is `false`.

      Note that if you are producing a PDF via `ms`, the table
      of contents will appear at the beginning of the
      document, before the title.  If you would prefer it to
      be at the end of the document, use the option
      `pdf-engine-opt: --no-toc-relocation`.

- name: toc-depth
  tags:
    formats: ["!man", "!$docbook-all", "!$jats-all"]
  schema: number
  description: |
    Specify the number of section levels to include in the table of contents.
    The default is 3

- name: toc-location
  schema:
    enum: ["body", "left", "right"]
  default: "right"
  tags:
    formats: [$html-doc]
  description: |
    Location for table of contents (`body`, `left`, or `right` (default)).

- name: toc-title
  schema: string
  tags:
    formats: [$epub-all, $odt-all, $office-all, $pdf-all, $html-doc, revealjs]
  description: The title used for the table of contents.

- name: lof
  schema: boolean
  default: false
  tags:
    formats: [$pdf-all]
  description: Print a list of figures in the document.

- name: lot
  schema: boolean
  default: false
  tags:
    formats: [$pdf-all]
  description: Print a list of tables in the document.
