diff options
Diffstat (limited to 'src/tutor.txt')
| -rw-r--r-- | src/tutor.txt | 69 |
1 files changed, 35 insertions, 34 deletions
diff --git a/src/tutor.txt b/src/tutor.txt index dc9ceb87..0f3e3359 100644 --- a/src/tutor.txt +++ b/src/tutor.txt @@ -1,6 +1,5 @@ PARDES TUTOR - tmux + vi + acme, by doing. This pane is +Tutor, a copy: edit it freely; there is no need to Save it (a bare Save asks for a path to write a copy to). @@ -10,11 +9,11 @@ The guide (docs/typ/guide.typ) explains; this is the hands-on part. Each lesson is a few things to do, then names its guide section. - Words in backticks, like `Save`, are builtins. Two carry the rest: - `Exec` (middle-click, B2) runs the builtin a word names, or else - runs it as a shell line; `Look` (right-click, B3) opens what the - text names, or else finds it. Type a builtin in any tag and `Exec` - it. Lines starting with "| " are tags. + Words in backticks, like `Save`, are builtins. + `Exec` (B2) runs the builtin a word names, or else runs it as a + shell line; `Look` (B3) opens what the text names, or else finds + it. Type a builtin in any tag and `Exec` it. Lines starting with + "| " are tags. Press j until you reach part 1. @@ -29,9 +28,10 @@ 2. Press Esc once more, in NORMAL: the keyboard goes back to the pane you were in before (not what helix does). Come back with Esc again. - 3. Press Alt-n: a terminal opens, in NORMAL mode. Press Ctrl-b: its - box shows $ (RAW), and keys go to the shell. At its empty prompt, - Esc brings you back here; the terminal stays $. + 3. Press Alt-n: a terminal opens, in NORMAL mode, and pardes types + ls at its first prompt. Press Ctrl-b: its box shows $ (RAW), and + keys go to the shell. At its empty prompt, Esc brings you back + here; the terminal stays $. -> Guide: Modes @@ -67,8 +67,8 @@ | Tty Collapse Del 1. Press : here: the keyboard goes to this pane's tag, on `Save`. - Press A, type a space and Help, press Esc, then `Exec` - `Help` there. Press : again to come back. + Press A, type a space and Help, press Esc, then Tab: `Help` + runs and its list takes the keyboard. Esc brings you back. 2. Click `Collapse` in this tag: the pane folds to its tag. Click it again. 3. Drag the box left of the tag down a few rows, then back. @@ -86,6 +86,8 @@ takes the keyboard. 3. Ctrl-w h, j, k, l move the keyboard between panes; Ctrl-o and Ctrl-i walk back and forward through where you have been. + Ctrl-i needs the kitty keyboard protocol or the GUI; elsewhere it + is Tab, so use SPC j i (and SPC j o), or the mouse's side buttons. 4. `Del` the scratch and the command pane, each in its own tag. -> Guide: Where commands run and panes go @@ -96,9 +98,11 @@ ================================================================= 1. `Look` :20 here: the cursor goes to line 20 of this pane. - 2. `Look` :/UNSAVED/ to go to the next match of UNSAVED. + 2. Drag across :/^=.*UNSAVED/ with B3 held: `Look` takes exactly + what you swept, a regex here, and goes to Part 7's heading. 3. Press /, type keys, press Enter: a +Search lists the lines with - keys and the cursor goes to the first. n and N step through. + keys. n moves into it and walks its rows; Enter on a row goes + to that line here. -> Guide: Look @@ -107,9 +111,9 @@ = PART 6 — TERMINALS = ================================================================= - 1. In the terminal from part 1 (or Alt-n again), type ls and press - Enter in RAW mode. Then Ctrl-b to NORMAL: move over its output - with j and k, select a name with x, yank it with y. + 1. In the terminal from part 1 (or Alt-n again), its ls has listed + the directory. Press Ctrl-b to NORMAL, put the cursor on a name + with j, k and w, select it with m i W, and yank it with y. 2. Come back here (Ctrl-w, or click) and press p: the name is pasted; yank and paste are shared by every pane. 3. `Del` the terminal: it closes with its shell. @@ -175,12 +179,11 @@ abcdef # after abcdef - A number typed FIRST is a count, and only some keys take one, - among them the motions, f/F/t/T and the Alt-. that repeats them, - gg/gj/gk, x, o/O, > and <, p/P, R, Ctrl-a/Ctrl-x, the cursor-list - keys C and ( ), q and the . repeat. Elsewhere it is swallowed: 3d - deletes once, 3i types once. 0 is always line start and never starts a - count. Ctrl-d/u/f ignore counts: a page is a page. + 3l moves three: a number typed FIRST is a count. The motions, + f/F/t/T and Alt-., gg/gj/gk, x, o/O, > <, p/P, R, Ctrl-a/Ctrl-x, + C ( ), q and . take one; any other key swallows it (3d deletes + once, 3i types once). 0 is always line start; Ctrl-d/u/f ignore + counts. # keys: 3 l i Z esc # before @@ -276,12 +279,11 @@ typed = 9.6 SPC — THE LEADER = ----------------------------------------------------------------- - Nearly every builtin has a NAME you can `Exec` wherever text lives - and a KEY PATH you can press. SPC in NORMAL mode starts the path; - what you have typed shows on the message row until it fires. Esc - abandons it, and so does any key that leads nowhere. + SPC f s is `Save`: nearly every builtin has a key path as well as + a name. What you have typed shows on the message row; Esc, or a key + that leads nowhere, abandons it. - SPC ? list every path + SPC ? `Help`: every builtin and its keys SPC d `Del` SPC q `Exit` SPC f s `Save` SPC f f `Find` SPC f n `New` SPC y yank to the clipboard SPC p paste from it @@ -292,6 +294,7 @@ typed SPC h t this tutor -> Guide: Keys + -> Every helix key: https://docs.helix-editor.com/keymap.html ================================================================= @@ -299,8 +302,7 @@ typed ================================================================= Every session is a virtual filesystem, served over 9P: a program that - opens files IS an extension, with no plugin API. Pane shells get - $PARDES_9P (the socket) and $PARDES_PANE (their pane's serial). + opens files IS an extension. 9ns --mntgen mount every session (9ns is cloud9's) m=$PARDES_MOUNT the session, under 9ns @@ -322,18 +324,17 @@ typed ================================================================= MODES blank NORMAL, ^ INSERT, $ RAW; each pane keeps its own - Esc and Shift-Esc: see the guide's Modes table - (Shift-Esc needs the kitty keyboard protocol or the - GUI; elsewhere it is a plain Esc) + Esc in NORMAL goes back a pane (the guide's Modes table) Ctrl-b toggles RAW and NORMAL MOUSE L select/focus M `Exec` R `Look` - 1-2 cut 1-3 paste 1-2 then 1-3 copy + 1-2 cut 1-3 paste both in turn: copy 2-1 `Exec` the middle word with the left selection keyboard: Enter = `Look`, Tab = `Exec` PANES Ctrl-w h/j/k/l focus a neighbour (NORMAL mode) Ctrl-o / Ctrl-i jump history back / forward + (SPC j o / SPC j i where Ctrl-i is Tab) Alt-n new terminal Alt-c pane into a new column KEYS h j k l w b e 0 gl ^ gg ge f F t T v x d c y p @@ -343,7 +344,7 @@ typed bare G does nothing; ge is the START of the last line s / S regex cursors; m i/a textobjects; m s/r/d surround / is a case-insensitive SUBSTRING search, not a regex - SPC is the leader (SPC ? lists every path) + SPC is the leader (SPC ? is `Help`) vs HELIX selection is LINE-first (x), v for characters; / is a substring search; n/N walk what `Look` would open. |