@@ -1,7 +1,7 @@
11.\"t
2−.\" Automatically generated by Pandoc 2.9.2
2+.\" Automatically generated by Pandoc 2.10
33.\"
4−.TH "Pandoc User\[aq]s Guide" "" "March 23, 2020" "pandoc 2.9.2.1" ""
4+.TH "Pandoc User\[aq]s Guide" "" "June 29, 2020" "pandoc 2.10" ""
55.hy
66.SH NAME
77pandoc - general markup converter
@@ -255,7 +255,7 @@ if you need extensions not supported in \f[C]gfm\f[R].
255255.IP \[bu] 2
256256\f[C]jats\f[R] (JATS XML)
257257.IP \[bu] 2
258−\f[C]jira\f[R] (Jira wiki markup)
258+\f[C]jira\f[R] (Jira/Confluence wiki markup)
259259.IP \[bu] 2
260260\f[C]json\f[R] (JSON version of native AST)
261261.IP \[bu] 2
@@ -352,7 +352,7 @@ HTML5/XHTML polyglot markup)
352352.IP \[bu] 2
353353\f[C]jats\f[R] (alias for \f[C]jats_archiving\f[R])
354354.IP \[bu] 2
355−\f[C]jira\f[R] (Jira wiki markup)
355+\f[C]jira\f[R] (Jira/Confluence wiki markup)
356356.IP \[bu] 2
357357\f[C]json\f[R] (JSON version of native AST)
358358.IP \[bu] 2
@@ -481,7 +481,6 @@ eval \[dq]$(pandoc --bash-completion)\[dq]
481481.TP
482482\f[B]\f[CB]--verbose\f[B]\f[R]
483483Give verbose debugging output.
484−Currently this only has an effect with PDF output.
485484.TP
486485\f[B]\f[CB]--quiet\f[B]\f[R]
487486Suppress warning messages.
@@ -936,6 +935,11 @@ making HTTP requests (for example, when a URL is given on the command
936935line, or when resources used in a document must be downloaded).
937936If you\[aq]re behind a proxy, you also need to set the environment
938937variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].
938+.TP
939+\[ga]--no-check-certificate
940+Disable the certificate verification to allow access to unsecure HTTP
941+resources (for example when the certificate is no longer valid or self
942+signed).
939943.SS Options affecting specific writers
940944.TP
941945\f[B]\f[CB]--self-contained\f[B]\f[R]
@@ -1366,7 +1370,8 @@ depending on the output format specified using \f[C]-t/--to\f[R]:
13661370\f[C]-t context\f[R]: \f[C]context\f[R]
13671371.IP \[bu] 2
13681372\f[C]-t html\f[R]: \f[C]wkhtmltopdf\f[R] (other options:
1369−\f[C]prince\f[R], \f[C]weasyprint\f[R])
1373+\f[C]prince\f[R], \f[C]weasyprint\f[R]; see print-css.rocks for a good
1374+introduction to PDF generation from HTML/CSS.)
13701375.IP \[bu] 2
13711376\f[C]-t ms\f[R]: \f[C]pdfroff\f[R]
13721377.RE
@@ -2053,20 +2058,30 @@ ${ endfor }
20532058.fi
20542059.SS Partials
20552060.PP
2056−Partials (subtemplates stored in different files) may be included using
2057−the syntax
2061+Partials (subtemplates stored in different files) may be included by
2062+using the name of the partial, followed by \f[C]()\f[R], for example:
2063+.IP
2064+.nf
2065+\f[C]
2066+${ styles() }
2067+\f[R]
2068+.fi
2069+.PP
2070+Partials will be sought in the directory containing the main template.
2071+The file name will be assumed to have the same extension as the main
2072+template if it lacks an extension.
2073+When calling the partial, the full name including file extension can
2074+also be used:
20582075.IP
20592076.nf
20602077\f[C]
2061−${ boilerplate() }
2078+${ styles.html() }
20622079\f[R]
20632080.fi
20642081.PP
2065−Partials will be sought in the directory containing the main template,
2066−and will be assumed to have the same extension as the main template if
2067−they lack an explicit extension.
2068−(If the partials are not found here, they will also be sought in the
2069−\f[C]templates\f[R] subdirectory of the user data directory.)
2082+(If a partial is not found in the directory of the template, it will
2083+also be sought in the \f[C]templates\f[R] subdirectory of the user data
2084+directory.)
20702085.PP
20712086Partials may optionally be applied to variables using a colon:
20722087.IP
@@ -2232,6 +2247,18 @@ for a textual value, number of elements for a map or array.
22322247\f[C]reverse\f[R]: Reverses a textual value or array, and has no effect
22332248on other values.
22342249.IP \[bu] 2
2250+\f[C]first\f[R]: Returns the first value of an array, if applied to a
2251+non-empty array; otherwise returns the original value.
2252+.IP \[bu] 2
2253+\f[C]last\f[R]: Returns the last value of an array, if applied to a
2254+non-empty array; otherwise returns the original value.
2255+.IP \[bu] 2
2256+\f[C]rest\f[R]: Returns all but the first value of an array, if applied
2257+to a non-empty array; otherwise returns the original value.
2258+.IP \[bu] 2
2259+\f[C]allbutlast\f[R]: Returns all but the last value of an array, if
2260+applied to a non-empty array; otherwise returns the original value.
2261+.IP \[bu] 2
22352262\f[C]chomp\f[R]: Removes trailing newlines (and breakable space).
22362263.IP \[bu] 2
22372264\f[C]nowrap\f[R]: Disables line wrapping on breakable spaces.
@@ -2398,7 +2425,8 @@ To turn off boolean flags that default to true in reveal.js, use
23982425\f[C]0\f[R].
23992426.TP
24002427\f[B]\f[CB]revealjs-url\f[B]\f[R]
2401−base URL for reveal.js documents (defaults to \f[C]reveal.js\f[R])
2428+base URL for reveal.js documents (defaults to
2429+\f[C]https://unpkg.com/reveal.js\[at]\[ha]4/\f[R])
24022430.TP
24032431\f[B]\f[CB]s5-url\f[B]\f[R]
24042432base URL for S5 documents (defaults to \f[C]s5/default\f[R])
@@ -3247,7 +3275,7 @@ This extension can be enabled/disabled for the following formats:
32473275.TP
32483276output formats
32493277\f[C]odt\f[R], \f[C]opendocument\f[R]
3250−.SS Extension: \f[C]styles\f[R]
3278+.SS Extension: \f[C]styles\f[R] {#ext-styles}
32513279.PP
32523280When converting from docx, read all docx styles as divs (for paragraph
32533281styles) and spans (for character styles) regardless of whether pandoc
@@ -4404,7 +4432,7 @@ orange|3.09
44044432.PP
44054433The cells of pipe tables cannot contain block elements like paragraphs
44064434and lists, and cannot span multiple lines.
4407−If a pipe table contains a row whose printable content is wider than the
4435+If a pipe table contains a row whose Markdown content is wider than the
44084436column width (see \f[C]--columns\f[R]), then the table will take up the
44094437full text width and the cell contents will wrap, with the relative cell
44104438widths determined by the number of dashes in the line separating the
@@ -4454,7 +4482,11 @@ no author, you need a blank line:
44544482\f[C]
44554483%
44564484% Author
4457−
4485+\f[R]
4486+.fi
4487+.IP
4488+.nf
4489+\f[C]
44584490% My title
44594491%
44604492% June 15, 2006
@@ -4479,9 +4511,17 @@ So, all of the following are equivalent:
44794511\f[C]
44804512% Author One
44814513 Author Two
4482−
4514+\f[R]
4515+.fi
4516+.IP
4517+.nf
4518+\f[C]
44834519% Author One; Author Two
4484−
4520+\f[R]
4521+.fi
4522+.IP
4523+.nf
4524+\f[C]
44854525% Author One;
44864526 Author Two
44874527\f[R]
@@ -5398,11 +5438,12 @@ For example:
53985438\f[R]
53995439.fi
54005440.IP \[bu] 2
5401−Dimensions are converted to inches for output in page-based formats like
5402−LaTeX.
5403−Dimensions are converted to pixels for output in HTML-like formats.
5404−Use the \f[C]--dpi\f[R] option to specify the number of pixels per inch.
5405−The default is 96dpi.
5441+Dimensions may be converted to a form that is compatible with the output
5442+format (for example, dimensions given in pixels will be converted to
5443+inches when converting HTML to LaTeX).
5444+Conversion between pixels and physical measurements is affected by the
5445+\f[C]--dpi\f[R] option (by default, 96 dpi is assumed, unless the image
5446+itself contains dpi information).
54065447.IP \[bu] 2
54075448The \f[C]%\f[R] unit is generally relative to some available space.
54085449For example the above example will render to the following.
@@ -6371,6 +6412,51 @@ contents...
63716412::::::::::::::
63726413\f[R]
63736414.fi
6415+.SS Additional columns attributes in beamer
6416+.PP
6417+The div containers with classes \f[C]columns\f[R] and \f[C]column\f[R]
6418+can optionally have an \f[C]align\f[R] attribute.
6419+The class \f[C]columns\f[R] can optionally have a \f[C]totalwidth\f[R]
6420+attribute or an \f[C]onlytextwidth\f[R] class.
6421+.IP
6422+.nf
6423+\f[C]
6424+:::::::::::::: {.columns align=center totalwidth=8em}
6425+::: {.column width=\[dq]40%\[dq]}
6426+contents...
6427+:::
6428+::: {.column width=\[dq]60%\[dq] align=bottom}
6429+contents...
6430+:::
6431+::::::::::::::
6432+\f[R]
6433+.fi
6434+.PP
6435+The \f[C]align\f[R] attributes on \f[C]columns\f[R] and \f[C]column\f[R]
6436+can be used with the values \f[C]top\f[R], \f[C]top-baseline\f[R],
6437+\f[C]center\f[R] and \f[C]bottom\f[R] to vertically align the columns.
6438+It defaults to \f[C]top\f[R] in \f[C]columns\f[R].
6439+.PP
6440+The \f[C]totalwidth\f[R] attribute limits the width of the columns to
6441+the given value.
6442+.IP
6443+.nf
6444+\f[C]
6445+:::::::::::::: {.columns align=top .onlytextwidth}
6446+::: {.column width=\[dq]40%\[dq] align=center}
6447+contents...
6448+:::
6449+::: {.column width=\[dq]60%\[dq]}
6450+contents...
6451+:::
6452+::::::::::::::
6453+\f[R]
6454+.fi
6455+.PP
6456+The class \f[C]onlytextwidth\f[R] sets the \f[C]totalwidth\f[R] to
6457+\f[C]\[rs]textwidth\f[R].
6458+.PP
6459+See Section 12.7 of the Beamer User\[aq]s Guide for more details.
63746460.SS Frame attributes in beamer
63756461.PP
63766462Sometimes it is necessary to add the LaTeX \f[C][fragile]\f[R] option to