@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "October 26, 2016" "pandoc 1.18"
2+.TH PANDOC 1 "November 30, 2016" "pandoc 1.19"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -446,7 +446,7 @@ Reading binary files (docx, odt, epub) implies \f[C]\-\-file\-scope\f[].
446446.RS
447447.RE
448448.TP
449−.B \f[C]\-\-filter=\f[]\f[I]EXECUTABLE\f[]
449+.B \f[C]\-\-filter=\f[]\f[I]PROGRAM\f[]
450450Specify an executable to be used as a filter transforming the pandoc AST
451451after the input is parsed and before the output is written.
452452The 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
480480There are also pandoc filter libraries in PHP, perl, and
481481javascript/node.js.
482482.PP
483−If no directory is provided pandoc will look for executable or
484−non\-executable filters in the director \f[C]$DATADIR/filters\f[], and
485−then for executable filters in the user\[aq]s \f[C]PATH\f[].
486−If you want to run a script in the working directory, preface the
487−filename with \f[C]\&./\f[].
488−.PP
489483In order of preference, pandoc will look for filters in
490484.IP "1." 3
491485a specified full or relative path (executable or non\-executable)
@@ -773,12 +767,13 @@ Deprecated synonym for \f[C]\-\-top\-level\-division=chapter\f[].
773767.RS
774768.RE
775769.TP
776−.B \f[C]\-\-top\-level\-division=[section|chapter|part]\f[]
770+.B \f[C]\-\-top\-level\-division=[default|section|chapter|part]\f[]
777771Treat top\-level headers as the given division type in LaTeX, ConTeXt,
778772DocBook, and TEI output.
779773The hierarchy order is part, chapter, then section; all headers are
780774shifted such that the top\-level header becomes the specified type.
781−The default is \f[C]section\f[].
775+The default behavior is to determine the best division type via
776+heuristics: unless other conditions apply, \f[C]section\f[] is chosen.
782777When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
783778or \f[C]memoir\f[] (unless the \f[C]article\f[] option is specified),
784779\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
22772272and LaTeX.
22782273If highlighting is supported for your output format and language, then
22792274the code block above will appear highlighted, with numbered lines.
2280−(To see which languages are supported, do \f[C]pandoc\ \-\-version\f[].)
2281−Otherwise, the code block above will appear as follows:
2275+(To see which languages are supported, type
2276+\f[C]pandoc\ \-\-list\-highlight\-languages\f[].) Otherwise, the code
2277+block above will appear as follows:
22822278.IP
22832279.nf
22842280\f[C]
@@ -2913,9 +2909,31 @@ The row of \f[C]=\f[]s separates the header from the table body, and can
29132909be omitted for a headerless table.
29142910The cells of grid tables may contain arbitrary block elements (multiple
29152911paragraphs, code blocks, lists, etc.).
2916−Alignments are not supported, nor are cells that span multiple columns
2917−or rows.
2912+Cells that span multiple columns or rows are not supported.
29182913Grid tables can be created easily using Emacs table mode.
2914+.PP
2915+Alignments can be specified as with pipe tables, by putting colons at
2916+the boundaries of the separator line after the header:
2917+.IP
2918+.nf
2919+\f[C]
2920++\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
2921+|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
2922++==============:+:==============+:==================:+
2923+|\ Bananas\ \ \ \ \ \ \ |\ $1.34\ \ \ \ \ \ \ \ \ |\ built\-in\ wrapper\ \ \ |
2924++\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
2925+\f[]
2926+.fi
2927+.PP
2928+For headerless tables, the colons go on the top line instead:
2929+.IP
2930+.nf
2931+\f[C]
2932++\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+
2933+|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
2934++\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
2935+\f[]
2936+.fi
29192937.SS Extension: \f[C]pipe_tables\f[]
29202938.PP
29212939Pipe tables look like this:
@@ -4898,14 +4916,16 @@ Pandoc will automatically highlight syntax in fenced code blocks that
48984916are marked with a language name.
48994917The Haskell library highlighting\-kate is used for highlighting, which
49004918works in HTML, Docx, and LaTeX/PDF output.
4919+To see a list of language names that pandoc will recognize, type
4920+\f[C]pandoc\ \-\-list\-highlight\-languages\f[].
4921+.PP
49014922The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
49024923option.
49034924The default color scheme is \f[C]pygments\f[], which imitates the
4904−default color scheme used by the Python library pygments, but pygments
4905−is not actually used to do the highlighting.
4906−.PP
4907−To see a list of language names that pandoc will recognize, type
4908−\f[C]pandoc\ \-\-version\f[].
4925+default color scheme used by the Python library pygments (though
4926+pygments is not actually used to do the highlighting).
4927+To see a list of highlight styles, type
4928+\f[C]pandoc\ \-\-list\-hightlight\-styles\f[].
49094929.PP
49104930To disable highlighting, use the \f[C]\-\-no\-highlight\f[] option.
49114931.SH CUSTOM STYLES IN DOCX OUTPUT