Skip to content

Commit

Permalink
Update man pages.
Browse files Browse the repository at this point in the history
  • Loading branch information
jgm committed Jan 12, 2025
1 parent d8fdf9d commit 35cd9a7
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 14 deletions.
4 changes: 2 additions & 2 deletions pandoc-cli/man/pandoc-lua.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc 3.6.1
.\" Automatically generated by Pandoc 3.6.2
.\"
.TH "pandoc-lua" "1" "September 22, 2022" "pandoc 3.6.1" "Pandoc User\[cq]s Guide"
.TH "pandoc-lua" "1" "September 22, 2022" "pandoc 3.6.2" "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]]]
Expand Down
4 changes: 2 additions & 2 deletions pandoc-cli/man/pandoc-server.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc 3.6.1
.\" Automatically generated by Pandoc 3.6.2
.\"
.TH "pandoc-server" "1" "August 15, 2022" "pandoc 3.6.1" "Pandoc User\[cq]s Guide"
.TH "pandoc-server" "1" "August 15, 2022" "pandoc 3.6.2" "Pandoc User\[cq]s Guide"
.SH SYNOPSIS
\f[CR]pandoc\-server\f[R] [\f[I]options\f[R]]
.SH DESCRIPTION
Expand Down
27 changes: 17 additions & 10 deletions pandoc-cli/man/pandoc.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc 3.6.1
.\" Automatically generated by Pandoc 3.6.2
.\"
.TH "pandoc" "1" "December 22, 2024" "pandoc 3.6.1" "Pandoc User\[cq]s Guide"
.TH "pandoc" "1" "January 12, 2025" "pandoc 3.6.2" "Pandoc User\[cq]s Guide"
.SH NAME
pandoc - general markup converter
.SH SYNOPSIS
Expand Down Expand Up @@ -278,6 +278,8 @@ if you need extensions not supported in \f[CR]gfm\f[R].
.IP \[bu] 2
\f[CR]org\f[R] (Emacs Org mode)
.IP \[bu] 2
\f[CR]pod\f[R] (Perl\[cq]s Plain Old Documentation)
.IP \[bu] 2
\f[CR]ris\f[R] (RIS bibliography)
.IP \[bu] 2
\f[CR]rtf\f[R] (Rich Text Format)
Expand Down Expand Up @@ -3721,11 +3723,14 @@ This extension can be enabled/disabled for the following formats:
output formats
\f[CR]odt\f[R], \f[CR]opendocument\f[R]
.SS Extension: \f[CR]styles\f[R]
When converting from docx, read all docx styles as divs (for paragraph
styles) and spans (for character styles) regardless of whether pandoc
understands the meaning of these styles.
This can be used with docx custom styles.
Disabled by default.
When converting from docx, add \f[CR]custom\-styles\f[R] attributes for
all docx styles, regardless of whether pandoc understands the meanings
of these styles.
Because attributes cannot be added directly to paragraphs or text in the
pandoc AST, paragraph styles will cause Divs to be created and character
styles will cause Spans to be created to hold the attributes.
(Table styles will be added to the Table elements directly.)
This extension can be used with docx custom styles.
.TP
input formats
\f[CR]docx\f[R]
Expand Down Expand Up @@ -7605,7 +7610,7 @@ preexisting set of styles, pandoc allows you to define custom styles for
blocks and text using \f[CR]div\f[R]s and \f[CR]span\f[R]s,
respectively.
.PP
If you define a \f[CR]div\f[R] or \f[CR]span\f[R] with the attribute
If you define a Div, Span, or Table with the attribute
\f[CR]custom\-style\f[R], pandoc will apply your specified style to the
contained elements (with the exception of elements whose function
depends on a style, like headings, code blocks, block quotes, or links).
Expand Down Expand Up @@ -7655,8 +7660,10 @@ derivation of the input document\[cq]s styles.
By enabling the \f[CR]styles\f[R] extension in the docx reader
(\f[CR]\-f docx+styles\f[R]), you can produce output that maintains the
styles of the input document, using the \f[CR]custom\-style\f[R] class.
Paragraph styles are interpreted as divs, while character styles are
interpreted as spans.
A \f[CR]custom\-style\f[R] attribute will be added for each style.
Divs will be created to hold the paragraph styles, and Spans to hold the
character styles.
Table styles will be applied directly to the Table.
.PP
For example, using the \f[CR]custom\-style\-reference.docx\f[R] file in
the test directory, we have the following different outputs:
Expand Down

0 comments on commit 35cd9a7

Please sign in to comment.