|
1 | | -.\" Automatically generated by Pandoc 3.6.1 |
| 1 | +.\" Automatically generated by Pandoc 3.6.2 |
2 | 2 | .\" |
3 | | -.TH "pandoc" "1" "December 22, 2024" "pandoc 3.6.1" "Pandoc User\[cq]s Guide" |
| 3 | +.TH "pandoc" "1" "January 12, 2025" "pandoc 3.6.2" "Pandoc User\[cq]s Guide" |
4 | 4 | .SH NAME |
5 | 5 | pandoc - general markup converter |
6 | 6 | .SH SYNOPSIS |
@@ -278,6 +278,8 @@ if you need extensions not supported in \f[CR]gfm\f[R]. |
278 | 278 | .IP \[bu] 2 |
279 | 279 | \f[CR]org\f[R] (Emacs Org mode) |
280 | 280 | .IP \[bu] 2 |
| 281 | +\f[CR]pod\f[R] (Perl\[cq]s Plain Old Documentation) |
| 282 | +.IP \[bu] 2 |
281 | 283 | \f[CR]ris\f[R] (RIS bibliography) |
282 | 284 | .IP \[bu] 2 |
283 | 285 | \f[CR]rtf\f[R] (Rich Text Format) |
@@ -3721,11 +3723,14 @@ This extension can be enabled/disabled for the following formats: |
3721 | 3723 | output formats |
3722 | 3724 | \f[CR]odt\f[R], \f[CR]opendocument\f[R] |
3723 | 3725 | .SS Extension: \f[CR]styles\f[R] |
3724 | | -When converting from docx, read all docx styles as divs (for paragraph |
3725 | | -styles) and spans (for character styles) regardless of whether pandoc |
3726 | | -understands the meaning of these styles. |
3727 | | -This can be used with docx custom styles. |
3728 | | -Disabled by default. |
| 3726 | +When converting from docx, add \f[CR]custom\-styles\f[R] attributes for |
| 3727 | +all docx styles, regardless of whether pandoc understands the meanings |
| 3728 | +of these styles. |
| 3729 | +Because attributes cannot be added directly to paragraphs or text in the |
| 3730 | +pandoc AST, paragraph styles will cause Divs to be created and character |
| 3731 | +styles will cause Spans to be created to hold the attributes. |
| 3732 | +(Table styles will be added to the Table elements directly.) |
| 3733 | +This extension can be used with docx custom styles. |
3729 | 3734 | .TP |
3730 | 3735 | input formats |
3731 | 3736 | \f[CR]docx\f[R] |
@@ -7605,7 +7610,7 @@ preexisting set of styles, pandoc allows you to define custom styles for |
7605 | 7610 | blocks and text using \f[CR]div\f[R]s and \f[CR]span\f[R]s, |
7606 | 7611 | respectively. |
7607 | 7612 | .PP |
7608 | | -If you define a \f[CR]div\f[R] or \f[CR]span\f[R] with the attribute |
| 7613 | +If you define a Div, Span, or Table with the attribute |
7609 | 7614 | \f[CR]custom\-style\f[R], pandoc will apply your specified style to the |
7610 | 7615 | contained elements (with the exception of elements whose function |
7611 | 7616 | depends on a style, like headings, code blocks, block quotes, or links). |
@@ -7655,8 +7660,10 @@ derivation of the input document\[cq]s styles. |
7655 | 7660 | By enabling the \f[CR]styles\f[R] extension in the docx reader |
7656 | 7661 | (\f[CR]\-f docx+styles\f[R]), you can produce output that maintains the |
7657 | 7662 | styles of the input document, using the \f[CR]custom\-style\f[R] class. |
7658 | | -Paragraph styles are interpreted as divs, while character styles are |
7659 | | -interpreted as spans. |
| 7663 | +A \f[CR]custom\-style\f[R] attribute will be added for each style. |
| 7664 | +Divs will be created to hold the paragraph styles, and Spans to hold the |
| 7665 | +character styles. |
| 7666 | +Table styles will be applied directly to the Table. |
7660 | 7667 | .PP |
7661 | 7668 | For example, using the \f[CR]custom\-style\-reference.docx\f[R] file in |
7662 | 7669 | the test directory, we have the following different outputs: |
|
0 commit comments