Compare commits
3 commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c184b8bfd1 | ||
|
|
92a3bd19c5 | ||
|
|
2142ff0fe4 |
2 changed files with 40 additions and 0 deletions
40
TODO
40
TODO
|
|
@ -56,3 +56,43 @@ Created: 2025-06-06
|
||||||
Description: Find the best repository layout and build environment for my case
|
Description: Find the best repository layout and build environment for my case
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
ID: 2
|
||||||
|
Type: feature
|
||||||
|
Title: Prototype dynamic slide-view directives ("reslide")
|
||||||
|
Status: in-progress
|
||||||
|
Priority: high
|
||||||
|
Created: 2025-06-27
|
||||||
|
Description: Implement a Sphinx extension allowing reStructuredText documents to
|
||||||
|
be rendered as both linear HTML pages and presentation-style
|
||||||
|
slides.
|
||||||
|
|
||||||
|
The system introduces a non-intrusive layer over standard reST
|
||||||
|
content via three main directives:
|
||||||
|
|
||||||
|
- `.. slide-master::` declares a reusable grid-based layout with
|
||||||
|
named areas.
|
||||||
|
- `.. slide::` marks a logical section as a slide and references a
|
||||||
|
master layout.
|
||||||
|
- `.. slide-slot::` maps specific content blocks into areas defined
|
||||||
|
by the referenced slide master.
|
||||||
|
|
||||||
|
Slides are composed in a single reST file without disrupting HTML
|
||||||
|
output. During HTML build, a toggle button is injected allowing
|
||||||
|
users to switch between document view and presentation view using
|
||||||
|
JavaScript and CSS.
|
||||||
|
|
||||||
|
Additional features include:
|
||||||
|
- Fallback or fluid "resize to fit" mode for content overflow
|
||||||
|
- Optional pre-build warning system for oversized content
|
||||||
|
- Placeholder wireframes for visualizing grid slots (dev mode)
|
||||||
|
- Semantic rendering to preserve readability in both views
|
||||||
|
|
||||||
|
Parsing relies on the sequential nature of reST processing to
|
||||||
|
segment slide contents without modifying global tree behavior.
|
||||||
|
|
||||||
|
This prototype sets up the basic parsing, node registration, and
|
||||||
|
HTML translator customization. Styling and JavaScript interactivity
|
||||||
|
will be minimal but functional.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
|
||||||
0
src/byteb4rb1e/sphinxcontrib/ext/reslide/__init__.py
Normal file
0
src/byteb4rb1e/sphinxcontrib/ext/reslide/__init__.py
Normal file
Loading…
Add table
Add a link
Reference in a new issue