Compare commits

...
Sign in to create a new pull request.

3 commits

Author SHA1 Message Date
Tiara Rodney
c184b8bfd1
feat(reslide): init 2025-06-28 00:43:18 +02:00
Tiara Rodney
92a3bd19c5
todo(2): in-progress 2025-06-28 00:42:55 +02:00
Tiara Rodney
2142ff0fe4
todo(2): open 2025-06-28 00:42:29 +02:00
2 changed files with 40 additions and 0 deletions

40
TODO
View file

@ -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.
---