mirror of
https://github.com/johnkerl/miller.git
synced 2026-07-24 00:18:39 +00:00
e0ed7e469c
* 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>
1.2 KiB
1.2 KiB
Quick links:
Flags
Verbs
Functions
Glossary
Release docs
# Why call it Miller?
The Unix toolkit was created in the 1970s and is a mainstay to this day. Miller's look and feel adheres closely to the classic toolkit style: if this were music, Miller would be a tribute album. Likewise, since commands are subcommands of the mlr executable, the result is a band, if you will, of command-line tools. Put these together and the namesake is another classic product of the 1970s: the Steve Miller Band.
(Additionally, and far more prosaically ... just as a miller is someone who grinds and mixes grain into flour to extend its usefulness, Miller grinds and mixes data for you.)