1- .\" Automatically generated by Pandoc 3.4
1+ .\" Automatically generated by Pandoc 3.5
22.\"
3- .TH "pandoc" "1" "September 9 , 2024" "pandoc 3.4 " "Pandoc User\[cq ] s Guide"
3+ .TH "pandoc" "1" "October 5 , 2024" "pandoc 3.5 " "Pandoc User\[cq ] s Guide"
44.SH NAME
55pandoc - general markup converter
66.SH SYNOPSIS
@@ -890,6 +890,20 @@ contents.
890890The default is 3 (which means that level\- 1, 2, and 3 headings will be
891891listed in the contents).
892892.TP
893+ \f[CR] \-\- lof[=true|false] \f[ R ] , \f[CR] \-\- list \- of \- figures[=true|false] \f[ R ]
894+ Include an automatically generated list of figures (or, in some formats,
895+ an instruction to create one) in the output document.
896+ This option has no effect unless \f[CR] \- s/ \-\- standalone \f[ R ] is used,
897+ and it only has an effect on \f[CR] latex \f[ R ] , \f[CR] context \f[ R ] , and
898+ \f[CR] docx \f[ R ] output.
899+ .TP
900+ \f[CR] \-\- lot[=true|false] \f[ R ] , \f[CR] \-\- list \- of \- tables[=true|false] \f[ R ]
901+ Include an automatically generated list of tables (or, in some formats,
902+ an instruction to create one) in the output document.
903+ This option has no effect unless \f[CR] \- s/ \-\- standalone \f[ R ] is used,
904+ and it only has an effect on \f[CR] latex \f[ R ] , \f[CR] context \f[ R ] , and
905+ \f[CR] docx \f[ R ] output.
906+ .TP
893907\f[CR] \-\- strip \- comments[=true|false] \f[ R ]
894908Strip out HTML comments in the Markdown or Textile source, rather than
895909passing them on to Markdown, Textile or HTML output as raw HTML.
@@ -2010,6 +2024,14 @@ or \f[CR]{type: citeproc}\f[R].
20102024
20112025 \-\- listings listings: true
20122026
2027+ \-\- list\- of\- figures list\- of\- figures: true
2028+
2029+ \-\- lof lof: true
2030+
2031+ \-\- list\- of\- tables list\- of\- tables: true
2032+
2033+ \-\- lot lot: true
2034+
20132035 \-\- incremental incremental: true
20142036
20152037 \-\- slide\- level 2 slide\- level: 2
@@ -2809,14 +2831,18 @@ enables \[lq]title pages\[rq] for new sections (default is true)
28092831\f[CR] theme \f[ R ] , \f[CR] colortheme \f[ R ] , \f[CR] fonttheme \f[ R ] , \f[CR] innertheme \f[ R ] , \f[CR] outertheme \f[ R ]
28102832beamer themes
28112833.TP
2812- \f[CR] themeoptions \f[ R ]
2813- options for LaTeX beamer themes (a list).
2834+ \f[CR] themeoptions \f[ R ], \f[CR] colorthemeoptions \f[ R ] , \f[CR] fontthemeoptions \f[ R ] , \f[CR] innerthemeoptions \f[ R ] , \f[CR] outerthemeoptions \f[ R ]
2835+ options for LaTeX beamer themes (lists)
28142836.TP
28152837\f[CR] titlegraphic \f[ R ]
2816- image for title slide
2838+ image for title slide: can be a list
28172839.TP
28182840\f[CR] titlegraphicoptions \f[ R ]
28192841options for title slide image
2842+ .TP
2843+ \f[CR] shorttitle \f[ R ] , \f[CR] shortsubtitle \f[ R ] , \f[CR] shortauthor \f[ R ] , \f[CR] shortinstitute \f[ R ] , \f[CR] shortdate \f[ R ]
2844+ some beamer themes use short versions of the title, subtitle, author,
2845+ institute, date
28202846.SS Variables for PowerPoint
28212847These variables control the visual aspects of a slide show that are not
28222848easily controlled via templates.
@@ -2930,7 +2956,10 @@ numbering depth for sections (with \f[CR]\-\-number\-sections\f[R]
29302956option or \f[CR] numbersections \f[ R ] variable)
29312957.TP
29322958\f[CR] beamerarticle \f[ R ]
2933- produce an article from Beamer slides
2959+ produce an article from Beamer slides.
2960+ Note: if you set this variable, you must specify the beamer writer but
2961+ use the default \f[I] LaTeX \f[ R ] template: for example,
2962+ \f[CR] pandoc \- Vbeamerarticle \- t beamer \-\- template default.latex \f[ R ] .
29342963.TP
29352964\f[CR] handout \f[ R ]
29362965produce a handout version of Beamer slides (with overlays condensed into
@@ -3058,7 +3087,9 @@ the default, \f[CR]same\f[R])
30583087.SS Front matter
30593088.TP
30603089\f[CR] lof \f[ R ] , \f[CR] lot \f[ R ]
3061- include list of figures, list of tables
3090+ include list of figures, list of tables (can also be set using
3091+ \f[CR] \-\- lof/ \-\- list \- of \- figures \f[ R ] ,
3092+ \f[CR] \-\- lot/ \-\- list \- of \- tables \f[ R ] )
30623093.TP
30633094\f[CR] thanks \f[ R ]
30643095contents of acknowledgments footnote after document title
@@ -7521,7 +7552,7 @@ If you are not satisfied with the predefined styles, you can use
75217552To get a JSON version of the \f[CR] pygments \f[ R ] style, for example:
75227553.IP
75237554.EX
7524- pandoc \-\- print\- highlight\- style pygments > my.theme
7555+ pandoc \- o my.theme \-\- print\- highlight\- style pygments
75257556 .EE
75267557.PP
75277558Then edit \f[CR] my.theme \f[ R ] and use it like this:
@@ -7537,6 +7568,10 @@ definition file.
75377568Before writing your own, have a look at KDE\[cq ] s repository of syntax
75387569definitions.
75397570.PP
7571+ If you receive an error that pandoc \[lq ] Could not read highlighting
7572+ theme\[rq ] , check that the JSON file is encoded with UTF\- 8 and has no
7573+ Byte\- Order Mark (BOM).
7574+ .PP
75407575To disable highlighting, use the \f[CR] \-\- no \- highlight \f[ R ] option.
75417576.SH CUSTOM STYLES
75427577Custom styles can be used in the docx, odt and ICML formats.
0 commit comments