todo(2): open
This commit is contained in:
parent
b594ab5b2a
commit
2142ff0fe4
1 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
|
||||
|
||||
---
|
||||
|
||||
ID: 2
|
||||
Type: feature
|
||||
Title: Prototype dynamic slide-view directives ("reslide")
|
||||
Status: open
|
||||
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.
|
||||
|
||||
---
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue