aboutsummaryrefslogtreecommitdiff
path: root/pandoc-cli
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2024-06-24 12:37:25 -0700
committerJohn MacFarlane <[email protected]>2024-06-24 12:37:25 -0700
commitd8be1feb3209aaa93ac88a0e1104a3acfebd1b3d (patch)
tree6006661837c3df4b952e9cfc0c9dbeab6954c6bf /pandoc-cli
parentd44060477d2fbcee80c8ce5277f3ac3c3bc3fb8b (diff)
Update manual date and man pages.
Diffstat (limited to 'pandoc-cli')
-rw-r--r--pandoc-cli/man/pandoc-lua.16
-rw-r--r--pandoc-cli/man/pandoc-server.14
-rw-r--r--pandoc-cli/man/pandoc.162
3 files changed, 50 insertions, 22 deletions
diff --git a/pandoc-cli/man/pandoc-lua.1 b/pandoc-cli/man/pandoc-lua.1
index 88c087320..cc5d415f0 100644
--- a/pandoc-cli/man/pandoc-lua.1
+++ b/pandoc-cli/man/pandoc-lua.1
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.2
+.\" Automatically generated by Pandoc 3.2.1
.\"
-.TH "pandoc-lua" "1" "September 22, 2022" "pandoc 3.2" "Pandoc User\[cq]s Guide"
+.TH "pandoc-lua" "1" "September 22, 2022" "pandoc 3.2.1" "Pandoc User\[cq]s Guide"
.SH SYNOPSIS
\f[CR]pandoc\-lua\f[R] [\f[I]options\f[R]] [\f[I]script\f[R]
[\f[I]args\f[R]]]
@@ -76,7 +76,7 @@ Released under the GPL, version 2 or later.
This software carries no warranty of any kind.
(See COPYRIGHT for full copyright and warranty notices.)
.PP
-Lua: Copyright 1994\-2022 Lua.org, PUC\-Rio.
+Lua: Copyright 1994\-2023 Lua.org, PUC\-Rio.
.PP
The Pandoc source code may be downloaded
from <https://hackage.haskell.org/package/pandoc> or
diff --git a/pandoc-cli/man/pandoc-server.1 b/pandoc-cli/man/pandoc-server.1
index 242de0ed7..d4e55c2b3 100644
--- a/pandoc-cli/man/pandoc-server.1
+++ b/pandoc-cli/man/pandoc-server.1
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.2
+.\" Automatically generated by Pandoc 3.2.1
.\"
-.TH "pandoc-server" "1" "August 15, 2022" "pandoc 3.2" "Pandoc User\[cq]s Guide"
+.TH "pandoc-server" "1" "August 15, 2022" "pandoc 3.2.1" "Pandoc User\[cq]s Guide"
.SH SYNOPSIS
\f[CR]pandoc\-server\f[R] [\f[I]options\f[R]]
.SH DESCRIPTION
diff --git a/pandoc-cli/man/pandoc.1 b/pandoc-cli/man/pandoc.1
index d175ac9bb..cf0853692 100644
--- a/pandoc-cli/man/pandoc.1
+++ b/pandoc-cli/man/pandoc.1
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.2
+.\" Automatically generated by Pandoc 3.2.1
.\"
-.TH "pandoc" "1" "May 11, 2024" "pandoc 3.2" "Pandoc User\[cq]s Guide"
+.TH "pandoc" "1" "June 24, 2024" "pandoc 3.2.1" "Pandoc User\[cq]s Guide"
.SH NAME
pandoc - general markup converter
.SH SYNOPSIS
@@ -948,6 +948,10 @@ documents.
This option can be used repeatedly to include multiple files.
They will be included in the order specified.
Implies \f[CR]\-\-standalone\f[R].
+Note that if the output format is \f[CR]odt\f[R], this file must be in
+OpenDocument XML format suitable for insertion into the body of the
+document, and if the output is \f[CR]docx\f[R], this file must be in
+appropriate OpenXML format.
.TP
\f[CR]\-A\f[R] \f[I]FILE\f[R], \f[CR]\-\-include\-after\-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
Include contents of \f[I]FILE\f[R], verbatim, at the end of the document
@@ -956,6 +960,10 @@ body (before the \f[CR]</body>\f[R] tag in HTML, or the
This option can be used repeatedly to include multiple files.
They will be included in the order specified.
Implies \f[CR]\-\-standalone\f[R].
+Note that if the output format is \f[CR]odt\f[R], this file must be in
+OpenDocument XML format suitable for insertion into the body of the
+document, and if the output is \f[CR]docx\f[R], this file must be in
+appropriate OpenXML format.
.TP
\f[CR]\-\-resource\-path=\f[R]\f[I]SEARCHPATH\f[R]
List of paths to search for images and other resources.
@@ -1018,6 +1026,15 @@ cannot be incorporated; as a result, fonts may be missing when
\f[CR]\-\-mathjax\f[R] is used, and some advanced features (e.g.\ zoom
or speaker notes) may not work in an offline \[lq]self\-contained\[rq]
\f[CR]reveal.js\f[R] slide show.
+.RS
+.PP
+For SVG images, \f[CR]img\f[R] tags with \f[CR]data:\f[R] URIs are used,
+unless the image has the class \f[CR]inline\-svg\f[R], in which case an
+inline SVG element is inserted.
+This approach is recommended when there are many occurrences of the same
+SVG in a document, as \f[CR]<use>\f[R] elements will be used to reduce
+duplication.
+.RE
.TP
\f[CR]\-\-html\-q\-tags[=true|false]\f[R]
Use \f[CR]<q>\f[R] tags for quotes in HTML.
@@ -2698,8 +2715,8 @@ header\-includes: |
.SS Variables for HTML math
.TP
\f[CR]classoption\f[R]
-when using KaTeX, you can render display math equations flush left using
-YAML metadata or with \f[CR]\-M classoption=fleqn\f[R].
+when using \f[CR]\-\-katex\f[R], you can render display math equations
+flush left using YAML metadata or with \f[CR]\-M classoption=fleqn\f[R].
.SS Variables for HTML slides
These affect HTML output when producing slide shows with pandoc.
.TP
@@ -2965,11 +2982,14 @@ Font fallbacks currently only work with \f[CR]lualatex\f[R].
a map of Babel language names (e.g.\ \f[CR]chinese\f[R]) to the font to
be used with the language:
.RS
-.PP
- * * * * *
-.PP
-babelfonts: chinese\-hant: \[lq]Noto Serif CJK TC\[rq] russian:
-\[lq]Noto Serif\[rq] \&...
+.IP
+.EX
+\-\-\-
+babelfonts:
+ chinese\-hant: \[dq]Noto Serif CJK TC\[dq]
+ russian: \[dq]Noto Serif\[dq]
+\&...
+.EE
.RE
.TP
\f[CR]microtypeoptions\f[R]
@@ -3158,6 +3178,14 @@ header in man pages
.TP
\f[CR]section\f[R]
section number in man pages
+.SS Variables for Texinfo
+.TP
+\f[CR]version\f[R]
+version of software (used in title and title page)
+.TP
+\f[CR]filename\f[R]
+name of info file to be generated (defaults to a name based on the texi
+filename)
.SS Variables for Typst
.TP
\f[CR]margin\f[R]
@@ -6056,8 +6084,8 @@ opposed to being parsed as paragraphs).
Supports GitHub\-style Markdown alerts, like
.IP
.EX
-> [!INFO]
-> This is an informational message.
+> [!TIP]
+> Helpful advice for doing things better or more easily.
.EE
.SS Extension: \f[CR]autolink_bare_uris\f[R]
Makes all absolute URIs into links, even when not surrounded by pointy
@@ -6883,6 +6911,8 @@ contents...
:::
::::::::::::::
.EE
+.PP
+Note: Specifying column widths does not currently work for PowerPoint.
.SS Additional columns attributes in beamer
The div containers with classes \f[CR]columns\f[R] and \f[CR]column\f[R]
can optionally have an \f[CR]align\f[R] attribute.
@@ -6967,8 +6997,8 @@ slide.
Note that for reveal.js, the \f[CR]background\-image\f[R] will be used
as a \f[CR]parallaxBackgroundImage\f[R] (see below).
.PP
-For pptx, you can use a reference doc in which background images have
-been set on the relevant layouts.
+For pptx, you can use a \f[CR]\-\-reference\-doc\f[R] in which
+background images have been set on the relevant layouts.
.SS \f[CR]parallaxBackgroundImage\f[R] (reveal.js)
For reveal.js, there is also the reveal.js\-native option
\f[CR]parallaxBackgroundImage\f[R], which produces a parallax scrolling
@@ -7005,8 +7035,8 @@ It must contain a map of attribute names and values.
(Note that the \f[CR]data\-\f[R] prefix is required here, as it
isn\[cq]t added automatically.)
.PP
-For pptx, pass a reference doc with the background image set on the
-\[lq]Title Slide\[rq] layout.
+For pptx, pass a \f[CR]\-\-reference\-doc\f[R] with the background image
+set on the \[lq]Title Slide\[rq] layout.
.SS Example (reveal.js)
.IP
.EX
@@ -7717,8 +7747,6 @@ with \f[CR]lua\f[R] as the first argument will make it function as a
standalone Lua interpreter.
The behavior is mostly identical to that of the standalone
\f[CR]lua\f[R] executable, version 5.4.
-However, there is no REPL yet, and the \f[CR]\-i\f[R] option has no
-effect.
For full documentation, see the pandoc\-lua man page.
.SH A NOTE ON SECURITY
.IP "1." 3