feat: Quarto Reveal.js deck with NC State theme + Dockerized preview

Author: alptezbasaran

.dockerignore

@@ -0,0 +1,11 @@
+.git
+.gitignore
+**/.venv
+**/__pycache__
+**/.ipynb_checkpoints
+node_modules
+.DS_Store
+*.log
+*.tmp
+*.local
+**/.quarto/

Dockerfile

@@ -0,0 +1,26 @@
+# Quarto + Python base
+FROM ghcr.io/quarto-dev/quarto:1.5.57
+
+# Add Python (uv) + Jupyter support
+RUN apt-get update -y && apt-get install -y --no-install-recommends \
+    python3 python3-pip python3-venv \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set workdir
+WORKDIR /project
+
+# Preinstall python deps to leverage Docker cache
+COPY requirements.txt requirements.txt
+RUN python3 -m venv .venv \
+    && . .venv/bin/activate \
+    && pip install --upgrade pip \
+    && pip install -r requirements.txt || true
+
+# Copy project last to maximize cache
+COPY . .
+
+# Expose preview port
+EXPOSE 4000
+
+# Default command: run preview for the deck
+CMD ["bash", "-lc", "quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"]

_quarto.yml

@@ -0,0 +1,14 @@
+project:
+  type: default
+
+format:
+  revealjs:
+    theme: [default, slides/theme/ncsu.scss]
+    slide-number: true
+    transition: fade
+    background-transition: fade
+    code-overflow: wrap
+    toc: false
+    footer: "NC State University — Data Science Services"
+
+editor: visual

compose.yaml

@@ -0,0 +1,14 @@
+services:
+  slides:
+    platform: linux/arm64/v8
+    build:
+      context: .
+    image: intro-to-prog-py:quarto
+    container_name: intro-to-prog-py-slides
+    ports:
+      - "4000:4000"
+    volumes:
+      - .:/project
+    command: bash -lc "quarto preview slides/index.qmd --host 0.0.0.0 --port 4000 --no-browser"
+    environment:
+      - QUARTO_LOG_LEVEL=debug

slides/index.qmd

@@ -0,0 +1,51 @@
+---
+title: "Introduction to Programming with Python"
+subtitle: "NC State Data Science Services"
+author: "Alp Tezbasaran"
+date: today
+format:
+  revealjs:
+    incremental: true
+    preview-links: auto
+    chalkboard: true
+    logo: ../assets/libraries-logo.png
+---
+
+## Welcome
+
+- Course overview
+- Tools we'll use
+- Expectations
+
+---
+
+## Agenda
+
+1. Python basics
+2. Control flow
+3. Functions
+4. Practice
+
+---
+
+## Visuals and media
+
+- Drag images into the `assets/` folder and reference like:
+
+![](../assets/libraries-logo.png)
+
+---
+
+## Code example
+
+```python
+print("Hello, NC State!")
+```
+
+---
+
+## Next steps
+
+- Convert each section of your current slides into headings and bullet points
+- Use `---` to separate slides
+- Use `::: columns` for side-by-side text and images when needed

slides/theme/ncsu.scss

@@ -0,0 +1,64 @@
+/*-- scss:defaults --*/
+// NC State brand palette
+$ncsu-red: #CC0000; // Brick
+$ncsu-dk-gray: #3D3D3D;
+$ncsu-md-gray: #6D6E71;
+$ncsu-lt-gray: #E6E6E6;
+$ncsu-white: #FFFFFF;
+
+// Reveal theme variables
+$body-bg: $ncsu-white;
+$text: $ncsu-dk-gray;
+$link-color: $ncsu-red;
+$link-color-hover: darken($ncsu-red, 10%);
+$heading-color: $ncsu-dk-gray;
+$heading-text-transform: none;
+$heading-font-weight: 800;
+$selection-bg: $ncsu-red;
+$selection-color: $ncsu-white;
+$code-block-bg: $ncsu-lt-gray;
+$code-block-border-color: $ncsu-md-gray;
+$blockquote-border-color: $ncsu-red;
+
+/*-- scss:rules --*/
+.reveal {
+  h1, h2, h3, h4 {
+    letter-spacing: 0.2px;
+    border-bottom: 6px solid $ncsu-red;
+  }
+
+  .slides section {
+    padding-top: 18px;
+  }
+
+  .slide-number {
+    color: $ncsu-md-gray;
+  }
+
+  a {
+    text-decoration: underline;
+  }
+
+  blockquote {
+    border-left: 6px solid $blockquote-border-color;
+    padding-left: 14px;
+    color: $ncsu-md-gray;
+  }
+
+  pre code {
+    background: $code-block-bg;
+    border: 1px solid $code-block-border-color;
+    border-radius: 8px;
+    padding: 12px 14px;
+  }
+
+  .title-slide {
+    background: $ncsu-white;
+    .title {
+      color: $ncsu-red;
+    }
+    .subtitle {
+      color: $ncsu-dk-gray;
+    }
+  }
+}