diff options
| -rw-r--r-- | MANUAL.txt | 2 | ||||
| -rw-r--r-- | README.md | 1 | ||||
| -rw-r--r-- | man/pandoc-lua.1 | 30 | ||||
| -rw-r--r-- | man/pandoc.1 | 26 |
4 files changed, 50 insertions, 9 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index 47624d502..309204a6a 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1,7 +1,7 @@ --- title: Pandoc User's Guide author: John MacFarlane -date: March 5, 2023 +date: March 26, 2023 --- # Synopsis @@ -198,6 +198,7 @@ It can convert *to* - `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript slide show) - `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple)) +- `typst` ([typst](https://typst.app)) - `xwiki` ([XWiki markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/)) - `zimwiki` ([ZimWiki diff --git a/man/pandoc-lua.1 b/man/pandoc-lua.1 index 6388fb27f..ce21b6647 100644 --- a/man/pandoc-lua.1 +++ b/man/pandoc-lua.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 3.0 +.\" Automatically generated by Pandoc 3.0.1 .\" .\" Define V font for inline verbatim, using C font in formats .\" that render this, and otherwise B font. @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "pandoc-lua" "1" "September 22, 2022" "pandoc-lua 3.0.1" "" +.TH "pandoc-lua" "1" "September 22, 2022" "pandoc-lua 3.1.1" "" .hy .SH SYNOPSIS .PP @@ -33,7 +33,11 @@ startup. .PP If no script argument is given, then the script is assumed to be passed in via \f[I]stdin\f[R]. -Interactive mode is not supported at this time. +When called without arguments, \f[V]pandoc-lua\f[R] behaves as +\f[V]pandoc-lua -v -i\f[R] when the standard input (\f[V]stdin\f[R]) is +a terminal, and as \f[V]pandoc-lua -\f[R] otherwise. +On Windows the program will always behave as if it was connected to a +terminal. .PP When called without the option \f[V]-E\f[R], the interpreter checks for an environment variable \f[V]LUA_INIT\f[R] before running any argument. @@ -55,7 +59,7 @@ global \f[V]mod\f[R]. Show version information. .TP \f[V]-i\f[R] -Not supported yet; print a warning to that effect. +Enter interactive mode after running \f[I]script\f[R]. .TP \f[V]-E\f[R] Ignore environment variables. @@ -66,9 +70,25 @@ Other variables like \f[V]LUA_PATH\f[R] and \f[V]LUA_CPATH\f[R] are .TP \f[V]-W\f[R] Turn warnings on. +.SH INTERACTIVE MODE +.PP +In interactive mode, the Lua interpreter repeatedly prompts and waits +for a line. +After reading a line, Lua first tries to interpret the line as an +expression. +If it succeeds, it prints its value. +Otherwise, it interprets the line as a statement. +If you write an incomplete statement, the interpreter waits for its +completion by issuing a different prompt. +.PP +Exit the interactive mode by pressing \f[V]Ctrl-D\f[R] or +\f[V]Ctrl-C\f[R], or by typing \f[V]os.exit()\f[R]. +The \f[I]Isocline\f[R] library is used for line editing. +Press \f[V]F1\f[R] to get a list of available keybindings; the +\f[V]ctrl\f[R] key is abbreviated as \f[V]\[ha]\f[R] in that list. .SH AUTHORS .PP -Copyright 2022 John MacFarlane (jgm\[at]berkeley.edu) and contributors. +Copyright 2023 John MacFarlane (jgm\[at]berkeley.edu) and contributors. Released under the GPL, version 2 or later. This software carries no warranty of any kind. (See COPYRIGHT for full copyright and warranty notices.) diff --git a/man/pandoc.1 b/man/pandoc.1 index 6b1bf81d1..bb7f6ccf3 100644 --- a/man/pandoc.1 +++ b/man/pandoc.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "Pandoc User\[cq]s Guide" "" "March 5, 2023" "pandoc 3.1.1" "" +.TH "Pandoc User\[cq]s Guide" "" "March 26, 2023" "pandoc 3.1.1" "" .hy .SH NAME pandoc - general markup converter @@ -452,6 +452,8 @@ markup) .IP \[bu] 2 \f[V]tei\f[R] (TEI Simple) .IP \[bu] 2 +\f[V]typst\f[R] (typst) +.IP \[bu] 2 \f[V]xwiki\f[R] (XWiki markup) .IP \[bu] 2 \f[V]zimwiki\f[R] (ZimWiki markup) @@ -491,7 +493,7 @@ variable). If that directory does not exist and \f[V]$HOME/.pandoc\f[R] exists, it will be used (for backwards compatibility). On Windows the default user data directory is -\f[V]C:\[rs]Users\[rs]USERNAME\[rs]AppData\[rs]Roaming\[rs]pandoc\f[R]. +\f[V]%APPDATA%\[rs]pandoc\f[R]. You can find the default user data directory on your system by looking at the output of \f[V]pandoc --version\f[R]. Data files placed in this directory (for example, @@ -1064,6 +1066,8 @@ Currently this option only affects the \f[V]markdown\f[R], \f[V]muse\f[R], \f[V]html\f[R], \f[V]epub\f[R], \f[V]slidy\f[R], \f[V]s5\f[R], \f[V]slideous\f[R], \f[V]dzslides\f[R], and \f[V]revealjs\f[R] writers. +In slide formats, specifying \f[V]--reference-location=section\f[R] will +cause notes to be rendered at the bottom of a slide. .TP \f[V]--markdown-headings=setext\f[R]|\f[V]atx\f[R] Specify whether to use ATX-style (\f[V]#\f[R]-prefixed) or Setext-style @@ -1228,6 +1232,8 @@ Date .IP \[bu] 2 Abstract .IP \[bu] 2 +AbstractTitle +.IP \[bu] 2 Bibliography .IP \[bu] 2 Heading 1 @@ -1477,7 +1483,8 @@ Use the specified engine when producing PDF output. Valid values are \f[V]pdflatex\f[R], \f[V]lualatex\f[R], \f[V]xelatex\f[R], \f[V]latexmk\f[R], \f[V]tectonic\f[R], \f[V]wkhtmltopdf\f[R], \f[V]weasyprint\f[R], \f[V]pagedjs-cli\f[R], -\f[V]prince\f[R], \f[V]context\f[R], and \f[V]pdfroff\f[R]. +\f[V]prince\f[R], \f[V]context\f[R], \f[V]pdfroff\f[R], and +\f[V]typst\f[R]. If the engine is not in your PATH, the full path of the engine may be specified here. If this option is not specified, pandoc uses the following defaults @@ -1495,6 +1502,8 @@ depending on the output format specified using \f[V]-t/--to\f[R]: print-css.rocks for a good introduction to PDF generation from HTML/CSS) .IP \[bu] 2 \f[V]-t ms\f[R]: \f[V]pdfroff\f[R] +.IP \[bu] 2 +\f[V]-t typst\f[R]: \f[V]typst\f[R] .RE .TP \f[V]--pdf-engine-opt=\f[R]\f[I]STRING\f[R] @@ -3029,6 +3038,17 @@ mainfontoptions: .fi .RE .TP +\f[V]babelfonts\f[R] +a map of Babel language names (e.g.\ \f[V]chinese\f[R]) to the font to +be used with the language: +.RS +.PP + * * * * * +.PP +babelfonts: chinese-hant: \[lq]Noto Serif CJK TC\[rq] russian: \[lq]Noto +Serif\[rq] \&... +.RE +.TP \f[V]microtypeoptions\f[R] options to pass to the microtype package .SS Links |