5  Quarto settings

5.1 Basic settings

Open the _quarto.yml file. Make sure it at least contains something like this:

Caution

This yaml is not complete nor validated. WIP!

project:
  type: book
  output-dir: ../docs           # When rendering, the html files will be 
                                # placed in the docs folder. The folder needs
                                # to be named docs in order for GitHub pages to work!

book:                           # Some general information about your book
  title: "[YOUR BOOK'S TITLE]"
  authors:                      # Book authors: add a new row for each new author
  - "NAME AUTHOR 1"
  - "NAME AUTHOR 2"
  
  date: "YYYY/MM/DD"            # Date of the book, you can also use 
                                # last-modified, or today (without quotes)
  
  chapters:                     # Table of contents
    - index.qmd                 # This is your landing page / homepage
    - YOUR-CHAPTER-1.qmd        # Make sure each chapter has its own .qmd file
    - part: NAME-PART           # Use part: if you want to add subchapters
      chapters:
        - YOUR-CHAPTER2.qmd
        - YOUR-CHAPTER3.qmd
    - YOUR-CHAPTER-4.qmd
    # etc.
    
    repo-url: https://github.com/YOUR-ORGANIZATION/YOUR-REPO-NAME
    repo-actions: [edit]            # TODO
    
    sidebar:                                    # TODO
        logo: path/to/your/logo.png

bibliography: references.bib    # If you use a reference manager, you can export
                                # a .bib file and include automatically formatted 
                                # references. Include the path to the .bib file here.
bibliostyle: apalike            # Citation style of bibliography
nocite: |                       # This means: even if you don't actively use all 
  @*                            # references in your book text, all entries in the 
                                # .bib file will be included in the bibliography.

format:
  html:
    theme: cosmo
  pdf:
    documentclass: scrreport
  epub:
    cover-image: cover.png

callout-appearance: simple