From 8acd77b50930a810a3d53a2a1065b3aaa2129aa0 Mon Sep 17 00:00:00 2001 From: natsuoto <279971144+natsuoto@users.noreply.github.com> Date: Tue, 28 Apr 2026 17:22:49 +0530 Subject: fix(docs): drop PDF and EPUB builds from Read the Docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .readthedocs.yml | 1 - 1 file changed, 1 deletion(-) 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 -- cgit v1.2.3