hadley/htmlbook — explained in plain English
Analysis updated 2026-07-07 · repo last pushed 2023-01-26
Convert a Quarto book manuscript into O'Reilly-ready HTML for their Atlas platform.
Publish a data science or technical book written in Quarto through O'Reilly without manual reformatting.
Generate properly structured HTML with chapters, figures, code blocks, and cross-references for O'Reilly.
| hadley/htmlbook | khaosdoctor/dontquotetheai | mastodon/activitypub | |
|---|---|---|---|
| Stars | 12 | 12 | 12 |
| Language | HTML | HTML | HTML |
| Last pushed | 2023-01-26 | — | 2017-09-07 |
| Maintenance | Dormant | — | Dormant |
| Setup difficulty | moderate | easy | easy |
| Complexity | 2/5 | 1/5 | 1/5 |
| Audience | writer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an existing Quarto book project and manual editing of a configuration file to set chapter order before running the conversion.
If you've written a book using Quarto and want to publish it through O'Reilly, this tool bridges the gap. It converts your Quarto book into O'Reilly's specific HTML format, so you can get your manuscript onto their publishing platform without manually reformatting everything. The workflow is straightforward. You first render your Quarto book as you normally would, then run a single command from this tool. It generates a new folder containing the HTML files ready for O'Reilly's Atlas platform. You do need to manually handle one piece: updating a configuration file to make sure your chapters appear in the right order. The tool handles the core elements of a technical book: overall structure with parts and appendices, figures, code blocks, cross-references, callouts, and footnotes. The author notes it's "far from perfect," but it has been used successfully on two real books, R for Data Science and R Packages, so it works for production-quality publishing. This is a niche tool for a specific audience: authors who write in Quarto (popular in the R and data science community) and publish through O'Reilly. If you're not in that intersection, you likely won't need it. But if you are, it saves what would otherwise be a tedious manual conversion process.
Converts Quarto books into O'Reilly's HTML format for their Atlas publishing platform, saving authors from manual reformatting when publishing technical books.
Mainly HTML. The stack also includes HTML, Quarto, CLI.
Dormant — no commits in 2+ years (last push 2023-01-26).
No license information is provided in this repository.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly writer.
This repo across BitVibe Labs
Verify against the repo before relying on details.