From 2142ff0fe405e3f12a19a8ab822cf4fc2ccd6c84 Mon Sep 17 00:00:00 2001 From: Tiara Rodney Date: Sat, 28 Jun 2025 00:42:29 +0200 Subject: [PATCH 1/3] todo(2): open --- TODO | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/TODO b/TODO index a9f3f82..ad8f3e7 100644 --- a/TODO +++ b/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. + +--- From 92a3bd19c5ee4b61027fcf26e9d2a95d76e3a3d3 Mon Sep 17 00:00:00 2001 From: Tiara Rodney Date: Sat, 28 Jun 2025 00:42:55 +0200 Subject: [PATCH 2/3] todo(2): in-progress --- TODO | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TODO b/TODO index ad8f3e7..006eb92 100644 --- a/TODO +++ b/TODO @@ -60,7 +60,7 @@ 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 +Status: in-progress Priority: high Created: 2025-06-27 Description: Implement a Sphinx extension allowing reStructuredText documents to From c184b8bfd110461be49a69e90fb84f184fd7d1f2 Mon Sep 17 00:00:00 2001 From: Tiara Rodney Date: Sat, 28 Jun 2025 00:43:18 +0200 Subject: [PATCH 3/3] feat(reslide): init --- src/byteb4rb1e/sphinxcontrib/ext/reslide/__init__.py | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 src/byteb4rb1e/sphinxcontrib/ext/reslide/__init__.py diff --git a/src/byteb4rb1e/sphinxcontrib/ext/reslide/__init__.py b/src/byteb4rb1e/sphinxcontrib/ext/reslide/__init__.py new file mode 100644 index 0000000..e69de29