Skip to content

Commit aea4bce

Browse files
mafulafunkclaude
andcommitted
Update CLAUDE.md with new project structure
- Add SQL-to-Shell mapping table - Document terminal theme and demo materials - Add LaTeX/MathJax umlaut workaround - Include live presentation workflow Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 8cb1944 commit aea4bce

File tree

1 file changed

+26
-16
lines changed

1 file changed

+26
-16
lines changed

CLAUDE.md

Lines changed: 26 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,17 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
SQL in the Shell is a Marp-based presentation demonstrating how relational algebra operations can be implemented using Unix/Linux command-line tools. It maps SQL operations to their shell equivalents:
8-
9-
- SELECT → cat/awk
10-
- WHERE → grep/awk
11-
- UNION → cat
12-
- EXCEPT → comm
13-
- Cartesian Product → custom shell scripts
7+
SQL in the Shell is a Marp-based presentation demonstrating how relational algebra operations can be implemented using Unix/Linux command-line tools. The presentation is designed to be shown alongside live terminal demos.
8+
9+
| SQL | Shell |
10+
|-----|-------|
11+
| SELECT * | cat |
12+
| SELECT a,b | cut / awk |
13+
| WHERE | grep / awk |
14+
| UNION | cat a b \| sort -u |
15+
| EXCEPT | comm -23 |
16+
| JOIN | join |
17+
| CROSS JOIN | cartesian.sh |
1418

1519
## Commands
1620

@@ -25,15 +29,21 @@ npm run og-image # Generate Open Graph image
2529
## Project Structure
2630

2731
- `PITCHME.md` - Main presentation (Marp Markdown)
28-
- `CheatSheet.md` - SQL-to-shell command reference
29-
- `work/` - Practical examples
30-
- `*.csv` - Sample data files (Customer_A, Customer_B, Shipping)
31-
- `bin/cartesian.sh` - Cartesian product with CLI options (-d delimiter, -t for tabs)
32-
- `bin/crt.sh` - Simplified cartesian product
33-
- `themes/` - Custom Marp CSS themes
34-
- `assets/` - Images used in slides
35-
- `marp.config.js` - Marp configuration (themes, URL, OG image)
32+
- `themes/terminal.css` - Custom dark terminal theme
33+
- `work/` - Demo materials for live presentation
34+
- `DEMO.md` - Step-by-step terminal commands aligned with slides
35+
- `demo/` - Small example datasets (5 rows each) for live demos
36+
- `Customer_*.csv`, `Shipping.csv` - Full sample datasets
37+
- `bin/cartesian.sh` - Cartesian product script (-d delimiter, -t for tabs)
38+
39+
## Live Presentation
40+
41+
The slides are meant to accompany live terminal demos. Use `work/DEMO.md` as a script - it contains all commands to run for each slide.
3642

3743
## Deployment
3844

39-
GitHub Actions deploys to GitHub Pages on push to master. The workflow builds slides and deploys to `gh-pages` branch.
45+
GitHub Actions deploys to GitHub Pages on push to master. Live at: https://eigenfunk.github.io/sql-in-the-shell/
46+
47+
## LaTeX in Marp
48+
49+
Use `\"u` instead of UTF-8 `ü` in `\text{}` blocks to avoid MathJax rendering issues.

0 commit comments

Comments
 (0)