canonical / canonical/sphinx-structured-toc
Add PDF output support
- Dominant language
- Python
- Stars
- 2
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
Seems to be HTML-only.
When I tried generating PDF in Ulwazi compatibility tests I've got the following errors:
```
rst-cheat-sheet.rst:568: WARNING: unknown node type: >
NotImplementedError: LaTeXTranslator departing unknown node type: SliceItem
```
`sphinx_structured_toc` registers visitors for HTML only, so any builder other than HTML aborts with `NotImplementedError` when a page contains a domain directive. Because Sphinx traverses every toctree-reachable document, a single domain anywhere in a project breaks `make latexpdf` for the whole project.
Contributor guide
No contributing guide indexed for this repository
Research direction
Start by tracing sphinx_structured_toc's HTML-only visitor registration and the SliceItem path reported by the LaTeXTranslator. Run the Ulwazi compatibility build or make latexpdf to reproduce the failure, then verify that a project containing a domain directive builds PDF output without NotImplementedError.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- latex, python
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100