You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+26-16Lines changed: 26 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,13 +4,17 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
4
4
5
5
## Project Overview
6
6
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 |
14
18
15
19
## Commands
16
20
@@ -25,15 +29,21 @@ npm run og-image # Generate Open Graph image
25
29
## Project Structure
26
30
27
31
-`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.
36
42
37
43
## Deployment
38
44
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