@@ -1427,102 +1427,152 @@ of options. Here is a sample defaults file demonstrating all of
1427the fields that may be used:
1427the fields that may be used:
1433−table-of-contents: true
1434−# toc is a synonym for table-of-contents
1435from: markdown+emoji
1430from: markdown+emoji
1436−# reader is a synonym for from
1431+# reader: may be used instead of from:
1437to: html5
1432to: html5
1438−# writer is a synonym for to
1433+# writer: may be used instead of to:
1439−shift-heading-level-by: 1
1434+
1435+# leave blank for output to stdout:
1437+# leave blank for input from stdin:
1440−template: leter
1442+template: letter
1444+self-contained: false
1446+# note that structured variables may be specified:
1441variables:
1447variables:
1442 documentclass: book
1448 documentclass: book
1443 classoptions:
1449 classoptions:
1444 - twosides
1450 - twosides
1453+# metadata values specified here are parsed as literal
1454+# string text, not markdown:
1446metadata:
1455metadata:
1448 - Sam Smith
1457 - Sam Smith
1449 - Julie Liu
1458 - Julie Liu
1450−metadata-files: []
1459+metadata-files:
1451−# you may also use metadata-file with a single value
1461+# or you may use metadata-file: with a single value
1453−input-files:
1463+# Note that these take files, not their contents:
1454−- preface.md
1464+include-before-body: []
1455−- content.md
1465+include-after-body: []
1466+include-in-header: []
1467+resource-path: ["."]
1469+# filters will be assumed to be lua filters if they have
1470+# the .lua extension, and json filters otherwise. But
1471+# the filter type can also be specified explicitly, as shown:
1482+# ERROR, WARNING, or INFO
1486+# citeproc, natbib, or biblatex
1487+cite-method: citeproc
1488+# part, chapter, section, or default:
1489+top-level-division: chapter
1492+pdf-engine: pdflatex
1495+# you may also use pdf-engine-opt: with a single option
1496+# pdf-engine-opt: "-shell-escape"
1498+# auto, preserve, or none
1503+extract-media: mediadir
1505+table-of-contents: true
1456number-sections: false
1507number-sections: false
1508+# a list of offsets at each heading level
1457number-offset: [0,0,0,0,0,0]
1509number-offset: [0,0,0,0,0,0]
1510+# toc: may also be used instead of table-of-contents:
1511+shift-heading-level-by: 1
1458section-divs: true
1512section-divs: true
1459−incremental: false
1513+identifier-prefix: foo
1460−self-contained: false
1514+title-prefix: ""
1461−html-q-tags: false
1515+strip-empty-paragraphs: true
1516+# lf, crlf, or native
1518+strip-comments: false
1519+indented-code-classes: []
1521+default-image-extension: ".jpg"
1523+# either a style name of a style definition file:
1462highlight-style: pygments
1524highlight-style: pygments
1463syntax-definitions:
1525syntax-definitions:
1465−# may also use syntax-definition: with a single value
1527+# or you may use syntax-definition: with a single value
1466−top-level-division: chapter
1528+listings: false
1530+reference-doc: myref.docx
1532+# method is plain, webtex, gladtex, mathml, mathjax, katex
1533+# you may specify a url with webtex, mathjax, katex
1467html-math-method:
1534html-math-method:
1468 method: mathjax
1535 method: mathjax
1469 url: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
1536 url: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
1470−abbreviations: []
1537+# none, references, or javascript
1471−reference-doc: myref.docx
1538+email-obfuscation: javascript
1472epub-subdirectory: EPUB
1546epub-subdirectory: EPUB
1473epub-metadata: meta.xml
1547epub-metadata: meta.xml
1474epub-fonts:
1548epub-fonts:
1475- foobar.otf
1549- foobar.otf
1476epub-chapter-level: 1
1550epub-chapter-level: 1
1477epub-cover-image: cover.jpg
1551epub-cover-image: cover.jpg
1484−fail-if-warnings: false
1485reference-links: true
1553reference-links: true
1554+# block, section, or document
1486−reference-location: paragraph
1555+reference-location: block
1495−email-obfuscation: javascript
1496−identifier-prefix: foo
1497−strip-empty-paragraphs: true
1498−indented-code-classes: []
1500−cite-method: citeproc
1502−pdf-engine: pdflatex
1504−# can also use this with a single option:
1507setext-headers: true
1556setext-headers: true
1509−default-image-extension: ".jpg"
1558+# accept, reject, or all
1510−extract-media: mediadir
1511−track-changes: false
1559+track-changes: accept
1512−file-scope: false
1560+
1513−title-prefix: ""
1561+html-q-tags: false
1515- site.css
1563- site.css
1565+# none, all, or best
1516ipynb-output: best
1566ipynb-output: best
1517−# Note that these take files, not their contents:
1567+
1518−include-before-body: []
1568+# A list of two-element lists
1519−include-after-body: []
1520−include-in-header: []
1521−resource-path: ["."]
1522request-headers:
1569request-headers:
1523- ["User-Agent", "Mozilla/5.0"]
1570- ["User-Agent", "Mozilla/5.0"]
1525−strip-comments: false
1572+fail-if-warnings: false
1528# Templates
1578# Templates