* Publish an epub of the docs on Read the Docs (#1835)
Read the Docs' built-in formats support (the existing formats: all in
.readthedocs.yaml) only produces epub/PDF for Sphinx projects, and is a
silent no-op for MkDocs ones. Instead, per RTD's documented
build-customization path, generate the epub ourselves in a post_build
job and place it in $READTHEDOCS_OUTPUT/epub/, which RTD then publishes
on the project Downloads page and in the docs flyout menu.
The epub itself is built by the new docs/build-epub.sh: it takes the
committed, generated Markdown pages in docs/src in mkdocs.yml nav
order, strips the HTML-only quicklinks header from each page, and runs
pandoc (installed on RTD via build.apt_packages). Locally, `make -C
docs epub` does the same for anyone with pandoc installed; nothing here
is part of `make dev` or any default build path.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* fix misrender
---------
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
* Draw a distinction between JSON and JSON Lines formats
* Add JSON Lines to on-line help example
* Have JSON format default to --jlistwrap and --jvstack
* Update test cases for --jlistwrap output for JSON output format
* Have JSON format default to --jlistwrap and --jvstack for --{X}2j as well
* Make --jlistwrap / --jvstack as legacy flags, since now --json and --jsonl
* Add --c2l, --l2c, etc. command-line flags
* docmods for JSON Lines
* Update regression-test cases for JSON / JSON Lines distinction
