pandokoma-options.yaml

# Pandokoma configuration
#   metadata parameters to control the templates
#   these should only contain design choices,
#   not volume-specific information.
# based on:
# pandoc's default latex template by John MacFarlane <https://pandoc.org/>
# arabica by Martin Maga <https://github.com/periodicpoint/arabica>
# pandoc-latex-template by Pascal Wagler <https://github.com/Wandmalfarbe/pandoc-latex-template>
# by Karl Voigt <https://github.com/novoid/LaTeX-KOMA-template>

# GENERAL ADVICE
# ====================================================================
# When specifying LaTeX options in a field, in most cases you can either
# use strings, hyphenated lists, or bracketed lists:
# ```yaml
# classoptions: 'a4,onsided,landscape'
# classoptions:
# - a4,
# - onesided,
# - landscape
# classoptions: [a4, onsided, landscape]
# ```
# 
# When specifying a LaTeX command in a field, in most cases you 
# can enter them directly as they are in LaTeX, e.g."
# ```yaml 
# definition: \upshape\bfseries
# ```
# 
# However if a field's value contains `:` or `#` it should be put in quotes. 
# But bewar, in quotes the backslash character `\` is interpreted an escape. 
# Other characters like `{`,`}`,`[`,`]` may be wrongly escaped. 
# When in doubt, you can ensure that the field is interpreted literally
# by using Pandoc's Raw Block syntax: 
# ```yaml
# definition: ```{=latex}
#             <LaTeX command with special symbols here>
#             ```
# ```
# Or Pandoc's Raw Inline syntax:
# ```yaml
# definition: `<LaTeX command with special symbols>`{=latex}
# ```
#
# Check Pandoc's LaTeX output to verify that your command appears correctly. 

# BASIC SETTINGS
# ====================================================================

# language, identifies the main language of the document, (polyglossia-lang)
# default: 'en'
lang: 'en'

# the base direction of the document, either rtl (right-to-left) or ltr
# (left-to-right). When using LaTeX for bidirectional documents, only the
# xelatex engine is fully supported (use --pdf-engine=xelatex).
# default: 'ltr'
dir: 'ltr'

# documentclass: LaTeX document class, e.g. article, report, book, memoir, 
# scrbook, scrreprt, scrartcl. 
# You should normally choose one of the KOMA classes: scrbook, scrreprt
# scrartcl.
documentclass: 'scrbook'

# option for document class, e.g. titlepage, oneside; may be repeated for
# multiple options.
# some exmaple options:
#  11pt,%------------------------to have a document with font size: 11pt
#  paper=a4,%----------------to have a document with real paper size: a4
#  pagesize,%to have a virtual page size that is equal to the paper size
#  twoside,%-------------------------to print on both sides of the paper
#  %oneside,%-----------to “print” just on one side of digitaly pdf page
#  BCOR=2mm,%--------------------------to reserve 2mm binding correction
#  openright,%--------------------to open new chapters on the right side
#  titlepage=firstiscover%--- to make the first page a cover/ image page
# ]{scrbook}%---------------------to use the koma-script class "scrbook"
# defaults:
#  - 'papersize=a4'
#  - 'fontsize=11pt'
#  - 'twoside'
#  - 'twocolumn'
#  - 'parskip=full'
classoption:
  - 'twoside'
  - 'onecolumn'
#  - 'twocolumn'

# komaoptions (alias komaoption)
# list of option / value maps
komaoptions:
- option: headings
  value: optiontoheadandtoc

# longtablefix
# A fix to allow tables within two columns. The fix is crude:
# it turns tables into figure environments, which end up
# floating. This will break some designs. 
# default false
longtablefix: false

# has-frontmatter
# set this to true for your LaTeX document to be divided in
# \frontmatter, \mainmatter, \backmatter
# default: false
has-frontmatter: false

# mainmatter
# If not specified or false, the template will automatically
# place the \mainmatter command after titles.
# If set to true, you need to place the \mainmatter command yourself.
# This is useful to separate a preface (and other frontmatter material
# other than toc, list of figures and list of tables) from the main matter.
# default: 
mainmatter:

# GEOMETRY
# ====================================================================

# ragged bottom or flush bottom. LaTeX's default `flushbottom`
# vertically stretches the text to the bottom of the page. Classical
# typography recommends rather an even separation between lines; this
# may result in textblock that don't occupy the full vertical space
# (ragged bottom). Flush bottom is preferable for e.g. text that 
# includes a lot of equation.
# Default: `raggedbottom`. Set `flushbottom: true` to revert
# to the flushbottom mode. 
raggedbottom: true
flushbottom: false

# newlength, setlength
# define new LaTeX lengths, or set existing ones.
# NB: the Pandoc template sets a few lengths of its own. You can over-
# ride these settings using setlength here. 
newlength:
- length: gridbaseline
  value: 12pt
- length: chapterwithsubtitleskip 
  value: 18pt plus 4pt minus 2pt
- length: chapterwithoutsubtitleskip 
  value: 6pt plus 1pt minus 1pt
- length: chapterskip
  value: 25pt plus 2pt minus 1pt
- length: toctitleskip
  value: 12pt plus 2pt minus 1pt
setlength:
- length: parindent
  value: 2pt

# geometry. Options for the geometry package. Use a list to set multiple
# options.
# Example:
# geometry:
# - "margin=1in"
# - "centering"
# default:
geometry:

# sets margins, if geometry is not used (otherwise geometry overrides these)
# default:
margin-left:
margin-right:
margin-top:
margin-bottom:

# adjusts line spacing using the setspace package, e.g. 1.25, 1.5
# default:
linestretch:

# frenchspacing
# use french spacing (normal interword spaces after dots).
frenchspacing:


# Footnotes
# --------------------------------------------------------------------  

# deffootnote. Choose markwidth (opt), indent, paragraph intend and the
# definition of the footnotemark. See KOMA's manual.
# Example (KOMA's default):
# deffootnote:
#   markwidth: 1em
#   indent: 1.5em
#   parindent: 1em
#   definition: \textsuperscript{\thefootnotemark}
deffootnote:

# set footnote rule. Choose thickness and width.
# setfootnoterule:
#   thickness: 1pt
#   width: \textwidth
setfootnoterule:

# Divisions: formatting headings, page headers, toc entries
# --------------------------------------------------------------------  

# raggedpart, raggedchapter, raggedsection. LaTeX commands to set the 
# alignement of sections, chapter and part headings---see KOMA manual.    
raggedpart: \centering
raggedchapter: \centering
raggedsection: \raggedright
# partformat, chapterformat, sectionformat, ..., subparagraph format.
# LaTeX commands to format the headings counters.
# Example:
# partformat: \thepart\autodot
partformat:
chapterformat:
sectionformat:
subsectionformat:
subsubsectionformat:
paragraphformat:
subparagraphformat:
# declaresectioncommand, redeclaresectioncommand, declarenewsectioncommand,
# providesectioncommand. 
# Set a sectioning command (predefined like \section
# or custom like \mydivision) and its attributes such as the heading's
# font, indentation etc. but also the way the division is styled in 
# the table of contents. Use a map to set one sectioning command, or
# a list of maps to set several. In each map the `element` key is the 
# sectioning command's name (e.g. `section`, `paragraph`, `mydivision`).
# and the other fields are KOMA attributes. 
# Available KOMA attributes: counterwithin, counterwithout, expandtopt,
# level, style, tocstyle, tocafterpar, tocbeforeskip, tocbreakafternumber,
# tocdynindent, tocentry, tocentryformat, tocentrynumberformat,
# tocindent, toclevel, tocindentfollows, toclinefill, tocnumsep, 
# tocnumwidth, toconendentry, toconendlastentry, toconstartfirstentry, 
# toconstarthigherlevel, toconstartlowerlevel, toconstartsamelevel, 
# tocpagenumberbox, tocpagenumberformat, tocpagenumberwidth, 
# tocprepagenumber, tocraggedentrytext, tocraggedpagenumber, 
# tocraggedright, tocraggedindent, afterindent, afterskip, beforeskip,
# font, innerskip, pagestyle, prefixfont, indent, runin.
#
# Example:
# redeclaresectioncommand:
# - element: section
#   font: \usekomafont{mydisplayfont}
#   indent: 2em
#   afterindent: true
# - element: subsection
#   font: \normalfont
#   indent: 1em
# providesectioncommand:
# - element: chapter
#   ...
#   
declaresectioncommand:
redeclaresectioncommand:
declarenewsectioncommand:
providesectioncommand:

# Page styles
# --------------------------------------------------------------------

# to manage text 'layers' within koma-script
# default:
scrlayer: false

# scrlayer-scrpage. Load KOMA's package to define and manage page styles 
# (see "fancyhdr" too). 
# default: false
# autooneside. Set scrlayer-scrpage's autooneside option (true or false).
# default: false
# NB: autooneside is automatically set to true if scrheadings commands 
# are used (ohead, ihead, chead, etc., see below).
scrlayer-scrpage: true
autooneside: 

# to control note columns parallel to the main text
# to set side note column you need pkg "scrlayer-notecolumn"
# you may want to set: \setkomafont{notecolumn.marginpar}{\footnotesize}
# default:
scrlayer-notecolumn:
# default: '\footnotesize'
notecolumnfontsize: '\footnotesize'

# scrheadings
# use KOMA's scrheadings to manage page headers and footers.
# Automatically set to true if one of the scrheadings commands (chead,
# etc.) is used.
scrheadings:

# scrheadings commands
# ohead, chead, ihead, lehead, cehead, rehead, lohead, cohead, rohead
# ofoot, cfoot, ifoot, lefoot, cefoot, refoot, lofoot, cofoot, rofoot
# Set header and footer components.
# c----: center header/footer on recto and verso pages
# o----: outer header/footer, left of left pages and right on right pages
# i----: inner header/footer, right of left pages and left on right pages
# le----: left header/footer on even (verso, left) pages
# ce----: center header/footer on even (verso, left) pages
# re----: right header footer on even (verso, left) pages
# lo----: left header/footer on odd (recto, right) pages
# co----: center header/footer on odd (recto, right) pages
# ro----: right header/footer on odd (recto, right) pages
#
# You may specify a string only. Example:
# chead: \automark
# ohead: \thepage
# This will set the header/footer of pages in the "scrheadings" style, 
# not plain pages (like an article title page or a chapter title page).
# To set the header/footer of the plain title page, you should specify
# a `plain` and `headings` keys instead. Example:
# cfoot:
#   plain: \relax
#   headings: \automark
# Cf KOMA's manual for more details. Starred versions not available yet.
ohead:
chead:
ihead:
lehead:
cehead:
rehead:
lohead:
cohead:
rohead:
ofoot:
cfoot:
ifoot:
lefoot:
cefoot:
refoot:
lofoot:
cofoot:
rofoot:


# FONT MANAGEMENT
# ======================================================================

# allows font encoding to be specified through fontenc package (with pdflatex); 
# default is T1 (see guide to LaTeX font encodings)
# default:
fontenc:

# font package for use with pdflatex; TeX Live includes many options,
# documented in the LaTeX Font Catalogue. The default is Latin Modern.
# default: latin modern (\usepackage lmodern)
fontfamily: 'libertine'

# options for package used as fontfamily; e.g. osf,sc with fontfamily set to
# mathpazo provides Palatino with old-style figures and true small caps; may be
# repeated for multiple options
# default:
fontfamilyoptions:

# advanced font selection in XeLaTeX and LuaLaTeX
# enable system font access (needed by XeLaTex).
# automatically set to true if `mainfont`, `mathfont`,
# `sansfont`, `monofont` or `CJKmainfont` is set.
# for: \setmainfont{...}, \setsansfont{...}, \setmonofont{...}
# and  \setmathfont{...} see option "mainfont".
# default: false
# 
fontspec: 

# font families for use with XeLaTeX or LuaLaTeX take the name of any system
# font, using the fontspec package. Note that if CJKmainfont is used, the xecjk
# package must be available.
mainfont: 'Libertinus Serif'
sansfont: 'Libertinus Sans'
monofont: 'Libertinus Mono'
mathfont: 'Libertinus Math'
CJKmainfont:

# options to use with mainfont, sansfont, monofont, mathfont, CJKmainfont in
# xelatex and lualatex. Allow for any choices available through fontspec, such
# as the OpenType features Numbers=OldStyle,Numbers=Proportional. May be
# specified as string or list.
# default:
mainfontoptions:
sansfontoptions:
monofontoptions:
mathfontoptions:
CJKoptions:

# KOMA font elements. Set, create, add to and alias KOMA fonts.
# `setkomafonts`, `addtokomafonts`, `newkomafonts`, `aliaskomafonts`
# are lists, one item per font. You can't repeat the options, have just
# one `setkomafonts` per document metadata. The lists have one item
# per font element, each item has several fields named after KOMA's manual.  
# The fields 'default(s)', 'command(s)' are equivalent and can
# be specified as string or list. (Except for `addtokomfonts` 
# that doesn't accept `default(s)`.)
# The fields `font` and `fontoptions` place the commands
# \normalfont\setmainfont[<fontoptions]{<font>} before your commands,
# ensuring the element uses that font. 
# In `newkomafonts`, the field `aliases` allows you to provide aliases
# for your element as it's created. Aliases must be provided as a list,
# e.g. [mydisplay,mydisplayfont]
# Examples:
# newkomafonts:
# - element: displayfont
#   font: 'Optima'
#   commands: '\bfseries' # 'default', 'defaults', 'command' work too
#   warning: 'The displayfont element already exists'
# setkomafonts:
# - element: chapter
#   commands: \usekomafont{displayfont}
# - element: disposition
#   font: 'Times New Roman'
#   fontoptions: 'Numbers=OldStyle'
#   default: /bfseries
# aliaskomafonts:
# - element: displayfont
#   aliases: [display,mydisplay]
# KOMA's default disposition is sans serif, we turn it to the main font
# by default.
setkomafonts:
- element: disposition
  defaults: \normalfont\bfseries

# Declare Unicode Char. Provide Unicode chars by code.
# Example:
# declareunicodechar:
# - char: '8000'
#   command: \symbol{"03BF}\symbol{"0343}
# Warning: entering LaTeX hexadecimal numbers `"1F40" is risky,
# as Pandoc converts the quotation marks. Use decimal Numbers for
# the code, and use `\symbol{"03BF}` instead of `\char"03BF`.
declareunicodechar:

# New Unicode Char. Provide Unicode chars by char.
# Example:
# newunicodechar:
# - char: ὀ
#   command: \symbol{"03BF}\symbol{"0343}
# Warning: don't use `\char"03BF` as Pandoc converts the quotation
# marks. Use `\symbol{"03BF}` instead.
newunicodechar:


# Unicode from math. Provide unicode characters in the main
# font using those available in the math font.
# Don't forget to use quotes if `char` is an HTML entity.
# Example:
# unicodefrommath:
# - char: ∴
#   command: \therefore
# - char: '&rarr;'
#   command: \rightarrow
# This loads the package `newunicodechar` and issues 
# commands like:
# \newunicodechar{∴}{\ensuremath{\therefore}}
unicodefrommath:

# options to pass to the microtype package
# the microtype package is loaded automatically if available
# default: 'final'
microtypeoptions: 'final'

# TITLEPAGE(S) SETTINGS
# ======================================================================

# Do not use `\maketitle`
# Title pages are normally generated by LaTeX's `\maketitle` command
# If you don't want title pages at all, or if you provide raw code
# that does not use `\maketitle`, set this to `true`
# default: false
nomaketitle: 

# Title templates
# choose one of the predefined template by setting one of these 
# to true (the first one set to true will be used).
# If all false, we use a simple default KOMA template.
titletemplate-A: true
titletemplate-B: false

# Raw title code
# You can specify all of KOMA's title code in one field here.
# If `maketitle` is true this will be placed in the preamble;
# if false this is placed at the beginning of the document
# (before `\frontmatter`). 
# Usage of a rawblock is recommended. Remember to indent all lines.
# Example using maketitle:
# rawtitlecode: |
#  ```{=latex}
#  \extratitle{...}
#  \title{...}
#  ...
#  \dedication{...}
#  ```
# Example replacing maketitle:
# rawtitlecode: |
#  ```{=latex}
#  \begin{titlepage}
#  ...
#  \end(titlepage}
#  ```
rawtitlecode:

# Field-by-field specifiation
# Note: this is volume-specific, better specified in your volume's meta

# LEGACY
# default: true
extratitle: true

# give path here if you want to include a logo or graphic in your title page(s)
# example: './titlepage/dummygraphic.pdf'
titlepage:
  graphic: #'./graphics/dummygraphic.pdf'
  logo: #'./graphics/dummylogo.pdf'

# activate / deactivate display of your abtsract text
# the classoption "abstract" only specifies if the (language dependent) heading
# "Abstract" is displayed or not.
# default: true
display_abstract: true

# include table of contents (can also be set using --toc/--table-of-contents)
# default: true
toc: true

# if you want to have a onecolumn table of contents even if your document is
# in twocolumn,then set this option to true.
# if true, loading pkg "multicol" is mandatory
# default: false
onecol_toc: false

# level of section to include in table of contents
# default: 2
toc-depth: 2

# HYPEREF: BOOKMARKS AND LINKS
# ======================================================================


# style links: color links or linksborder
# add color to link text; automatically enabled if any of linkcolor, citecolor, 
# urlcolor, or toccolor are set (see pkg/ option "xcolor")
# default: true
colorlinks: true
# color for internal links, citation links, external links, and links in table 
# of contents; uses options allowed by xcolor, including the dvipsnames,
# svgnames, and x11names lists
# default:
linkcolor:
citecolor:
urlcolor:
toccolor:
# linksborderstyle
#   see hyperref manual for possible values
linksborderstyle: 
# linksborder (deactivated if `colorlinks` is true or `linksborderstyle` is set)
# See Adobe's PDF spec: do not specify a unit, all are in default user units. 
# Support varies across PDF viewers, try Acrobat if needed.
# Example (hyperref's default values except for dash pattern):
# linksborder:
#   vcornerradius: 0
#   hcornerradius: 0
#   width: 1
#   dash-pattern: '3 2'
# If you only specify colorlinks=false links will have no decoration at all.
linksborder:
# color of links borders, as in the links color options.
# can be specified as names or as RGB eg '1 0 0' for red
linkbordercolor:
citebordercolor:
urlbordercolor:
tocbordercolor:

# urlstyle
# default `same`: don't use monospace font for links
urlstyle: same

# Bookmarks 
# In PDF output bookmarks are generated by default.
# Use `suppress` to suppress them.
#  
# See hyperref manual for details.
bookmarks:
  suppress: # true to suppress
  depth: # number (1) or name ('subsection'), depth of bookmarks; uses tocdepth by default
  open: # true to show them with all subtrees expanded when doc is opened
  openlevel: # number, show with all subtrees expanded up to level n
  open-level: # alias of openlevel
  numbered: # true to number bookmarks
  type: # which toc file to mimic, e.g. if 'main' will mimic file 'main.toc'
  cjk: # true to produce cjk bookmarks
  CJK: # alias of cjk



# PANDOC INCLUDES
# ======================================================================
# ======================================================================
# to include before the document's body (eg in the LaTeX preamble)
header-includes: 

# to include after the title and `\frontmatter`, before standard toc
include-before:

# to include after the document's body and `\backmatter`
include-after:

# DEFAULT PACKAGES
# ======================================================================

# causes links to be printed as footnotes
# default:
links-as-notes:

# EXTRA PACKAGES
# ======================================================================

# to load extra latex packages
# list with one package per entry. Just the package name,
# or a map `package: <pkgname>` `options: '<pkgoptions>'`.
# Example:
# - selnolig
# - package: pgfmolbio
#   options: 'chromatogram'
latex-packages:

# to mix onecolumn and twocolumn modes for example for wide equations.
# usage: \begin{strip}...\end{strip}
# default: true
cuted: true

# for url-sensitive linebreaks (needed by XeLaTex)
# default:
url:

# for fitch-style natural deduction proofs
# default:
lplfitch:

# for advanced math typesetting (loads all default math pkg)
# if you set this option all the folowing packages will be loaded automatically
# except for: package "amssymb" and "amsmath" because they are loaded
# automatically.
# mathematical tools to use with amsmath
# \usepackage{mathtools}
# ams mathematical facilities for LaTeX
# \usepackage{amsmath}# possibly loaded loaded somewhere else too
# TeX fonts from the american mathematical society
#  \usepackage{amsfonts}
# additional mathematical symbols
# \usepackage{amssymb}# possibly loaded loaded somewhere else too
# typesetting of custom theorems (in ams style)
#  \usepackage{amsthm}
# dirac bra-ket and set notations
#  \usepackage{braket}
# for numbered cases (mappings) environment
#  \usepackage{cases}
# for proof trees in the style of the sequent calculus
#  \usepackage{bussproofs}
# default: true
math: true

# to create (tabular cells spanning) multiple rows
# default: false
multirow:

# to create (tabular cells spanning) multiple columns (load before pkg "bidi")
# default: false
multicol: 

# to create continuation headings and legends for floats
# default: false
ccaption:

# to inlcude images (.pdf, .eps, .png). Loads `graphicx` and `grffile`
# default: false
# automatically set to true if the document contains images
graphics: 

# to scale graphics relative to reference object (needs pkg "graphicx")
# usage: \scalerel*{\includegraphics{inlinegraphic.pdf}}{O}
# default: true
scalerel: true

# to allow text to flow around graphics
# default:
wrapfig:

# to insert pictures into paragraphs (see pkg "picins")
# default:
picinpar:

# for driver-independent color extensions (see option "colorlinks")
# the package xcolor is loaded automatically if colorlinks are set
# default:
xcolor:
# default:
xcoloroptions: [dvipsnames,svgnames,x11names]

# define colors (implies `xcolor`: true)
# List. Each color is an item with `type` (opt), `name`, `model`, `spec`.
# The specification can be given as a string or list; if the latter
# it will be turned into a comma-separated list. Multiple models and
# specs can be given (as strings only). See `xcolor`'s documentation.
# Example:
# definecolors
# - name: myblue
#   model: RGB
#   spec: [30, 0, 100]
definecolors:

# to create postscript and pdf graphics in TeX (see pkg "tikz")
# default:
pgf:

# for drawing functions in LaTeX
# you may want to use specific tikz libraries e.g.:
# \usetikzlibrary{shapes,arrows,chains,positioning,fit,automata}
# can be specified as one string or a list
# default:
tikz:
# default:
usetikzlibrary:

# to not interpret latex commands but display them (see pkg "upquote")
# default:
verbatim:

# to typeset dropped capitals
# default:
lettrine:

# nowidow: load the `nowidow`package to avoid widows
# set this to true to use the `nowidow` package 
nowidow: 
# nowidow options
# list of options for the nowidow package
nowidowoptions:

# to generate lorem ipsum blind text text for testing purposes
# default:
blindtext:

# to generate sentences in kant's style for testing purposes
# default:
kantlipsum:

# to draw frame around pages to see margin changes for testing purposes
# default:
showframe:

# proofmode: set to true to print a "PROOF" watermark
# and line numbers. Shorthand for the `draftwatermark`
# and `linenumbers` field below.
proofmode:

# drafwatermark: set to yes to add a watermark
draftwatermark:
# draftwatermark options: list of options 
# for the draftwatermark package. See package
# documentation for details.
# Example:
# draftwatermarkoptions:
#   - 'firstpageonly'
#   - 'stamp=false'
#   - 'titlepage'
draftwatermarkoptions:

# linenumbers: line numbering with the lineno package
# linenumbersoptions: options for the lineno package
# aliases: 'lineno', 'linenooptions'
linenumbers: 

# to include the creative commons icons in my document
# default:
ccicons:

# float (load pkg "float" before pkg "hyperref")
# default:
float:

# COMMON PANDOC SETTINGS
# ======================================================================

# uses document class settings for indentation (the default LaTeX template
# otherwise removes indentation and adds space between paragraphs)
# default:
indent: 

# disables default behavior of LaTeX template that redefines (sub)paragraphs as
# sections, changing the appearance of nested headings in some classes
# default:
subparagraph:

# to activate numbered headings
# default: true
numbersections: true
# numbering depth if sections are numbered 
#   (setting this does not active section numbering on its own)
#   Pandoc's default is 5
# default: 3
secnumdepth: 3

# include list of figures, list of tables
# default: false
lof: false
# default: false
lot: false

# cross-referencing:
# create auto section labels with autoSectionLabels
# link references with linkReferences 
# default: both true
autoSectionLabels: true
linkReferences: true

# an option for LaTeX’s \pagestyle{}. The default article class supports
# ‘plain’ (default), ‘empty’, and ‘headings’; headings puts section titles in
# the header. 
# default: 
pagestyle: 'headings'
# set pagestyle (needs pkg "scrlayer-scrpage")
# default: 
scrheadings:

# BIBLIOGRAPHY
# ======================================================================

# Citeproc citation style
# example: './csl/chicago-author-date-de.csl'
# if no csl specified, Pandoc uses the chicago author-date style
# uncomment to specify a CSL file (empty value would cause an error).
# csl: 

# Citeproc link citations
# default: true
link-citations: true

# bibliographic database
#   if you use a global bibliography database for all your documents
#   you could specify it here. Otherwise this is volume-specific
#   information, best placed in a different file than design. 
bibliography: 
# if you want to print out all items in your bibliography file regardles of
# you mentioned them in your project, then uncomment the following 2 lines.
# default: # (commented out)
# nocite: |
#   @*

# if you want to have a custom title for your bibliography specify it here
# default:
reference-section-title:

# bibliography style, when used with --natbib and --biblatex.
# default:
biblio-style:

# bibliography title, when used with --natbib and --biblatex.
# default:
biblio-title:

# list of options for biblatex.
# default:
biblatexoptions:

# list of options for natbib.
# default:
natbiboptions:

# EXTRA SETTINGS
# ======================================================================

# to inject hyperref compatible metadata into the pdf
# default:
hyperxmp:

# to make TeX less fussy about line breaking
# default
sloppy: