pandocomatic.yaml

# --------------------- Pandocomatic templates -------------------
# Remember: YAML requires SPACES NOT TABS, and indentation is
# important!!! Paths are relative to the Pandoc data dir; you can also
# use ./ to make them relative to the working directory.
settings:
  recursive: true
  follow-symlinks: false
  skip: ['.*', 'pandocomatic.yaml']
  match-files: 'first'
#-----------------------------------------------------------------
templates:
#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: GENERAL ::::::::::::::::::::::::::::
#-----------------------------------------------------------------
#-----------------------------------------------------------------CROSSREF
  crossref: # note crossref should come before citeproc!
    preprocessors: [preprocessors/fixCrossref.rb] # allows to put crossref labels in styled captions
    pandoc:
      verbose: true # verbose by default
      filter: pandoc-crossref # process crossrefs
    metadata:
      linkReferences: true
#-----------------------------------------------------------------INDEXING
  indexing: # use indexing filter
    pandoc:
      lua-filter: convertIndex.lua
    metadata:
      doindex: true
#-----------------------------------------------------------------CITEPROC
  refs:
    pandoc:
      verbose: true # verbose by default
      citeproc: true
      bibliography: Core.json #JSON faster than BIB, symlinked within Pandoc data dir
      csl: csl/apa-ian.csl
      citation-abbreviations: cite-abbr.json # some journal abbreviations
      reference-links: true
    metadata:
      notes-after-punctuation: false
      link-citations: true
      link-bibliography: true
      csl-hanging-indent: true
#-----------------------------------------------------------------BIBLATEX
  biblatex:
    pandoc:
      verbose: true           # Verbose by default.
      biblatex: true            # Enable biblatex
      to: latex               # Has to be LaTeX output
      standalone: true        # Generate full document
      bibliography: Core.bib # The name of the bib-file.
    metadata:
      biblatexoptions: []
      biblio-title: Bibliography # see variables for latex
      biblio-style: []
#-----------------------------------------------------------------NATBIB
  natbib:
    pandoc:
      verbose: true           # Verbose by default.
      natbib: true            # Enable natbib
      to: latex               # Has to be LaTeX output
      standalone: true        # Generate full document
      bibliography: Core.bib # The name of the bib-file.
    metadata:
      biblio-title: Bibliography # see variables for latex
      biblio-style: numeric
#-----------------------------------------------------------------JATS
  jats:
    extends: [refs]
    pandoc:
      from: markdown
      to: jats
      standalone: true
      lua-filter:
        - filters/pagebreak.lua
        - filters/abstract-section.lua
        - filters/pretty-urls.lua
#-----------------------------------------------------------------PLAIN TXT
  plain:
    pandoc:
      from: markdown
      to: plain
      template: templates/custom.plain
      standalone: true
      verbose: true
      wrap: auto
      columns: 80
      tab-stop: 4
      eol: lf
      preserve-tabs: true
      filter:
        - filters/prependAbstract.rb #prepends abstract: metadata into the text
        - filters/prependAll.rb #prepends institute:, comments: and keywords: metadata into the text
        - filters/prependAuthor.rb #prepends authors
      lua-filter:
        - filters/modifyHeadings.lua #makes headings stand out a bit more
#-----------------------------------------------------------------PLAIN REFS
  plain-refs:
    extends: [plain,refs]
#-----------------------------------------------------------------PLAIN CROSSREF
  plain-refs-crossref:
    extends: [plain,crossref,refs]
#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: ICML :::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
  icml:
    pandoc:
      from: markdown
      to: icml
      standalone: true
      template: templates/custom.icml
      verbose: true
#-----------------------------------------------------------------
#::::::::::::::::::::::::::: TYPST :::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
#-----------------------------------------------------------------Standard
  typst:
    preprocessors: [preprocessors/removeImageDimensions.rb] 
    pandoc:
      verbose: true
      from: markdown
      to: typst
      standalone: true
      template: custom.typst
      table-of-contents: true
      metadata-file: typst-plain.yaml
      wrap: none
      lua-filter:
        - filters/typstFix.lua
        - filters/convertIndex.lua
        - filters/list-table.lua
        - filters/pagebreak.lua
        - filters/abstract-section.lua
        - filters/pretty-urls.lua
    metadata:
      doindex: false
#-----------------------------------------------------------------
  typst-refs:
    extends: [typst,refs]
    pandoc:
      to: typst-citations
#-----------------------------------------------------------------
  typstpdf:
    extends: typst-refs
    cleanup: [postprocessors/typst2pdf]
#-----------------------------------------------------------------
  typst-full:
    extends: [crossref,typst-refs]
    metadata:
      doindex: true
#-----------------------------------------------------------------
  typst-nativerefs:
    extends: typst
    pandoc:
      to: typst
      bibliography: Core.bib
      csl: csl/apa-ian.csl
#-----------------------------------------------------------------
  lapreprint:
    extends: typst
    pandoc:
      to: typst
      template: lapreprint.typst
      toc: false
    metadata:

#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: DOCX :::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
#-----------------------------------------------------------------DOCX
  docx:
    pandoc:
      from: markdown
      to: docx
      standalone: true
      filter:
        #- filters/removeHR #remove horizontal rules
        - filters/prependAll.rb # prepends institute:, comments: and keywords: metadata into the text
        - filters/simplifyMetadata.rb #collapse down metadata "author: [name: affiliation:]" to author:
      lua-filter:
        - filters/convertIndex.lua # enable indexing
        - filters/pagebreak.lua # use \newpage{} also for HTML, DOCX, ODT & EPUB
        - filters/abstract-section.lua # move an abstract heading to metadata
        - filters/pretty-urls.lua # clean up URLs a bit
      reference-doc: templates/custom.docx
#-----------------------------------------------------------------DOCX REFS
  docx-refs:
    extends: [docx,refs]
#-----------------------------------------------------------------DOCX standard fonts
  docx-refs-calibri:
    extends: [docx-refs]
    pandoc:
      reference-doc: templates/custom-calibri.docx
#-----------------------------------------------------------------DOCX REFS
  docx-letter:
    extends: [docx-refs]
    pandoc:
      reference-doc: '/Users/ian/Library/CloudStorage/Dropbox/Work/CAS-Letterhead-2.docx'
#-----------------------------------------------------------------DOCX CROSSREF
  docx-crossref:
    extends: [docx-refs,crossref]
#-----------------------------------------------------------------DOCX NUMBERING
  docx-native-numbering:
    extends: [docx,refs]
    pandoc:
      to: docx+native_numbering
#-----------------------------------------------------------------DOCX REFS NOLINK
  docx-refs-not-linked:
    extends: [docx,refs]
    metadata: 
      link-citations: false
#-----------------------------------------------------------------DOCX ENDNOTE
  docx-endnote:
    extends: [docx,refs]
    preprocessors: 
      add: preprocessors/convertEndnoteRefs.rb  #turns endnote citations to pandoc citations
#-----------------------------------------------------------------DOCX CHANGES
  docx-changes:
    extends: [docx,refs]
    preprocessors: 
      add: preprocessors/criticmarkup.rb #process criticmarkup to HTML that pandoc can use
#-----------------------------------------------------------------ODT
  odt-refs:
    extends: [docx,refs]
    pandoc:
      to: odt
      reference-doc: templates/custom.odt
#-----------------------------------------------------------------ODT standard fonts
  odt-refs-calibri:
    extends: [docx,refs]
    pandoc:
      to: odt
      reference-doc: templates/custom-calibri.odt
#-----------------------------------------------------------------
#:::::::::::::::::::::::: PRESENTATIONS ::::::::::::::::::::::::::
#-----------------------------------------------------------------
# Note for reveal.js standalone download the files  and put them 
# in a reveal.js/ folder relative to the markdown file.
#   wget https://github.com/hakimel/reveal.js/archive/master.tar.gz
#   tar -xzvf master.tar.gz
#   mv reveal.js-master reveal.js
  revealjs:
    extends: [refs]
    pandoc:
      from: markdown
      to: revealjs
      toc: true
      lua-filter:
        - filters/pretty-urls.lua # clean up URLs a bit
    metadata:
      revealjs-url: http://lab.hakim.se/reveal-js
      slideNumber: true
      transition: fade # none/fade/slide/convex/concave/zoom
      transitionSpeed: default # default/fast/slow
  revealjs-local:
    extends: [revealjs]
    metadata:
      revealjs-url: ./reveal.js
  revealjs-selfcontained:
    extends: [revealjs-local]
    pandoc:
      self-contained: true
  powerpoint:
    extends: [refs]
    pandoc:
      from: markdown
      to: pptx
#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: LATEX ::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
  latex-tufte:
    extends: [biblatex]
    pandoc:
      from: markdown
      to: latex-smart # turn off smart to leave — … “” etc. as unicode, needs xetex or luatex
      standalone: true
      lua-filter:
        - filters/pretty-urls.lua # clean up URLs a bit
      template: templates/tufte-book.latex
    metadata:
      documentclass: 'tufte-book' # also: tufte-handout
      lang: 'en-GB'
      papersize: a4
      #linestretch: 1.4
      #biblio-style: verbose #verbose for biblatex, plainnat for natbib
      biblatexoptions:
        - autocite=footnote
      classoption:
        #- debug
        #- nobib # !!! needed with V3.5.2 & biblatex
        #- notoc # disbles Tufte TOC style
        #- nofonts #do not auto-specify fonts
        #- symmetric # note this is buggy...
        - sfsidenotes # sans-serif side notes
        - british
        - justified
      publisher: Octopoda Publishing • Shanghai • China
      epigraph:
        - author: Anaïs Nin
          text: "“We don’t see things as they are, we see them as we are.”"
        - author: Michael Shermer
          text: "“Humans are pattern-seeking story-telling animals, and we are quite adept at telling stories about patterns, whether they exist or not.”"
      dedication: |
        This book is was written to honour all the myriad cephalopods in the deep blue sea…
      copyright-link: https://creativecommons.org/licenses/by-nc-sa/4.0/
      copyright-image: /Users/ian/Code/dotpandoc/by-nc-sa.png
      copyright: |
        © Creative Commons CC BY-NC-SA 4.0 — This license enables reusers to distribute, remix, adapt, and build upon the material in any medium or format for noncommercial purposes only, and only so long as attribution is given to the creator. If you remix, adapt, or build upon the material, you must license the modified material under identical terms. CC BY-NC-SA includes the following elements:  BY: credit must be given to the creator.  NC: Only noncommercial uses of the work are permitted.  SA: Adaptations must be shared under the same terms.
      mainfont: 'Alegreya'
      mainfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      sansfont: 'Alegreya Sans'
      sansfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      monofont: 'Fantasque Sans Mono'
      mathfont: 'STIX Two Math'
      mathfontoptions: 'math-style=ISO,bold-style=ISO'
      colorlinks: true
      linkcolor: Mahogany
      citecolor: Sepia
      urlcolor: BrickRed
      listings: false
#-----------------------------------------------------------------
  latex:
    preprocessors:
      #- preprocessors/removeImageDimensions.rb # remove image dimensions
    pandoc:
      from: markdown
      to: latex-smart # turn off smart to leave — … “” etc. as unicode, needs xetex or luatex
      standalone: true
      filter: 
        - filters/assimilateMetadata.rb # handle academic metadata
      lua-filter:
        - filters/convertIndex.lua
        - filters/pagebreak.lua # use \newpage{} also for HTML, DOCX, ODT & EPUB
        - filters/abstract-section.lua # move an abstract heading to metadata
        - filters/pretty-urls.lua # clean up URLs a bit
      template: templates/custom.latex
    metadata:
      documentclass: 'article'
      classoption: twoside
      pagestyle: plain # control \pagestyle{}: the default article class supports plain (default), empty (no running heads or page numbers), and headings (section titles in running heads)
      fontsize: '12pt'
      linestretch: '1.5'
      geometry: ['inner=2.2cm','outer=1.8cm','bottom=2.5cm','twoside']
      mainfont: 'Greta Text Pro'
      mainfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      sansfont: 'Greta Sans Pro'
      sansfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      monofont: 'Rec Mono Duotone'
      mathfont: 'STIX Two Math'
      mathfontoptions: 'math-style=ISO,bold-style=ISO'
      #CJKmainfont: 'Heiti SC' # need to install xecjk in tinytex
      colorlinks: true
      linkcolor: Mahogany
      citecolor: Sepia
      urlcolor: BrickRed
      lang: 'en-GB'
      nonumberfigures: true # I use Scrivener autonumbering, so disable for LaTeX
      doindex: false # don't add index by default
    postprocessors: 
      - postprocessors/fixLaTeX.rb
#-----------------------------------------------------------------
  latex-crossref:
    extends: [latex, refs, crossref]
    pandoc:
      include-in-header: blank.txt
    metadata:
      nonumberfigures: false
      titleDelim: ' — '
      figPrefix: ['Fig.','Figs.']
#-----------------------------------------------------------------
  latex-refs:
    extends: [latex, refs]
#-----------------------------------------------------------------
  latex-index:
    extends: [latex-crossref]
    metadata:
      doindex: true
#-----------------------------------------------------------------
  pdf-refs:
    extends: latex-refs
    pandoc:
      to: pdf
      pdf-engine: 'xelatex'
#-----------------------------------------------------------------
  pdf-crossref:
    extends: latex-crossref
    pandoc:
      to: pdf
      pdf-engine: 'xelatex'
#-----------------------------------------------------------------
  latex-biblatex:
    extends: 'latex'
    pandoc:
      biblatex: true
      bibliography: Core.bib
    metadata:
      biblio-style: authoryear-comp
      biblatexoptions: [sort=nyt,backend=biber,maxcitenames=2]
#-----------------------------------------------------------------
  elsevier:
    extends: 'natbib'
    pandoc:
      from: markdown
      filter:
        - filters/assimilateMetadata.rb    # Handle academic metadata.
      template: elsarticle.latex           # Latex template supporing elsarticle.cls
      include-in-header: './addpackages.sty' # To easily include packages; refer to elsarticle.latex
    metadata:
      documentclass: 'elsarticle'          # Specifying Elsevier's documentclass.
      classoption: ['authoryear','preprint'] # Elsevier options
      biblio-style: elsarticle-harv        # see elsarticle documentation
      natbiboptions: [longnamesfirst,semicolon] # Add extra options of natbib.sty
      colorlinks: true
      linestretch: '1.5'
      lang: 'en-GB'
#-----------------------------------------------------------------
  elsevier-1col:
    extends: 'elsevier'
    pandoc:
      output: elsarticle_1col.tex
    metadata:
      classoption: ['3p'] # Single column style.
#-----------------------------------------------------------------
  elsevier-2col:
    extends: 'elsevier'
    pandoc:
      output: elsarticle_2col.tex
    metadata:
      classoption: ['3p','twocolumn'] # Double column style.
#-----------------------------------------------------------------
  latex-endnote:
    extends: 'latex-refs'
    preprocessors: 
      - preprocessors/convertEndnoteRefs.rb
#-----------------------------------------------------------------
  pdf-endnote:
    extends: 'latex-endnote'
    pandoc:
      to: pdf
      pdf-engine: 'xelatex'
#-----------------------------------------------------------------
  latex-chemfig: # example of using header-includes with yaml block scalar data http://yaml-multiline.info/
    extends: [latex-refs]
    metadata:
      header-includes:
        - |
          ```{=latex}
          \usepackage[]{chemfig}
          ```
#-----------------------------------------------------------------
  latex-with-toc:
    extends: [latex-refs]
    pandoc:
      toc: true
      toc-depth: 3
#-----------------------------------------------------------------
  latex-with-lof:
    extends: [latex-refs]
    pandoc:
      toc: true
      toc-depth: 3
    metadata:
      lof: true
#-----------------------------------------------------------------
# see https://gitlab.com/daamien/pandoc-leaflet-template/
  leaflet:
    pandoc:
      from: markdown
      to: latex-smart # turn off smart leaves — … “” as unicode
      pdf-engine: 'xelatex'
      standalone: true
      template: templates/leaflet.latex
    metadata:
      mainfont: 'Greta Text Pro'
      mainfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      sansfont: 'Greta Sans Pro'
      sansfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      monofont: 'Rec Mono Duotone'
      leaflet-logo:
      leaflet-no-cutlines: true
      leaflet-no-tumble: true
      leaflet-page1-background-image:
      leaflet-page6-background-color: "DDCCAA"
#-----------------------------------------------------------------
# see https://github.com/aaronwolen/pandoc-letter
#   address : Name and address of the recipient; takes a list for a multi-line address.
#   author : Writer of the letter; can take a list for a multi-line signature.
#   blockquote : Changes style of block quotations to match bootstrap (requires the mdframed package).
#   cc : Recipients to be carbon-copied; can take a list for multiple recipients.
#   closing : Text for the complementary close.
#   closing-indentation : Amount for closing signature block to be intended from left margin.
#   date : Custom date (current date will be automatically inserted if not specified).
#   encl : List of enclosures.
#   letterhead : Image file to be used as letterhead (requires the wallpaper package), applied only to the first page.
#   opening : Text for the salutation.
#   ps : Text to be added at the end of the letter as a postscript.
#   return-address : Address of the sender: takes a list to allow a multi-line address.
#   signature : Image file for a signature.
#   signature-before, signature-after : Allows adjustment of vertical space surrounding signature.
  latex-letter:
    extends: natbib
    pandoc:
      from: markdown
      to: latex-smart # turn off smart leaves — … “” as unicode
      pdf-engine: xelatex
      standalone: true
      template: templates/letter.latex
      lua-filter:
        - filters/pretty-urls.lua # clean up URLs a bit
    metadata:
      papersize: a4
      return-address: |
        Cognitive-Behavioural Research Platform  
        Institute of Neuroscience, CAS  
        Room 307, Systems Building  
        320 Yueyang Rd, Shanghai  
        200031, CHINA  
        ✉ <i.andolina@ion.ac.cn>  
        ✆ +86 021 54921747  
      author: |
        Ian Max Andolina Ph.D.  
        Director, Cognitive \& Behavioural Research Platform  
      opening: To whom it may concern,  
      closing: Sincerely yours,  
      mainfont: 'Graublau Sans'
      mainfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      monofont: 'Rec Mono Duotone'
      mathfont: 'STIX Two Math'
      mathfontoptions: 'math-style=ISO,bold-style=ISO'
      CJKmainfont: 'PingFang SC'
      fontsize: '11pt'
      linestretch: '1.2'
      letterhead: "/Users/ian/Library/CloudStorage/Dropbox/Work/CEBSIT-Letterhead.pdf"
      signature: "/Users/ian/Library/CloudStorage/Dropbox/Work/Ian-Signature-Small.png"
      signature-width: 45mm
      signature-before: -12ex
      signature-after: -1.5ex
      closing-indentation: 12pt
      links-as-notes: false
      colorlinks: true
      linkcolor: Mahogany
      citecolor: Sepia
      urlcolor: BrickRed
      lang: 'en-GB'
      geometry: ['margin=1.2cm','top=2.5cm']
      biblio-style: numeric
    postprocessors:
      - postprocessors/fixLaTeX.rb
#-----------------------------------------------------------------
# https://github.com/Wandmalfarbe/pandoc-latex-template
  eisvogel:
    extends: 'refs'
    preprocessors: 
      #- preprocessors/removeImageDimensions # remove image dimensions
    pandoc:
      from: markdown
      to: latex-smart # turn off smart leaves — … “” as unicode
      standalone: true
      lua-filter:
        - filters/pagebreak.lua # use \newpage{} also for HTML, DOCX, ODT & EPUB
        - filters/abstract-section.lua # move an abstract heading to metadata
        - filters/pretty-urls.lua # clean up URLs a bit
      filter: 
        - filters/assimilateMetadata.rb # handle academic matadata
      template: templates/eisvogel.latex
      toc: true
      shift-heading-level-by: 1
    metadata: 
      book: false 
      titlepage: true
      titlepage-color: BB4433
      titlepage-text-color: FFFFFF
      titlepage-rule-color: FFFFFF
      titlepage-rule-height: 10
      caption-justification: justified
      toc-own-page: true
      listings-disable-line-numbers: false
      float-placement-figure: H
      #logo: "/Users/ian/Dropbox/Images/Logos/Platform-ION-Banner-White.png"
      #logo-width: 350
      mainfont: 'Greta Sans Pro'
      mainfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      sansfont: 'Graublau Slab'
      sansfontoptions: 'Numbers=OldStyle,Numbers=Proportional'
      monofont: 'Rec Mono Duotone'
      mathfont: 'STIX Two Math'
      mathfontoptions: 'math-style=ISO,bold-style=ISO'
      #CJKmainfont: 'PingFang SC'
      #CJKsansfont: 'PingFang SC'
      fontsize: '12pt'
      linestretch: '1.5'
      colorlinks: true
      linkcolor: Mahogany
      citecolor: Sepia
      urlcolor: BrickRed
      nonumberfigures: true
      lang: 'en-GB'
      disable-header-and-footer: false
      header-right:
      header-left:
      header-center:
      footer-right:
      footer-left: 
      footer-center:
      footnotes_pretty: true
      footnotes-disable-backlinks: false
    postprocessors: 
      - postprocessors/fixLaTeX.rb
#-----------------------------------------------------------------
# https://github.com/Wandmalfarbe/pandoc-latex-template
  eisvogel-logo:
    extends: [eisvogel]
    metadata:
      titlepage-background: /Users/ian/Dropbox/Images/Logos/backgroundlogo.pdf
      page-background:
      page-background-opacity:
      titlepage-text-color: 555555
      titlepage-rule-color: 555555
#-----------------------------------------------------------------
# https://github.com/Wandmalfarbe/pandoc-latex-template
  eisvogel-crossref:
    extends: [eisvogel,crossref]
    pandoc:
      include-in-header: blank.txt
    metadata:
      nonumberfigures: false
      titleDelim: '&nbsp;—&nbsp;'
      figPrefix: ['Fig.','Figs.']
#-----------------------------------------------------------------
# https://github.com/Wandmalfarbe/pandoc-latex-template
  eisvogel-pdf:
    extends: [eisvogel]
    pandoc:
      to: pdf
      pdf-engine: 'xelatex'
    cleanup: []
#-----------------------------------------------------------------
# https://github.com/Wandmalfarbe/pandoc-latex-template
  eisvogel-original:
    extends: [eisvogel]
    pandoc:
      template: templates/eisvogel.latex
#-----------------------------------------------------------------
# https://github.com/Wandmalfarbe/pandoc-latex-template
  eisvogel-endnote:
    extends: [eisvogel]
    preprocessors: 
      - preprocessors/convertEndnoteRefs.rb
#-----------------------------------------------------------------
  latex-ieee:
    extends: [latex-refs]
    pandoc:
      template: templates/ieee.latex
    metadata: 
      fontsize: '10pt'
#-----------------------------------------------------------------
# https://github.com/pandoc-scholar/pandoc-scholar
  latex-scholar:
    extends: [latex-refs]
    pandoc:
      template: templates/pandoc-scholar.latex
    metadata: 
      fontsize: '10pt'
#-----------------------------------------------------------------
  memoir-with-refs:
    extends: [latex-refs]
    pandoc:
      template: templates/custom-memoir.latex
      toc: true
      toc-depth: 3
      base-header-level: 1
    metadata:
      documentclass: 'memoir'
#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: HTML :::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
  html:
    pandoc:
      from: markdown
      to: html5
      embed-resources: true
      number-sections: false
      section-divs: true
      mathjax: true
      lua-filter:
        - filters/pagebreak.lua # use \newpage{} also for HTML and docx
        - filters/abstract-section.lua # move an abstract heading to metadata
        - filters/pretty-urls.lua # clean up URLs a bit
      filter: 
        - filters/assimilateMetadata.rb #regularise metadata
      template: 'templates/custom.html'
      css: 'templates/custom.css'
      toc: true
      toc-depth: 4
    metadata:
      document-css: true #use the html partial
      lang: 'en-GB'
      mainfont: Alegreya Sans, Greta Sans Pro, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen-Sans, Ubuntu, Cantarell, Helvetica Neue, sans-serif"
      monofont: Rec Mono Duotone, Fira code, Jetbrains Mono, menlo, consolas, monospace
      linestretch: 1.3
      fontsize: 20
      fontcolor: "#1A1A1A"
      backgroundcolor: "#FFFFFF"
      margin-left: 50px
      margin-right: 50px
      margin-top: 50px
      margin-bottom: 50px
      csl-entry-spacing: 0.5em
      linkcolor: "#772222"
      csl-css: true
      postprocessors: 
      - postprocessors/fixHTML.rb
#-----------------------------------------------------------------
  html-selfcontained:
    extends: [html]
    pandoc:
      self-contained: true
#-----------------------------------------------------------------
  html-changes:
    extends: ['html']
    preprocessors: 
      - preprocessors/criticmarkup.rb
#-----------------------------------------------------------------
  html-refs:
    extends: [refs, html]
#-----------------------------------------------------------------
  html-refs-crossref:
    extends: [refs, html, crossref]
#-----------------------------------------------------------------
  html-endnote:
    extends: [refs, html]
    preprocessors: 
      - preprocessors/convertEndnoteRefs.rb
#-----------------------------------------------------------------
  html-scholar:
    extends: [refs, crossref, html]
    pandoc: 
      template: 'templates/pandoc-scholar.html'
      css: 'templates/pandoc-scholar.css'
#-----------------------------------------------------------------
  html-scholar-pdf:
    extends: [html-scholar]
    pandoc:
      to: pdf
      pdf-engine: prince
      pdf-engine-opt: ['--page-size=A4','--page-margin=10mm']
#-----------------------------------------------------------------
  html-pdf:
    extends: [html]
    pandoc:
      to: pdf
      pdf-engine: prince
      pdf-engine-opt: ['--page-size=A4']
    metadata:
      backgroundcolor: "#FFFFFF"
#-----------------------------------------------------------------
  html-pagedjs:
    pandoc:
      pdf-engine: pagedjs-cli
      output: pagedjs.pdf
      from: markdown
      to: html5
      standalone: true
      section-divs: true
      mathjax: true
      lua-filter:
        - filters/pagebreak.lua # use \newpage{} also for HTML and docx
      filter: 
        - filters/assimilateMetadata.rb #regularise metadata
    metadata:
      document-css: true #don't use the html partial
      lang: 'en-GB'
      template: 'templates/pagedjs.html'
      #css: ['templates/interface.css','templates/recto-verso.css','templates/layout.css','templates/baseline.css']
#-----------------------------------------------------------------
  html-refs-pdf:
    extends: [refs, crossref, html-pdf]
#-----------------------------------------------------------------
  html-endnote-pdf:
    extends: [html-refs-pdf]
    preprocessors: 
      - preprocessors/convertEndnoteRefs.rb
#-----------------------------------------------------------------
# https://github.com/jez/tufte-pandoc-css
  tufte:
    pandoc:
      from: markdown+compact_definition_lists
      to: html5
      section-divs: true
      standalone: true
      mathjax: true
      lua-filter:
        - filters/pagebreak.lua # use \newpage{} also for HTML and docx
      filter: 
        - filters/assimilateMetadata.rb # regularise metadata
        - pandoc-sidenote # brew install jez/formulae/pandoc-sidenote
      template: 'templates/tufte.html5'
      css: 
        - 'templates/tufte.css'
        - 'templates/tuftepandoc.css'
    metadata:
      lang: 'en-GB'
#-----------------------------------------------------------------
  tufte-refs:
    extends: [refs,tufte,crossref]
#-----------------------------------------------------------------
  tufte-refs-pdf:
    extends: [tufte-refs]
    pandoc:
      to: pdf
      pdf-engine: prince
      pdf-engine-opt: ['--page-size=A4']
#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: EPUB :::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
  epub-test:
    pandoc:
      from: markdown
      to: epub
      standalone: true
      self-contained: true
    metadata:
      stylesheet: epub.css
      cover-image: templates/VPMLogoBlack.png
#-----------------------------------------------------------------
#:::::::::::::::::::::::::::: TEST :::::::::::::::::::::::::::::::
#-----------------------------------------------------------------
# VARIOUS TEST TEMPLATES
#-----------------------------------------------------------------
  test:
    pandoc:
      from: markdown
      to: html5
      standalone: true
      css: templates/custom.css
      self-contained: true
      mathjax: true
      filter:
        - filters/noop.rb
    metadata:
      lang: 'EN-GB'
#-----------------------------------------------------------------
  test-debug:
    pandoc:
      from: markdown
      to: html5
      standalone: true
      self-contained: true
      filter:
        - filters/testFilter.rb
    metadata:
      lang: 'EN-GB'
#-----------------------------------------------------------------
  test-markdown:
    pandoc:
      from: markdown
      to: markdown
      output: out.md
      standalone: true
      filter: 
        - filters/testFilter.rb
    metadata:
      #author: Joanna Doe