* 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>
* Move `$[[...]]` and `$[[[...]]]` out of the grammar and into Go
* Update pkg/parsing/mlr.bnf
* Update Go source
* update test files
* Fix NPE
* .gitignore
* more
* Fix C/Go emit/emitp incompatibilities
* Revisit dsl-emit regtests
* Accept venial C/Go differences in the previous
* add dsl-emit-basic-indexing test-suite
* Print testcase/mlr files if mlr regtest -vvv
* Neaten dsl-emit-basic-indexing test suite
* OFLATSEP -> FLATSEP since there is no longer IFLATSEP
* clean-slating the emitter
* gradually putting back emitter pieces
* iterating on indexed case
* rename test cases
* add lashed tests to regtest/cases/dsl-emit-basic-indexing
* Fix non-indexed emit of @* vs lashed
* test-renumbering
* iterating
* refactoring
* renumber test cases
* work off cases one at a time
* fix non-indexed non-lashed emit
* fix non-indexed lashed emit
* fix indexed non-lashed emitp
* fix indexed non-lashed emit
* fix indexed lashed emit
* remove test cases which are non-syntactical in miller6
* accept remaining test cases as improvements
* split out src/entrypoint package
* restore go/README.md which was borked in a refactor somewhen
* iterate in windows args-getter
* iterate on windows args-getter
* fix windows args-getter
* comments
