aboutsummaryrefslogtreecommitdiff
path: root/pandoc-cli
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2024-12-07 17:34:04 -0800
committerJohn MacFarlane <[email protected]>2024-12-07 17:34:04 -0800
commit59d4c5e5f29938eeaddc5138df38880a6c5ae64a (patch)
treefec1ed08e0dea82f8d87ed7fcde0cdb360a4c04c /pandoc-cli
parent9adfc7d16e2e5dcbe3d04d35bf79e38fd151c246 (diff)
Date manual and regenerate man pages.
Diffstat (limited to 'pandoc-cli')
-rw-r--r--pandoc-cli/man/pandoc-lua.14
-rw-r--r--pandoc-cli/man/pandoc-server.14
-rw-r--r--pandoc-cli/man/pandoc.136
3 files changed, 31 insertions, 13 deletions
diff --git a/pandoc-cli/man/pandoc-lua.1 b/pandoc-cli/man/pandoc-lua.1
index e7bae40c8..a50033d83 100644
--- a/pandoc-cli/man/pandoc-lua.1
+++ b/pandoc-cli/man/pandoc-lua.1
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.5
+.\" Automatically generated by Pandoc 3.6
.\"
-.TH "pandoc-lua" "1" "September 22, 2022" "pandoc 3.5" "Pandoc User\[cq]s Guide"
+.TH "pandoc-lua" "1" "September 22, 2022" "pandoc 3.6" "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]]]
diff --git a/pandoc-cli/man/pandoc-server.1 b/pandoc-cli/man/pandoc-server.1
index c2fbb98a9..3ccc4cc64 100644
--- a/pandoc-cli/man/pandoc-server.1
+++ b/pandoc-cli/man/pandoc-server.1
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.5
+.\" Automatically generated by Pandoc 3.6
.\"
-.TH "pandoc-server" "1" "August 15, 2022" "pandoc 3.5" "Pandoc User\[cq]s Guide"
+.TH "pandoc-server" "1" "August 15, 2022" "pandoc 3.6" "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 3fa285023..1b9f2e7da 100644
--- a/pandoc-cli/man/pandoc.1
+++ b/pandoc-cli/man/pandoc.1
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.5
+.\" Automatically generated by Pandoc 3.6
.\"
-.TH "pandoc" "1" "October 5, 2024" "pandoc 3.5" "Pandoc User\[cq]s Guide"
+.TH "pandoc" "1" "December 7, 2024" "pandoc 3.6" "Pandoc User\[cq]s Guide"
.SH NAME
pandoc - general markup converter
.SH SYNOPSIS
@@ -266,6 +266,8 @@ if you need extensions not supported in \f[CR]gfm\f[R].
.IP \[bu] 2
\f[CR]man\f[R] (roff man)
.IP \[bu] 2
+\f[CR]mdoc\f[R] (mdoc manual page markup)
+.IP \[bu] 2
\f[CR]muse\f[R] (Muse)
.IP \[bu] 2
\f[CR]native\f[R] (native Haskell)
@@ -785,10 +787,13 @@ output format will be used (see
\f[CR]\-D/\-\-print\-default\-template\f[R]).
.TP
\f[CR]\-V\f[R] \f[I]KEY\f[R][\f[CR]=\f[R]\f[I]VAL\f[R]], \f[CR]\-\-variable=\f[R]\f[I]KEY\f[R][\f[CR]:\f[R]\f[I]VAL\f[R]]
-Set the template variable \f[I]KEY\f[R] to the value \f[I]VAL\f[R] when
-rendering the document in standalone mode.
+Set the template variable \f[I]KEY\f[R] to the string value
+\f[I]VAL\f[R] when rendering the document in standalone mode.
If no \f[I]VAL\f[R] is specified, the key will be given the value
\f[CR]true\f[R].
+Structured values (lists, maps) cannot be assigned using this option,
+but they can be assigned in the \f[CR]variables\f[R] section of a
+defaults file.
.TP
\f[CR]\-\-sandbox[=true|false]\f[R]
Run pandoc in a sandbox, limiting IO operations in readers and writers
@@ -2177,14 +2182,23 @@ format \f[I]FORMAT\f[R] by putting a file
For \f[CR]odt\f[R] output, customize the \f[CR]default.opendocument\f[R]
template.
.IP \[bu] 2
+For \f[CR]docx\f[R] output, customize the \f[CR]default.openxml\f[R]
+template.
+.IP \[bu] 2
For \f[CR]pdf\f[R] output, customize the \f[CR]default.latex\f[R]
template (or the \f[CR]default.context\f[R] template, if you use
\f[CR]\-t context\f[R], or the \f[CR]default.ms\f[R] template, if you
use \f[CR]\-t ms\f[R], or the \f[CR]default.html\f[R] template, if you
use \f[CR]\-t html\f[R]).
.IP \[bu] 2
-\f[CR]docx\f[R] and \f[CR]pptx\f[R] have no template (however, you can
-use \f[CR]\-\-reference\-doc\f[R] to customize the output).
+\f[CR]pptx\f[R] has no template.
+.PP
+Note that \f[CR]docx\f[R], \f[CR]odt\f[R], and \f[CR]pptx\f[R] output
+can also be customized using \f[CR]\-\-reference\-doc\f[R].
+Use a reference doc to adjust the styles in your document; use a
+template to handle variable interpolation and customize the presentation
+of metadata, the position of the table of contents, boilerplate text,
+etc.
.PP
Templates contain \f[I]variables\f[R], which allow for the inclusion of
arbitrary information at any point in the file.
@@ -2425,9 +2439,9 @@ A separator between values of an array may be specified in square
brackets, immediately after the variable name or partial:
.IP
.EX
-${months[, ]}$
+${months[, ]}
-${articles:bibentry()[; ]$
+${articles:bibentry()[; ]}
.EE
.PP
The separator in this case is literal and (unlike with \f[CR]sep\f[R] in
@@ -3274,6 +3288,10 @@ Font size (e.g., \f[CR]12pt\f[R]).
\f[CR]section\-numbering\f[R]
Schema to use for numbering sections, e.g.\ \f[CR]1.A.1\f[R].
.TP
+\f[CR]page\-numbering\f[R]
+Schema to use for numbering pages, e.g.\ \f[CR]1\f[R] or \f[CR]i\f[R],
+or an empty string to omit page numbering.
+.TP
\f[CR]columns\f[R]
Number of columns for body text.
.SS Variables for ms
@@ -7136,7 +7154,7 @@ Slide 2 has a special image for its background, even though the heading has no c
EPUB metadata may be specified using the \f[CR]\-\-epub\-metadata\f[R]
option, but if the source document is Markdown, it is better to use a
YAML metadata block.
-Here is an example:
+Here is an example of a YAML metadata block with EPUB metadata:
.IP
.EX
\-\-\-