Add manual section on pandoc-server.

This commit is contained in:
John MacFarlane 2022-08-17 12:38:11 -07:00
parent 8ddc2fc79a
commit e70c6c40c1

View file

@ -7051,6 +7051,25 @@ Some document formats also include a unique identifier. For
EPUB, this can be set explicitly by setting the `identifier`
metadata field (see [EPUB Metadata], above).
# Running pandoc as a web server
If you rename (or symlink) the pandoc executable to
`pandoc-server`, it will start up a web server with a JSON
API. This server exposes most of the conversion functionality
of pandoc. For full documentation, see the [pandoc-server]
man page.
If you rename (or symlink) the pandoc executable to
`pandoc-server.cgi`, it will function as a CGI program
exposing the same API as `pandoc-server`.
`pandoc-server` is designed to be maximally secure; it uses
Haskell's type system to provide strong guarantees that no I/O
will be performed on the server during pandoc conversions.
[pandoc-server]: https://github.com/jgm/pandoc/blob/master/doc/pandoc-server.md
# A note on security
1. Although pandoc itself will not create or modify any files other