Update date in manual and man page.
This commit is contained in:
parent
e8a9de3f68
commit
4e6edd2d0d
2 changed files with 40 additions and 20 deletions
|
@ -1,6 +1,6 @@
|
||||||
% Pandoc User's Guide
|
% Pandoc User's Guide
|
||||||
% John MacFarlane
|
% John MacFarlane
|
||||||
% October 26, 2016
|
% November 30, 2016
|
||||||
|
|
||||||
Synopsis
|
Synopsis
|
||||||
========
|
========
|
||||||
|
|
58
man/pandoc.1
58
man/pandoc.1
|
@ -1,5 +1,5 @@
|
||||||
.\"t
|
.\"t
|
||||||
.TH PANDOC 1 "October 26, 2016" "pandoc 1.18"
|
.TH PANDOC 1 "November 30, 2016" "pandoc 1.19"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
pandoc - general markup converter
|
pandoc - general markup converter
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
|
@ -446,7 +446,7 @@ Reading binary files (docx, odt, epub) implies \f[C]\-\-file\-scope\f[].
|
||||||
.RS
|
.RS
|
||||||
.RE
|
.RE
|
||||||
.TP
|
.TP
|
||||||
.B \f[C]\-\-filter=\f[]\f[I]EXECUTABLE\f[]
|
.B \f[C]\-\-filter=\f[]\f[I]PROGRAM\f[]
|
||||||
Specify an executable to be used as a filter transforming the pandoc AST
|
Specify an executable to be used as a filter transforming the pandoc AST
|
||||||
after the input is parsed and before the output is written.
|
after the input is parsed and before the output is written.
|
||||||
The executable should read JSON from stdin and write JSON to stdout.
|
The executable should read JSON from stdin and write JSON to stdout.
|
||||||
|
@ -480,12 +480,6 @@ Those who would prefer to write filters in python can use the module
|
||||||
There are also pandoc filter libraries in PHP, perl, and
|
There are also pandoc filter libraries in PHP, perl, and
|
||||||
javascript/node.js.
|
javascript/node.js.
|
||||||
.PP
|
.PP
|
||||||
If no directory is provided pandoc will look for executable or
|
|
||||||
non\-executable filters in the director \f[C]$DATADIR/filters\f[], and
|
|
||||||
then for executable filters in the user\[aq]s \f[C]PATH\f[].
|
|
||||||
If you want to run a script in the working directory, preface the
|
|
||||||
filename with \f[C]\&./\f[].
|
|
||||||
.PP
|
|
||||||
In order of preference, pandoc will look for filters in
|
In order of preference, pandoc will look for filters in
|
||||||
.IP "1." 3
|
.IP "1." 3
|
||||||
a specified full or relative path (executable or non\-executable)
|
a specified full or relative path (executable or non\-executable)
|
||||||
|
@ -773,12 +767,13 @@ Deprecated synonym for \f[C]\-\-top\-level\-division=chapter\f[].
|
||||||
.RS
|
.RS
|
||||||
.RE
|
.RE
|
||||||
.TP
|
.TP
|
||||||
.B \f[C]\-\-top\-level\-division=[section|chapter|part]\f[]
|
.B \f[C]\-\-top\-level\-division=[default|section|chapter|part]\f[]
|
||||||
Treat top\-level headers as the given division type in LaTeX, ConTeXt,
|
Treat top\-level headers as the given division type in LaTeX, ConTeXt,
|
||||||
DocBook, and TEI output.
|
DocBook, and TEI output.
|
||||||
The hierarchy order is part, chapter, then section; all headers are
|
The hierarchy order is part, chapter, then section; all headers are
|
||||||
shifted such that the top\-level header becomes the specified type.
|
shifted such that the top\-level header becomes the specified type.
|
||||||
The default is \f[C]section\f[].
|
The default behavior is to determine the best division type via
|
||||||
|
heuristics: unless other conditions apply, \f[C]section\f[] is chosen.
|
||||||
When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
|
When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
|
||||||
or \f[C]memoir\f[] (unless the \f[C]article\f[] option is specified),
|
or \f[C]memoir\f[] (unless the \f[C]article\f[] option is specified),
|
||||||
\f[C]chapter\f[] is implied as the setting for this option.
|
\f[C]chapter\f[] is implied as the setting for this option.
|
||||||
|
@ -2277,8 +2272,9 @@ Currently, the only output formats that uses this information are HTML
|
||||||
and LaTeX.
|
and LaTeX.
|
||||||
If highlighting is supported for your output format and language, then
|
If highlighting is supported for your output format and language, then
|
||||||
the code block above will appear highlighted, with numbered lines.
|
the code block above will appear highlighted, with numbered lines.
|
||||||
(To see which languages are supported, do \f[C]pandoc\ \-\-version\f[].)
|
(To see which languages are supported, type
|
||||||
Otherwise, the code block above will appear as follows:
|
\f[C]pandoc\ \-\-list\-highlight\-languages\f[].) Otherwise, the code
|
||||||
|
block above will appear as follows:
|
||||||
.IP
|
.IP
|
||||||
.nf
|
.nf
|
||||||
\f[C]
|
\f[C]
|
||||||
|
@ -2913,9 +2909,31 @@ The row of \f[C]=\f[]s separates the header from the table body, and can
|
||||||
be omitted for a headerless table.
|
be omitted for a headerless table.
|
||||||
The cells of grid tables may contain arbitrary block elements (multiple
|
The cells of grid tables may contain arbitrary block elements (multiple
|
||||||
paragraphs, code blocks, lists, etc.).
|
paragraphs, code blocks, lists, etc.).
|
||||||
Alignments are not supported, nor are cells that span multiple columns
|
Cells that span multiple columns or rows are not supported.
|
||||||
or rows.
|
|
||||||
Grid tables can be created easily using Emacs table mode.
|
Grid tables can be created easily using Emacs table mode.
|
||||||
|
.PP
|
||||||
|
Alignments can be specified as with pipe tables, by putting colons at
|
||||||
|
the boundaries of the separator line after the header:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
||||||
|
|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
|
||||||
|
+==============:+:==============+:==================:+
|
||||||
|
|\ Bananas\ \ \ \ \ \ \ |\ $1.34\ \ \ \ \ \ \ \ \ |\ built\-in\ wrapper\ \ \ |
|
||||||
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
|
.PP
|
||||||
|
For headerless tables, the colons go on the top line instead:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+
|
||||||
|
|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
|
||||||
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
.SS Extension: \f[C]pipe_tables\f[]
|
.SS Extension: \f[C]pipe_tables\f[]
|
||||||
.PP
|
.PP
|
||||||
Pipe tables look like this:
|
Pipe tables look like this:
|
||||||
|
@ -4898,14 +4916,16 @@ Pandoc will automatically highlight syntax in fenced code blocks that
|
||||||
are marked with a language name.
|
are marked with a language name.
|
||||||
The Haskell library highlighting\-kate is used for highlighting, which
|
The Haskell library highlighting\-kate is used for highlighting, which
|
||||||
works in HTML, Docx, and LaTeX/PDF output.
|
works in HTML, Docx, and LaTeX/PDF output.
|
||||||
|
To see a list of language names that pandoc will recognize, type
|
||||||
|
\f[C]pandoc\ \-\-list\-highlight\-languages\f[].
|
||||||
|
.PP
|
||||||
The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
|
The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
|
||||||
option.
|
option.
|
||||||
The default color scheme is \f[C]pygments\f[], which imitates the
|
The default color scheme is \f[C]pygments\f[], which imitates the
|
||||||
default color scheme used by the Python library pygments, but pygments
|
default color scheme used by the Python library pygments (though
|
||||||
is not actually used to do the highlighting.
|
pygments is not actually used to do the highlighting).
|
||||||
.PP
|
To see a list of highlight styles, type
|
||||||
To see a list of language names that pandoc will recognize, type
|
\f[C]pandoc\ \-\-list\-hightlight\-styles\f[].
|
||||||
\f[C]pandoc\ \-\-version\f[].
|
|
||||||
.PP
|
.PP
|
||||||
To disable highlighting, use the \f[C]\-\-no\-highlight\f[] option.
|
To disable highlighting, use the \f[C]\-\-no\-highlight\f[] option.
|
||||||
.SH CUSTOM STYLES IN DOCX OUTPUT
|
.SH CUSTOM STYLES IN DOCX OUTPUT
|
||||||
|
|
Loading…
Add table
Reference in a new issue