diff options
| author | natsuoto <[email protected]> | 2026-04-28 17:22:49 +0530 |
|---|---|---|
| committer | natsuoto <[email protected]> | 2026-04-28 17:22:49 +0530 |
| commit | 8acd77b50930a810a3d53a2a1065b3aaa2129aa0 (patch) | |
| tree | 4a2879160a10b866eba188df3242a55d459643f5 | |
| parent | 0235b4fd7116716707706186081fce73a1c075b2 (diff) | |
| download | edify-8acd77b50930a810a3d53a2a1065b3aaa2129aa0.tar.xz edify-8acd77b50930a810a3d53a2a1065b3aaa2129aa0.zip | |
fix(docs): drop PDF and EPUB builds from Read the Docs
RTD's PDF format was failing because:
1. README.rst's SVG badges can't be embedded by pdflatex
(`Unknown graphics extension: .svg` x 8).
2. The IPA pronunciation `/ˈɛdɪfaɪ/` uses Unicode codepoints not
set up for use with pdflatex (would need xelatex/lualatex).
`latexmk` exited 12, leaving a damaged `edify.pdf` plus aux files in
the output directory; RTD's uploader then refused with "Build output
directory for format 'pdf' contains multiple files."
Removing `formats: all` from `.readthedocs.yml` defaults RTD to HTML
only. PDFs of a regex-builder library aren't worth the maintenance
cost — fixing them would require switching the LaTeX engine and
hiding every badge behind `.. only:: html` directives, with the
guarantee that any new badge or Unicode glyph re-breaks it.
Closes #48
| -rw-r--r-- | .readthedocs.yml | 1 |
1 files changed, 0 insertions, 1 deletions
diff --git a/.readthedocs.yml b/.readthedocs.yml index b554098..3dea7f0 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -6,7 +6,6 @@ build: python: "3.14" sphinx: configuration: docs/conf.py -formats: all python: install: - requirements: docs/requirements.txt |