summaryrefslogtreecommitdiff
path: root/docs/typ/guide.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/guide.typ')
-rw-r--r--docs/typ/guide.typ11
1 files changed, 10 insertions, 1 deletions
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
index e2b9ae77..1505afbc 100644
--- a/docs/typ/guide.typ
+++ b/docs/typ/guide.typ
@@ -1,7 +1,7 @@
// The guide: pardes day to day, the path a newcomer reads once. Edge cases
// live in the reference, the pager and the language servers in setup, the
// keys on the cheatsheet.
-#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, glossary
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, glossary, annotated
pardes reads the text on its screen as things to do, with two builtins.
#word("Look") (right-click) on `src/bar.c:12` opens that line; on a URL,
@@ -11,6 +11,15 @@ screen is columns of panes, each a tag (a line of words) over a file, a
terminal, a PDF or an image. The keys are helix's, and every session is a
virtual filesystem, served over 9P, for scripts.
+#annotated("/docs/site/media/themes/orchard.png", (640, 513),
+ ([the workspace tag: words for the whole session], 330, 11),
+ ([a column's tag], 400, 34),
+ ([a pane's tag: its path, then its words], 560, 58),
+ ([the box: the pane's mode, and the handle to drag it], 8, 58),
+ ([the body: here a file, below it a terminal], 500, 128),
+ ([the scrollbar: how much of the body is in view], 8, 160),
+)
+
#glossary("Words you'll see", <words>,
[tag], [the line of words over a pane, a column or the screen; every word in it can be clicked],
[the pane with the keyboard], [where your keys go; one pane at a time],