feat: simple-mode code-block highlighting, prompt, and copy rules

Add a custom Shiki grammar for the simple-mode command language
(src/grammars/rdbms.mjs), registered with Expressive Code. Two language ids
share it: rdbms (real commands) and rdbms-syntax (abstract templates).
Simple-mode blocks now highlight; advanced examples keep sql.

Separation + copy ergonomics via CSS (global.css): a decorative, copy-safe
"> " prompt on rdbms command lines (not in the copy buffer), and the copy
button hidden on multi-command rdbms blocks and on rdbms-syntax templates
(the app input is single-line, so a multi-command paste is not runnable);
single-command, sql, and sh blocks keep copy.

Content: convert 22 simple-mode fences to rdbms; lead the simplest examples
(first project, Tables reference) with bare "with pk" (the beginner default
that creates a ready-made id key), pointing to the named form. Record the
fence + prompt conventions in STYLE.md.
This commit is contained in:
claude@clouddev1
2026-06-09 22:30:44 +00:00
parent 995c0ba8eb
commit 44390e765d
10 changed files with 169 additions and 35 deletions
@@ -29,7 +29,7 @@ the CSV files. Because it is derived, it never needs to be shared or backed
up separately — and if it is ever missing or stale, the `rebuild` command
regenerates it from the readable files:
```text
```rdbms
rebuild
```
@@ -46,7 +46,7 @@ When you start the playground without naming a project, it creates a
**temporary** project with an automatic name. Temporary projects are perfect
for quick experiments. When you want to keep one, give it a name:
```text
```rdbms
save
```
@@ -63,7 +63,7 @@ keeping a course's projects together, or for testing.
The `export` command packages a project as a zip you can send to anyone:
```text
```rdbms
export
```
@@ -15,41 +15,41 @@ and press <kbd>Enter</kbd> to run them.
## Create a table
A table needs at least a primary key. The `with pk` clause names the
primary-key column and its type:
The quickest way to make a table is `with pk` on its own, which gives you a
ready-made primary key column called `id`:
```text
create table authors with pk author_id(serial)
```rdbms
create table authors with pk
```
`serial` is an auto-incrementing number — you will not have to fill it in
yourself.
You never fill `id` in yourself — the database assigns it as you add rows.
(You can also name and type the key yourself; see the
[Tables reference](/reference/tables/).)
## Add a couple of columns
In simple mode you create a table with its key, then add the other columns
one at a time:
```text
```rdbms
add column to authors: name (text)
add column to authors: birth_year (int)
```
## Add a row
`insert` adds a row. List the columns you are supplying — the `author_id`
fills itself in because it is a `serial`:
`insert` adds a row. List the columns you are supplying — `id` fills itself
in automatically:
```text
```rdbms
insert into authors (name, birth_year) values ('Ada Lovelace', 1815)
```
The playground shows the row it just inserted, including the generated
`author_id`.
The playground shows the row it just inserted, including the generated `id`.
## Look at the data
```text
```rdbms
show data authors
```
@@ -13,7 +13,7 @@ in **simple mode**, and reach for **advanced mode** when you want full SQL.
Simple mode is a friendly, keyword-based command language designed for
learning. Commands read close to English:
```text
```rdbms
create table authors with pk author_id(serial)
show data authors
```
@@ -33,7 +33,7 @@ select title, published from books where published >= 2000 order by published;
Switch modes with the `mode` command:
```text
```rdbms
mode advanced
mode simple
```
@@ -46,7 +46,7 @@ open it, so a project set up for SQL practice reopens in advanced mode.
When you are in simple mode and want to run a single SQL statement without
switching, prefix the line with a colon:
```text
```rdbms
:select count(*) from books
```
@@ -15,9 +15,13 @@ from scratch in simple mode: two tables, a relationship between them, and a
few rows. By the end you will have used the create → add column → relate →
insert → query loop end to end.
We give each table a **named** primary key (like `author_id`) so the
relationship reads clearly — but `with pk` on its own gives you a default
`id` if you prefer, as in [Your first project](/getting-started/first-project/).
## 1. Create the authors table
```text
```rdbms
create table authors with pk author_id(serial)
add column to authors: name (text)
add column to authors: birth_year (int)
@@ -25,7 +29,7 @@ add column to authors: birth_year (int)
## 2. Create the books table
```text
```rdbms
create table books with pk book_id(serial)
add column to books: title (text)
add column to books: author_id (int)
@@ -37,7 +41,7 @@ add column to books: published (int)
An author has many books, so `books.author_id` should point at
`authors.author_id`. Declare that one-to-many relationship:
```text
```rdbms
add 1:n relationship from authors.author_id to books.author_id
```
@@ -48,7 +52,7 @@ the `books` side.
`author_id` and `book_id` are `serial`, so they fill themselves in:
```text
```rdbms
insert into authors (name, birth_year) values ('Ada Lovelace', 1815)
insert into authors (name, birth_year) values ('Alan Turing', 1912)
insert into books (title, author_id, published) values ('Notes on the Analytical Engine', 1, 1843)
@@ -56,7 +60,7 @@ insert into books (title, author_id, published) values ('Notes on the Analytical
## 5. Look at your data
```text
```rdbms
show data authors
show data books
```
+18 -10
View File
@@ -11,16 +11,24 @@ in the Reference.
## Create a table (simple mode)
Every table is created with its primary key. The `with pk` clause lists the
primary-key column(s):
The simplest way to create a table is `with pk` on its own — it gives the
table a ready-made primary-key column named `id` that the database fills in
for you:
```text
```rdbms
create table authors with pk
```
Prefer to name the key, or give it a specific type? Name it in the `with pk`
clause:
```rdbms
create table authors with pk author_id(serial)
```
Other columns are added afterwards with `add column`:
Either way, the rest of the columns are added afterwards with `add column`:
```text
```rdbms
add column to authors: name (text)
add column to authors: birth_year (int)
```
@@ -30,14 +38,14 @@ add column to authors: birth_year (int)
To make the primary key span more than one column, list them, comma
separated:
```text
```rdbms
create table loans with pk book_id(int), member_id(int)
```
**Syntax**
```text
create table <Name> with pk <col>(<type>)[, ...]
```rdbms-syntax
create table <Name> with pk [<col>(<type>)[, ...]]
```
## Create a table (advanced mode)
@@ -58,13 +66,13 @@ keys — see the Constraints and Relationships references.
**Syntax**
```text
```rdbms-syntax
create table [if not exists] <Name> (<col> <type> [constraints], ...)
```
## Drop a table
```text
```rdbms
drop table authors
```
+1 -1
View File
@@ -42,7 +42,7 @@ by hand.
avoiding easily-confused characters). Always kept unique. Useful when you
want an identifier that is compact but not guessable or sequential.
```text
```rdbms
create table members with pk member_id(serial)
add column to members: member_code (shortid)
insert into members (name) values ('Grace Hopper')