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 /.github | |
| 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
Diffstat (limited to '.github')
0 files changed, 0 insertions, 0 deletions
