From b7356d3ddf788d83b41b1100d718087bd83a7506 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Wed, 9 May 2018 11:29:20 -0700 Subject: Restored and undeprecated gladtex for HTML math. - Added `GladTeX` constructor to `Text.Pandoc.Options.HTMLMathMethod` [API change, reverts removal in v2.2] - Restored and undeprecated `--gladtex` option, removed in v2.2. Closes #4607. --- man/pandoc.1 | 46 ++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 40 insertions(+), 6 deletions(-) (limited to 'man') diff --git a/man/pandoc.1 b/man/pandoc.1 index ed9fdb009..5c560f11b 100644 --- a/man/pandoc.1 +++ b/man/pandoc.1 @@ -647,8 +647,7 @@ a specified full or relative path (executable or non\-executable) .B \f[C]\-M\f[] \f[I]KEY\f[][\f[C]=\f[]\f[I]VAL\f[]], \f[C]\-\-metadata=\f[]\f[I]KEY\f[][\f[C]:\f[]\f[I]VAL\f[]] Set the metadata field \f[I]KEY\f[] to the value \f[I]VAL\f[]. A value specified on the command line overrides a value specified in the -document using [YAML metadata -blocks][Extension:\f[C]yaml_metadata_block\f[]]. +document using YAML metadata blocks. Values will be parsed as YAML boolean or string values. If no value is specified, the value will be treated as Boolean true. Like \f[C]\-\-variable\f[], \f[C]\-\-metadata\f[] causes template @@ -727,6 +726,8 @@ Produce output with an appropriate header and footer (e.g. a standalone HTML, LaTeX, TEI, or RTF file, not a fragment). This option is set automatically for \f[C]pdf\f[], \f[C]epub\f[], \f[C]epub3\f[], \f[C]fb2\f[], \f[C]docx\f[], and \f[C]odt\f[] output. +For \f[C]native\f[] output, this option causes metadata to be included; +otherwise, metadata is suppressed. .RS .RE .TP @@ -1413,6 +1414,22 @@ inserted. Note that this option does not imply \f[C]\-\-katex\f[]. .RS .RE +.TP +.B \f[C]\-\-gladtex\f[] +Enclose TeX math in \f[C]\f[] tags in HTML output. +The resulting HTML can then be processed by GladTeX to produce images of +the typeset formulas and an HTML file with links to these images. +So, the procedure is: +.RS +.IP +.nf +\f[C] +pandoc\ \-s\ \-\-gladtex\ input.md\ \-o\ myfile.htex +gladtex\ \-d\ myfile\-images\ myfile.htex +#\ produces\ myfile.html\ and\ images\ in\ myfile\-images +\f[] +.fi +.RE .SS Options for wrapper scripts .TP .B \f[C]\-\-dump\-args\f[] @@ -1489,9 +1506,8 @@ arbitrary information at any point in the file. They may be set at the command line using the \f[C]\-V/\-\-variable\f[] option. If a variable is not set, pandoc will look for the key in the -document\[aq]s metadata \[en] which can be set using either [YAML -metadata blocks][Extension:\f[C]yaml_metadata_block\f[]] or with the -\f[C]\-\-metadata\f[] option. +document\[aq]s metadata \[en] which can be set using either YAML +metadata blocks or with the \f[C]\-\-metadata\f[] option. .SS Variables set by pandoc .PP Some variables are set automatically by pandoc. @@ -2081,7 +2097,25 @@ $endif$ .fi .PP This will include \f[C]X\f[] in the template if \f[C]variable\f[] has a -non\-null value; otherwise it will include \f[C]Y\f[]. +truthy value; otherwise it will include \f[C]Y\f[]. +Here a truthy value is any of the following: +.IP \[bu] 2 +a string that is not entirely white space, +.IP \[bu] 2 +a non\-empty array where the first value is truthy, +.IP \[bu] 2 +any number (including zero), +.IP \[bu] 2 +any object, +.IP \[bu] 2 +the boolean \f[C]true\f[] (to specify the boolean \f[C]true\f[] value +using YAML metadata or the \f[C]\-\-metadata\f[] flag, use \f[C]y\f[], +\f[C]Y\f[], \f[C]yes\f[], \f[C]Yes\f[], \f[C]YES\f[], \f[C]true\f[], +\f[C]True\f[], \f[C]TRUE\f[], \f[C]on\f[], \f[C]On\f[], or \f[C]ON\f[]; +with the \f[C]\-\-variable\f[] flag, simply omit a value for the +variable, e.g. +\f[C]\-\-variable\ draft\f[]). +.PP \f[C]X\f[] and \f[C]Y\f[] are placeholders for any valid template text, and may include interpolated variables or other conditionals. The \f[C]$else$\f[] section may be omitted. -- cgit v1.2.3 From 32ef6f91fd0332e0337db2b28932f51cecb24f62 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Thu, 10 May 2018 21:44:32 -0700 Subject: Update manual date and man page. --- MANUAL.txt | 2 +- man/pandoc.1 | 16 +++++++++------- 2 files changed, 10 insertions(+), 8 deletions(-) (limited to 'man') diff --git a/MANUAL.txt b/MANUAL.txt index a363a20a7..595dab5ce 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1,6 +1,6 @@ % Pandoc User's Guide % John MacFarlane -% April 26, 2018 +% May 10, 2018 Synopsis ======== diff --git a/man/pandoc.1 b/man/pandoc.1 index 5c560f11b..e57597996 100644 --- a/man/pandoc.1 +++ b/man/pandoc.1 @@ -1,5 +1,5 @@ .\"t -.TH PANDOC 1 "April 26, 2018" "pandoc 2.2" +.TH PANDOC 1 "May 10, 2018" "pandoc 2.2" .SH NAME pandoc - general markup converter .SH SYNOPSIS @@ -3620,12 +3620,14 @@ orange|3.09 The cells of pipe tables cannot contain block elements like paragraphs and lists, and cannot span multiple lines. If a pipe table contains a row whose printable content is wider than the -column width (see \f[C]\-\-columns\f[]), then the cell contents will -wrap, with the relative cell widths determined by the widths of the -separator lines. -(In this case, the table will take up the full text width.) If no lines -are wider than column width, then cell contents will not be wrapped, and -the cells will be sized to their contents. +column width (see \f[C]\-\-columns\f[]), then the table will take up the +full text width and the cell contents will wrap, with the relative cell +widths determined by the number of dashes in the line separating the +table header from the table body. +(For example \f[C]\-\-\-|\-\f[] would make the first column 3/4 and the +second column 1/4 of the full text width.) On the other hand, if no +lines are wider than column width, then cell contents will not be +wrapped, and the cells will be sized to their contents. .PP Note: pandoc also recognizes pipe tables of the following form, as can be produced by Emacs\[aq] orgtbl\-mode: -- cgit v1.2.3 From 3016a9f9df0d0bd7d510df5c292917f929772bea Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Thu, 10 May 2018 21:46:24 -0700 Subject: Update version on man page. --- man/pandoc.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'man') diff --git a/man/pandoc.1 b/man/pandoc.1 index e57597996..1379133f2 100644 --- a/man/pandoc.1 +++ b/man/pandoc.1 @@ -1,5 +1,5 @@ .\"t -.TH PANDOC 1 "May 10, 2018" "pandoc 2.2" +.TH PANDOC 1 "May 10, 2018" "pandoc 2.2.1" .SH NAME pandoc - general markup converter .SH SYNOPSIS -- cgit v1.2.3