rshow 0.0.0-stage → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +50 -2
- package/dist/main.js +8500 -0
- package/package.json +48 -4
- package/skills/rshow/SKILL.md +144 -0
- package/skills/rshow/reference/cli.md +263 -0
- package/skills/rshow/reference/dashboard.md +122 -0
- package/skills/rshow/reference/mockups.md +113 -0
- package/skills/rshow/reference/page-contract.md +83 -0
- package/skills/rshow/reference/pages.md +174 -0
- package/skills/rshow/reference/poster.md +137 -0
- package/skills/rshow/reference/project-page.md +132 -0
- package/skills/rshow/reference/reports.md +158 -0
- package/skills/rshow/reference/sketch.md +78 -0
- package/skills/rshow/reference/terminal.md +148 -0
- package/skills/rshow/reference/themes.md +139 -0
- package/skills/rshow-implement/SKILL.md +112 -0
- package/skills/rshow-implement/reference/compare.md +156 -0
- package/skills/rshow-implement/reference/handoff.md +125 -0
- package/skills/rshow-implement/reference/map.md +151 -0
- package/skills/rshow-slides/SKILL.md +136 -0
- package/skills/rshow-slides/reference/layouts.md +251 -0
- package/themes/default/dashboard.css +521 -0
- package/themes/default/dashboard.js +1390 -0
- package/themes/default/deck.css +586 -0
- package/themes/default/deck.js +741 -0
- package/themes/default/example/capture.ans +1 -0
- package/themes/default/example/dashboard.html +106 -0
- package/themes/default/example/demo.cast +14 -0
- package/themes/default/example/drawing.excalidraw +377 -0
- package/themes/default/example/index.html +311 -0
- package/themes/default/example/mockup-desktop.html +331 -0
- package/themes/default/example/mockup-platforms.html +742 -0
- package/themes/default/example/mockup.html +416 -0
- package/themes/default/example/page.html +153 -0
- package/themes/default/example/poster-figure.svg +58 -0
- package/themes/default/example/poster.html +181 -0
- package/themes/default/example/project.html +229 -0
- package/themes/default/example/report.html +404 -0
- package/themes/default/example/results.csv +61 -0
- package/themes/default/example/sketch.html +178 -0
- package/themes/default/example/teaser.svg +66 -0
- package/themes/default/example/terminal.html +231 -0
- package/themes/default/example/tui.html +223 -0
- package/themes/default/fonts/IBMPlexMono-Regular-Latin1.woff2 +0 -0
- package/themes/default/fonts/IBMPlexSans-Light-Latin1.woff2 +0 -0
- package/themes/default/fonts/IBMPlexSans-Regular-Latin1.woff2 +0 -0
- package/themes/default/fonts/IBMPlexSans-SemiBold-Latin1.woff2 +0 -0
- package/themes/default/fonts/OFL.txt +93 -0
- package/themes/default/fonts.css +63 -0
- package/themes/default/index.html +573 -0
- package/themes/default/mockup.css +1078 -0
- package/themes/default/mockup.js +1433 -0
- package/themes/default/mode.js +242 -0
- package/themes/default/page.css +320 -0
- package/themes/default/poster.css +480 -0
- package/themes/default/poster.js +223 -0
- package/themes/default/project.css +482 -0
- package/themes/default/project.js +116 -0
- package/themes/default/report.css +776 -0
- package/themes/default/report.js +427 -0
- package/themes/default/sketch.css +166 -0
- package/themes/default/sketch.js +681 -0
- package/themes/default/skins/adwaita.css +669 -0
- package/themes/default/skins/custom.css +596 -0
- package/themes/default/skins/egui.css +639 -0
- package/themes/default/skins/fluent.css +1093 -0
- package/themes/default/skins/fluent.js +458 -0
- package/themes/default/skins/mac.css +647 -0
- package/themes/default/skins/material.css +692 -0
- package/themes/default/skins/sketch.css +436 -0
- package/themes/default/skins/sketch.js +494 -0
- package/themes/default/skins/wire.css +561 -0
- package/themes/default/terminal.css +292 -0
- package/themes/default/terminal.js +433 -0
- package/themes/default/theme.json +149 -0
- package/themes/default/tokens.css +255 -0
- package/themes/default/tui.css +703 -0
- package/themes/default/tui.js +472 -0
- package/worker/index.js +6918 -0
- package/worker/migrations/0001_init.sql +52 -0
- package/worker/migrations/0002_blobs.sql +5 -0
- package/worker/migrations/0003_projects.sql +31 -0
- package/worker/migrations/0004_page_data_blob.sql +19 -0
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
6
|
+
<title>rshow: a link that keeps working</title>
|
|
7
|
+
<!--
|
|
8
|
+
Theme links. A published deck points at the theme artifact with root-relative
|
|
9
|
+
URLs, one per file, all at the same pinned version:
|
|
10
|
+
|
|
11
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/fonts.css">
|
|
12
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/tokens.css">
|
|
13
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/deck.css">
|
|
14
|
+
<script src="/_themes/<name>@<n>/deck.js"></script>
|
|
15
|
+
|
|
16
|
+
This copy links the theme folder itself, so it previews from a local checkout
|
|
17
|
+
with `rshow preview .` from this folder, and no network.
|
|
18
|
+
|
|
19
|
+
Twelve slides, one per layout in deck.css, so every class the theme ships is
|
|
20
|
+
shown here: title, statement, bullets, section, figure, chart, table,
|
|
21
|
+
two-col, code, figure-two, quote, big-number.
|
|
22
|
+
|
|
23
|
+
The numbers on the chart and the table are example data. They are round on
|
|
24
|
+
purpose and the caption says so, because an example must never read as a
|
|
25
|
+
measured result.
|
|
26
|
+
|
|
27
|
+
Colour of a chart: one series is drawn in --accent, the same blue as a link,
|
|
28
|
+
because one series is not a category. Two or more series take --chart-1,
|
|
29
|
+
--chart-2 and so on, in order. Press t in the deck to cycle the mode.
|
|
30
|
+
-->
|
|
31
|
+
<link rel="stylesheet" href="../fonts.css">
|
|
32
|
+
<link rel="stylesheet" href="../tokens.css">
|
|
33
|
+
<link rel="stylesheet" href="../deck.css">
|
|
34
|
+
</head>
|
|
35
|
+
<body>
|
|
36
|
+
|
|
37
|
+
<main class="deck">
|
|
38
|
+
|
|
39
|
+
<section class="slide title">
|
|
40
|
+
<h1>rshow: a link that keeps working</h1>
|
|
41
|
+
<p class="subtitle">Publishing, versions, sharing and caching.</p>
|
|
42
|
+
<p class="byline">Dana Ruiz, rshow project, weekly research meeting, 14 March</p>
|
|
43
|
+
<aside class="notes">
|
|
44
|
+
<p>Say who you are and what the room gets out of this: one command, one
|
|
45
|
+
link that stays put, no build step to babysit.</p>
|
|
46
|
+
<p>Promise: by the end they can publish a deck, a report or a demo from a
|
|
47
|
+
folder on their laptop.</p>
|
|
48
|
+
</aside>
|
|
49
|
+
</section>
|
|
50
|
+
|
|
51
|
+
<section class="slide statement">
|
|
52
|
+
<p>Every publish is a version, and a version never changes.</p>
|
|
53
|
+
<aside class="notes">
|
|
54
|
+
<p>The whole talk sits in that sentence. Everything after it is a
|
|
55
|
+
consequence, so give it a moment before moving on.</p>
|
|
56
|
+
</aside>
|
|
57
|
+
</section>
|
|
58
|
+
|
|
59
|
+
<section class="slide bullets">
|
|
60
|
+
<h2>Four parts make a link survive an edit</h2>
|
|
61
|
+
<ul>
|
|
62
|
+
<li class="step">A publish writes a numbered version and leaves the old ones alone.</li>
|
|
63
|
+
<li class="step">A pin holds one version in place while the next one is half written.</li>
|
|
64
|
+
<li class="step">A share decides who may read the link: private, people or public.</li>
|
|
65
|
+
<li class="step">A content hash means a republish uploads only what changed.</li>
|
|
66
|
+
<li class="step">The slug stays the same, so the link in the calendar invite still works.</li>
|
|
67
|
+
</ul>
|
|
68
|
+
<aside class="notes">
|
|
69
|
+
<p>Advance one line at a time. Pause after the first: immutability is the
|
|
70
|
+
part people do not expect.</p>
|
|
71
|
+
</aside>
|
|
72
|
+
</section>
|
|
73
|
+
|
|
74
|
+
<section class="slide section">
|
|
75
|
+
<h2>Publishing</h2>
|
|
76
|
+
<p>From a folder to a live page, in one command.</p>
|
|
77
|
+
<aside class="notes">
|
|
78
|
+
<p>Transition. Keep it up for a few seconds and do not read the heading
|
|
79
|
+
out.</p>
|
|
80
|
+
</aside>
|
|
81
|
+
</section>
|
|
82
|
+
|
|
83
|
+
<section class="slide figure">
|
|
84
|
+
<h2>A publish sends only the files the host does not have yet</h2>
|
|
85
|
+
<figure>
|
|
86
|
+
<svg viewBox="0 0 1088 390" role="img" aria-label="Publish hashes every file in the folder, compares the hashes with the ones the host already holds, uploads only the missing files and records a numbered version.">
|
|
87
|
+
<g style="font-family: var(--font-sans); fill: var(--fg)">
|
|
88
|
+
<g style="fill: var(--layer-01)">
|
|
89
|
+
<rect x="0" y="70" width="230" height="250"></rect>
|
|
90
|
+
<rect x="286" y="70" width="230" height="250"></rect>
|
|
91
|
+
<rect x="572" y="70" width="230" height="250"></rect>
|
|
92
|
+
<rect x="858" y="70" width="230" height="250"></rect>
|
|
93
|
+
</g>
|
|
94
|
+
<g style="font-size: 24px; font-weight: 600">
|
|
95
|
+
<text x="24" y="186">Publish</text>
|
|
96
|
+
<text x="310" y="186">Compare</text>
|
|
97
|
+
<text x="596" y="186">Upload</text>
|
|
98
|
+
<text x="882" y="186">Record</text>
|
|
99
|
+
</g>
|
|
100
|
+
<g style="font-size: 20px; fill: var(--muted)">
|
|
101
|
+
<text x="24" y="222">every file, hashed</text>
|
|
102
|
+
<text x="310" y="222">which hashes exist</text>
|
|
103
|
+
<text x="596" y="222">only what is new</text>
|
|
104
|
+
<text x="882" y="222">a numbered version</text>
|
|
105
|
+
</g>
|
|
106
|
+
<g style="stroke: var(--accent); stroke-width: 2">
|
|
107
|
+
<line x1="230" y1="195" x2="278" y2="195" marker-end="url(#tip)"></line>
|
|
108
|
+
<line x1="516" y1="195" x2="564" y2="195" marker-end="url(#tip)"></line>
|
|
109
|
+
<line x1="802" y1="195" x2="850" y2="195" marker-end="url(#tip)"></line>
|
|
110
|
+
</g>
|
|
111
|
+
<defs>
|
|
112
|
+
<marker id="tip" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto">
|
|
113
|
+
<path d="M0 0 L10 5 L0 10 z" style="fill: var(--accent)"></path>
|
|
114
|
+
</marker>
|
|
115
|
+
</defs>
|
|
116
|
+
</g>
|
|
117
|
+
</svg>
|
|
118
|
+
<figcaption>Each publish hashes the folder, asks the host what it already holds and sends the difference. The version is recorded with the manifest it was built from.</figcaption>
|
|
119
|
+
</figure>
|
|
120
|
+
<aside class="notes">
|
|
121
|
+
<p>Trace the arrows left to right with a pointer. The compare step is why
|
|
122
|
+
a republish of a mostly unchanged deck costs almost nothing.</p>
|
|
123
|
+
</aside>
|
|
124
|
+
</section>
|
|
125
|
+
|
|
126
|
+
<section class="slide chart">
|
|
127
|
+
<h2>A republish uploads a fraction of the first one</h2>
|
|
128
|
+
<figure>
|
|
129
|
+
<svg viewBox="0 0 1088 430" role="img" aria-label="Bar chart of megabytes uploaded per publish over six publishes: 120, 40, 18, 9, 6 and 6 megabytes.">
|
|
130
|
+
<g style="font-family: var(--font-sans)">
|
|
131
|
+
<text x="40" y="30" style="font-size: 20px; fill: var(--muted)">Megabytes uploaded per publish</text>
|
|
132
|
+
<!-- One series, so it takes the interactive blue and not --chart-1. -->
|
|
133
|
+
<g style="fill: var(--accent)">
|
|
134
|
+
<rect x="40" y="80" width="88" height="300"></rect>
|
|
135
|
+
<rect x="216" y="280" width="88" height="100"></rect>
|
|
136
|
+
<rect x="392" y="335" width="88" height="45"></rect>
|
|
137
|
+
<rect x="568" y="357" width="88" height="23"></rect>
|
|
138
|
+
<rect x="744" y="365" width="88" height="15"></rect>
|
|
139
|
+
<rect x="920" y="365" width="88" height="15"></rect>
|
|
140
|
+
</g>
|
|
141
|
+
<g style="font-size: 22px; fill: var(--fg); font-variant-numeric: tabular-nums; text-anchor: middle">
|
|
142
|
+
<text x="84" y="62">120</text>
|
|
143
|
+
<text x="260" y="262">40</text>
|
|
144
|
+
<text x="436" y="317">18</text>
|
|
145
|
+
<text x="612" y="339">9</text>
|
|
146
|
+
<text x="788" y="347">6</text>
|
|
147
|
+
<text x="964" y="347">6</text>
|
|
148
|
+
</g>
|
|
149
|
+
<line x1="40" y1="380" x2="1048" y2="380" style="stroke: var(--border-strong); stroke-width: 1"></line>
|
|
150
|
+
<g style="font-size: 18px; fill: var(--muted); text-anchor: middle">
|
|
151
|
+
<text x="84" y="412">publish 1</text>
|
|
152
|
+
<text x="260" y="412">publish 2</text>
|
|
153
|
+
<text x="436" y="412">publish 3</text>
|
|
154
|
+
<text x="612" y="412">publish 4</text>
|
|
155
|
+
<text x="788" y="412">publish 5</text>
|
|
156
|
+
<text x="964" y="412">publish 6</text>
|
|
157
|
+
</g>
|
|
158
|
+
</g>
|
|
159
|
+
</svg>
|
|
160
|
+
<figcaption>Example data, not a measurement. The first publish sends the whole folder; every later one sends only the files that changed.</figcaption>
|
|
161
|
+
</figure>
|
|
162
|
+
<aside class="notes">
|
|
163
|
+
<p>Read the labels, not the axis: the bars are labelled at the top so
|
|
164
|
+
nobody has to trace across to a gridline. The shape is the point, the
|
|
165
|
+
exact numbers are illustrative.</p>
|
|
166
|
+
</aside>
|
|
167
|
+
</section>
|
|
168
|
+
|
|
169
|
+
<section class="slide table">
|
|
170
|
+
<h2>Every version stays reachable at its own path</h2>
|
|
171
|
+
<div class="table">
|
|
172
|
+
<table>
|
|
173
|
+
<caption>Example data: five publishes of one talk folder.</caption>
|
|
174
|
+
<thead>
|
|
175
|
+
<tr>
|
|
176
|
+
<th scope="col">Version</th>
|
|
177
|
+
<th scope="col">Label</th>
|
|
178
|
+
<th scope="col" class="num-cell">Files changed</th>
|
|
179
|
+
<th scope="col" class="num-cell">Uploaded</th>
|
|
180
|
+
</tr>
|
|
181
|
+
</thead>
|
|
182
|
+
<tbody>
|
|
183
|
+
<tr><td>v1</td><td>first draft</td><td class="num-cell">7</td><td class="num-cell">240 KB</td></tr>
|
|
184
|
+
<tr><td>v2</td><td>fix the chart</td><td class="num-cell">1</td><td class="num-cell">18 KB</td></tr>
|
|
185
|
+
<tr><td>v3</td><td>add the appendix</td><td class="num-cell">3</td><td class="num-cell">96 KB</td></tr>
|
|
186
|
+
<tr><td>v4</td><td>tidy the notes</td><td class="num-cell">1</td><td class="num-cell">12 KB</td></tr>
|
|
187
|
+
<tr><td>v5</td><td>after the dry run</td><td class="num-cell">2</td><td class="num-cell">31 KB</td></tr>
|
|
188
|
+
</tbody>
|
|
189
|
+
</table>
|
|
190
|
+
</div>
|
|
191
|
+
<aside class="notes">
|
|
192
|
+
<p>Point at the label column: the label is the only thing a reader needs
|
|
193
|
+
to pick a version. The old paths keep working while this list grows.</p>
|
|
194
|
+
</aside>
|
|
195
|
+
</section>
|
|
196
|
+
|
|
197
|
+
<section class="slide two-col">
|
|
198
|
+
<h2>A pin freezes one version, the newest link keeps moving</h2>
|
|
199
|
+
<div class="col">
|
|
200
|
+
<h3>Pinned</h3>
|
|
201
|
+
<ul>
|
|
202
|
+
<li>One version, chosen by you.</li>
|
|
203
|
+
<li>The link in the invite keeps showing it.</li>
|
|
204
|
+
<li>You publish behind it until the talk is ready.</li>
|
|
205
|
+
</ul>
|
|
206
|
+
</div>
|
|
207
|
+
<div class="col">
|
|
208
|
+
<h3>Newest</h3>
|
|
209
|
+
<ul>
|
|
210
|
+
<li>Whatever was published last.</li>
|
|
211
|
+
<li>Good for a page you keep editing.</li>
|
|
212
|
+
<li>Every publish moves it, with no warning.</li>
|
|
213
|
+
</ul>
|
|
214
|
+
</div>
|
|
215
|
+
<aside class="notes">
|
|
216
|
+
<p>Ask the room which one they would send to a reviewer. Most people want
|
|
217
|
+
the pin, and then admit they never set one.</p>
|
|
218
|
+
</aside>
|
|
219
|
+
</section>
|
|
220
|
+
|
|
221
|
+
<section class="slide code">
|
|
222
|
+
<h2>Publish the folder, then keep the link</h2>
|
|
223
|
+
<pre><code>rshow publish ./my-talk \
|
|
224
|
+
--slug my-talk \
|
|
225
|
+
--label "first draft"</code></pre>
|
|
226
|
+
<p class="source">The label is what changed. It is the one line a reader uses to pick a version.</p>
|
|
227
|
+
<aside class="notes">
|
|
228
|
+
<p>Run the command live if the network allows it, then open the printed
|
|
229
|
+
link. The token comes from the environment, never from this line.</p>
|
|
230
|
+
</aside>
|
|
231
|
+
</section>
|
|
232
|
+
|
|
233
|
+
<section class="slide figure-two">
|
|
234
|
+
<h2>Two links, one folder, different promises</h2>
|
|
235
|
+
<div class="pair">
|
|
236
|
+
<figure>
|
|
237
|
+
<svg viewBox="0 0 460 270" role="img" aria-label="The newest link points at the top version of a stack of three, version 5.">
|
|
238
|
+
<g style="font-family: var(--font-sans); font-size: 20px; fill: var(--fg)">
|
|
239
|
+
<g style="fill: var(--layer-01)">
|
|
240
|
+
<rect x="20" y="0" width="170" height="80"></rect>
|
|
241
|
+
<rect x="20" y="92" width="170" height="80"></rect>
|
|
242
|
+
<rect x="20" y="184" width="170" height="80"></rect>
|
|
243
|
+
</g>
|
|
244
|
+
<text x="44" y="50">v5</text>
|
|
245
|
+
<text x="44" y="142">v4</text>
|
|
246
|
+
<text x="44" y="234">v3</text>
|
|
247
|
+
<rect x="18" y="-2" width="174" height="84" style="fill: none; stroke: var(--accent); stroke-width: 2"></rect>
|
|
248
|
+
<line x1="210" y1="40" x2="286" y2="40" style="stroke: var(--accent); stroke-width: 2" marker-end="url(#tip2)"></line>
|
|
249
|
+
<text x="300" y="48" style="fill: var(--muted)">newest</text>
|
|
250
|
+
<defs>
|
|
251
|
+
<marker id="tip2" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto">
|
|
252
|
+
<path d="M0 0 L10 5 L0 10 z" style="fill: var(--accent)"></path>
|
|
253
|
+
</marker>
|
|
254
|
+
</defs>
|
|
255
|
+
</g>
|
|
256
|
+
</svg>
|
|
257
|
+
<figcaption>The newest link follows the last publish.</figcaption>
|
|
258
|
+
</figure>
|
|
259
|
+
<figure>
|
|
260
|
+
<svg viewBox="0 0 460 270" role="img" aria-label="A pinned link points at version 3, and later versions are still stored.">
|
|
261
|
+
<g style="font-family: var(--font-sans); font-size: 20px; fill: var(--fg)">
|
|
262
|
+
<g style="fill: var(--layer-01)">
|
|
263
|
+
<rect x="20" y="0" width="170" height="80"></rect>
|
|
264
|
+
<rect x="20" y="92" width="170" height="80"></rect>
|
|
265
|
+
<rect x="20" y="184" width="170" height="80"></rect>
|
|
266
|
+
</g>
|
|
267
|
+
<text x="44" y="50">v5</text>
|
|
268
|
+
<text x="44" y="142">v4</text>
|
|
269
|
+
<text x="44" y="234">v3</text>
|
|
270
|
+
<rect x="18" y="182" width="174" height="84" style="fill: none; stroke: var(--accent); stroke-width: 2"></rect>
|
|
271
|
+
<line x1="210" y1="224" x2="286" y2="224" style="stroke: var(--accent); stroke-width: 2" marker-end="url(#tip3)"></line>
|
|
272
|
+
<text x="300" y="232" style="fill: var(--muted)">pinned</text>
|
|
273
|
+
<defs>
|
|
274
|
+
<marker id="tip3" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto">
|
|
275
|
+
<path d="M0 0 L10 5 L0 10 z" style="fill: var(--accent)"></path>
|
|
276
|
+
</marker>
|
|
277
|
+
</defs>
|
|
278
|
+
</g>
|
|
279
|
+
</svg>
|
|
280
|
+
<figcaption>A pinned link stays on the version you chose.</figcaption>
|
|
281
|
+
</figure>
|
|
282
|
+
</div>
|
|
283
|
+
<aside class="notes">
|
|
284
|
+
<p>Same folder, same storage, two promises. A pin is one line in the
|
|
285
|
+
artifact record, not a copy of the files.</p>
|
|
286
|
+
</aside>
|
|
287
|
+
</section>
|
|
288
|
+
|
|
289
|
+
<section class="slide quote">
|
|
290
|
+
<blockquote>A link that survives the next edit is worth more than a tidy changelog.</blockquote>
|
|
291
|
+
<cite>Project notes, on why every publish keeps its own version</cite>
|
|
292
|
+
<aside class="notes">
|
|
293
|
+
<p>This is the whole pitch. Stop talking for a moment after it.</p>
|
|
294
|
+
</aside>
|
|
295
|
+
</section>
|
|
296
|
+
|
|
297
|
+
<section class="slide big-number">
|
|
298
|
+
<p class="value">5 versions, 1 link</p>
|
|
299
|
+
<p class="caption">Five publishes of one folder, each at its own path, all reachable from the link the first publish printed.</p>
|
|
300
|
+
<p class="source">Example data, not a measurement. Try it on one folder before the next meeting.</p>
|
|
301
|
+
<aside class="notes">
|
|
302
|
+
<p>Close here. Say where the docs are and offer to sit with anyone for
|
|
303
|
+
their first publish.</p>
|
|
304
|
+
</aside>
|
|
305
|
+
</section>
|
|
306
|
+
|
|
307
|
+
</main>
|
|
308
|
+
|
|
309
|
+
<script src="../deck.js"></script>
|
|
310
|
+
</body>
|
|
311
|
+
</html>
|
|
@@ -0,0 +1,331 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
6
|
+
<meta name="color-scheme" content="light dark">
|
|
7
|
+
<title>Mockup: one desktop app in four windows</title>
|
|
8
|
+
<!--
|
|
9
|
+
One desktop app, drawn four times: a window on macOS, on Windows, on Linux,
|
|
10
|
+
and a frameless window that paints its own title bar. The fifth screen is the
|
|
11
|
+
same product as a bare surface, the way a GPU drawn toolkit such as egui
|
|
12
|
+
paints it, with the compact dark preset switched on.
|
|
13
|
+
|
|
14
|
+
The point of the file is that the app is the same in every frame: the content
|
|
15
|
+
does not change when the chrome does. A mockup follows the platform the app
|
|
16
|
+
ships on, not rshow and not a convention borrowed from a browser.
|
|
17
|
+
|
|
18
|
+
Theme links. A published mockup points at the theme artifact with
|
|
19
|
+
root-relative URLs, one per file, all at the same pinned version:
|
|
20
|
+
|
|
21
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/fonts.css">
|
|
22
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/tokens.css">
|
|
23
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/mockup.css">
|
|
24
|
+
<link rel="stylesheet" href="/_themes/<name>@<n>/skins/wire.css" id="mk-skin" data-mk-skin>
|
|
25
|
+
<script src="/_themes/<name>@<n>/mode.js"></script>
|
|
26
|
+
<script defer src="/_themes/<name>@<n>/mockup.js"></script>
|
|
27
|
+
<script defer src="/_themes/<name>@<n>/skins/sketch.js"></script>
|
|
28
|
+
|
|
29
|
+
"Ledger" and its notes are placeholders: this is a layout, not a product.
|
|
30
|
+
-->
|
|
31
|
+
<link rel="stylesheet" href="../fonts.css">
|
|
32
|
+
<link rel="stylesheet" href="../tokens.css">
|
|
33
|
+
<link rel="stylesheet" href="../mockup.css">
|
|
34
|
+
<link rel="stylesheet" href="../skins/wire.css" id="mk-skin" data-mk-skin>
|
|
35
|
+
<script src="../mode.js"></script>
|
|
36
|
+
<script defer src="../mockup.js"></script>
|
|
37
|
+
<script defer src="../skins/sketch.js"></script>
|
|
38
|
+
</head>
|
|
39
|
+
<body>
|
|
40
|
+
|
|
41
|
+
<main class="mockup" data-name="Ledger" data-skin="wire">
|
|
42
|
+
|
|
43
|
+
<!-- ================================================================ macOS -->
|
|
44
|
+
<section class="artboard" id="window-mac" data-frame="desktop" data-os="mac"
|
|
45
|
+
data-title="macOS window" data-window-title="Ledger" data-flush
|
|
46
|
+
data-w="1280" data-h="800">
|
|
47
|
+
|
|
48
|
+
<div class="wf-col" style="height:100%;gap:0">
|
|
49
|
+
<div class="wf-row" style="height:48px;padding:0 16px;gap:12px;border-bottom:1px solid var(--mk-line)">
|
|
50
|
+
<span class="wf-icon" data-size="lg"></span>
|
|
51
|
+
<strong>Ledger</strong>
|
|
52
|
+
<span class="wf-spacer"></span>
|
|
53
|
+
<span class="wf-input" data-label="Find" style="width:240px">Search notes</span>
|
|
54
|
+
<span class="wf-icon"></span>
|
|
55
|
+
<span class="wf-avatar" data-size="sm"></span>
|
|
56
|
+
</div>
|
|
57
|
+
<div class="wf-row wf-shell wf-grow">
|
|
58
|
+
<div class="wf-sidebar">
|
|
59
|
+
<span class="wf-text" data-lines="1" style="width:60%"></span>
|
|
60
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Inbox</span></div>
|
|
61
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Weekly plan</span></div>
|
|
62
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Clients</span></div>
|
|
63
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Archive</span></div>
|
|
64
|
+
<span class="wf-spacer"></span>
|
|
65
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Settings</span></div>
|
|
66
|
+
</div>
|
|
67
|
+
<div class="wf-col" style="width:300px;padding:12px;gap:10px;border-right:1px solid var(--mk-line)">
|
|
68
|
+
<span class="wf-text" data-lines="1" style="width:80px"></span>
|
|
69
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
70
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
71
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
72
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
73
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
74
|
+
</div>
|
|
75
|
+
<div class="wf-col wf-grow" style="padding:24px;gap:14px">
|
|
76
|
+
<span class="wf-heading">Weekly plan</span>
|
|
77
|
+
<div class="wf-row" style="gap:8px;font-size:12px;color:var(--mk-muted)">
|
|
78
|
+
<span>Edited two days ago</span>
|
|
79
|
+
<span>/</span>
|
|
80
|
+
<span>Inbox</span>
|
|
81
|
+
</div>
|
|
82
|
+
<span class="wf-text" data-lines="4"></span>
|
|
83
|
+
<span class="wf-box" style="height:96px"></span>
|
|
84
|
+
<span class="wf-text" data-lines="3"></span>
|
|
85
|
+
<span class="wf-text" data-lines="6"></span>
|
|
86
|
+
<span class="wf-spacer"></span>
|
|
87
|
+
<div class="wf-row">
|
|
88
|
+
<span class="wf-text" data-lines="1" style="width:120px"></span>
|
|
89
|
+
<span class="wf-spacer"></span>
|
|
90
|
+
<span class="wf-button">Preview</span>
|
|
91
|
+
<span class="wf-button primary">Save</span>
|
|
92
|
+
</div>
|
|
93
|
+
</div>
|
|
94
|
+
</div>
|
|
95
|
+
</div>
|
|
96
|
+
|
|
97
|
+
<span class="note-pin" data-note="The app does not change between the four frames. Only the chrome does, so draw the chrome the platform draws."
|
|
98
|
+
style="top:62px;left:1216px"></span>
|
|
99
|
+
</section>
|
|
100
|
+
|
|
101
|
+
<!-- ============================================================== Windows -->
|
|
102
|
+
<section class="artboard" id="window-windows" data-frame="desktop" data-os="windows"
|
|
103
|
+
data-title="Windows window" data-window-title="Ledger - weekly plan" data-flush
|
|
104
|
+
data-w="1280" data-h="800">
|
|
105
|
+
|
|
106
|
+
<div class="wf-col" style="height:100%;gap:0">
|
|
107
|
+
<div class="wf-row" style="height:48px;padding:0 16px;gap:12px;border-bottom:1px solid var(--mk-line)">
|
|
108
|
+
<span class="wf-icon" data-size="lg"></span>
|
|
109
|
+
<strong>Ledger</strong>
|
|
110
|
+
<span class="wf-spacer"></span>
|
|
111
|
+
<span class="wf-input" data-label="Find" style="width:240px">Search notes</span>
|
|
112
|
+
<span class="wf-icon"></span>
|
|
113
|
+
<span class="wf-avatar" data-size="sm"></span>
|
|
114
|
+
</div>
|
|
115
|
+
<div class="wf-row wf-shell wf-grow">
|
|
116
|
+
<div class="wf-sidebar">
|
|
117
|
+
<span class="wf-text" data-lines="1" style="width:60%"></span>
|
|
118
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Inbox</span></div>
|
|
119
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Weekly plan</span></div>
|
|
120
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Clients</span></div>
|
|
121
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Archive</span></div>
|
|
122
|
+
<span class="wf-spacer"></span>
|
|
123
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Settings</span></div>
|
|
124
|
+
</div>
|
|
125
|
+
<div class="wf-col" style="width:300px;padding:12px;gap:10px;border-right:1px solid var(--mk-line)">
|
|
126
|
+
<span class="wf-text" data-lines="1" style="width:80px"></span>
|
|
127
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
128
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
129
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
130
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
131
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
132
|
+
</div>
|
|
133
|
+
<div class="wf-col wf-grow" style="padding:24px;gap:14px">
|
|
134
|
+
<span class="wf-heading">Weekly plan</span>
|
|
135
|
+
<div class="wf-row" style="gap:8px;font-size:12px;color:var(--mk-muted)">
|
|
136
|
+
<span>Edited two days ago</span>
|
|
137
|
+
<span>/</span>
|
|
138
|
+
<span>Inbox</span>
|
|
139
|
+
</div>
|
|
140
|
+
<span class="wf-text" data-lines="4"></span>
|
|
141
|
+
<span class="wf-box" style="height:96px"></span>
|
|
142
|
+
<span class="wf-text" data-lines="3"></span>
|
|
143
|
+
<span class="wf-text" data-lines="6"></span>
|
|
144
|
+
<span class="wf-spacer"></span>
|
|
145
|
+
<div class="wf-row">
|
|
146
|
+
<span class="wf-text" data-lines="1" style="width:120px"></span>
|
|
147
|
+
<span class="wf-spacer"></span>
|
|
148
|
+
<span class="wf-button">Preview</span>
|
|
149
|
+
<span class="wf-button primary">Save</span>
|
|
150
|
+
</div>
|
|
151
|
+
</div>
|
|
152
|
+
</div>
|
|
153
|
+
</div>
|
|
154
|
+
|
|
155
|
+
<span class="note-pin" data-note="Windows writes the title on the left and the three controls on the right. Do not centre either of them."
|
|
156
|
+
style="top:48px;left:1216px"></span>
|
|
157
|
+
</section>
|
|
158
|
+
|
|
159
|
+
<!-- ================================================================ Linux -->
|
|
160
|
+
<section class="artboard" id="window-linux" data-frame="desktop" data-os="linux"
|
|
161
|
+
data-title="Linux window" data-window-title="Ledger" data-flush
|
|
162
|
+
data-w="1280" data-h="800">
|
|
163
|
+
|
|
164
|
+
<div class="wf-col" style="height:100%;gap:0">
|
|
165
|
+
<div class="wf-row" style="height:48px;padding:0 16px;gap:12px;border-bottom:1px solid var(--mk-line)">
|
|
166
|
+
<span class="wf-icon" data-size="lg"></span>
|
|
167
|
+
<strong>Ledger</strong>
|
|
168
|
+
<span class="wf-spacer"></span>
|
|
169
|
+
<span class="wf-input" data-label="Find" style="width:240px">Search notes</span>
|
|
170
|
+
<span class="wf-icon"></span>
|
|
171
|
+
<span class="wf-avatar" data-size="sm"></span>
|
|
172
|
+
</div>
|
|
173
|
+
<div class="wf-row wf-shell wf-grow">
|
|
174
|
+
<div class="wf-sidebar">
|
|
175
|
+
<span class="wf-text" data-lines="1" style="width:60%"></span>
|
|
176
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Inbox</span></div>
|
|
177
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Weekly plan</span></div>
|
|
178
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Clients</span></div>
|
|
179
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Archive</span></div>
|
|
180
|
+
<span class="wf-spacer"></span>
|
|
181
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Settings</span></div>
|
|
182
|
+
</div>
|
|
183
|
+
<div class="wf-col" style="width:300px;padding:12px;gap:10px;border-right:1px solid var(--mk-line)">
|
|
184
|
+
<span class="wf-text" data-lines="1" style="width:80px"></span>
|
|
185
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
186
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
187
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
188
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
189
|
+
<span class="wf-box" style="min-height:64px"></span>
|
|
190
|
+
</div>
|
|
191
|
+
<div class="wf-col wf-grow" style="padding:24px;gap:14px">
|
|
192
|
+
<span class="wf-heading">Weekly plan</span>
|
|
193
|
+
<div class="wf-row" style="gap:8px;font-size:12px;color:var(--mk-muted)">
|
|
194
|
+
<span>Edited two days ago</span>
|
|
195
|
+
<span>/</span>
|
|
196
|
+
<span>Inbox</span>
|
|
197
|
+
</div>
|
|
198
|
+
<span class="wf-text" data-lines="4"></span>
|
|
199
|
+
<span class="wf-box" style="height:96px"></span>
|
|
200
|
+
<span class="wf-text" data-lines="3"></span>
|
|
201
|
+
<span class="wf-text" data-lines="6"></span>
|
|
202
|
+
<span class="wf-spacer"></span>
|
|
203
|
+
<div class="wf-row">
|
|
204
|
+
<span class="wf-text" data-lines="1" style="width:120px"></span>
|
|
205
|
+
<span class="wf-spacer"></span>
|
|
206
|
+
<span class="wf-button">Preview</span>
|
|
207
|
+
<span class="wf-button primary">Save</span>
|
|
208
|
+
</div>
|
|
209
|
+
</div>
|
|
210
|
+
</div>
|
|
211
|
+
</div>
|
|
212
|
+
</section>
|
|
213
|
+
|
|
214
|
+
<!-- ============================================ a window with no chrome -->
|
|
215
|
+
<section class="artboard" id="window-custom" data-frame="custom" data-controls data-drag="40"
|
|
216
|
+
data-title="Frameless window" data-flush
|
|
217
|
+
data-w="1280" data-h="800">
|
|
218
|
+
|
|
219
|
+
<div class="wf-col" style="height:100%;gap:0">
|
|
220
|
+
<div class="drag-region wf-row" style="height:40px;padding:0 16px;gap:12px;border-bottom:1px solid var(--mk-line)">
|
|
221
|
+
<span class="wf-icon"></span>
|
|
222
|
+
<strong>Ledger</strong>
|
|
223
|
+
<span class="wf-spacer"></span>
|
|
224
|
+
</div>
|
|
225
|
+
<div class="wf-row" style="height:48px;padding:0 16px;gap:12px;border-bottom:1px solid var(--mk-line)">
|
|
226
|
+
<span class="wf-icon"></span>
|
|
227
|
+
<span class="wf-spacer"></span>
|
|
228
|
+
<span class="wf-input" data-label="Find" style="width:240px">Search notes</span>
|
|
229
|
+
<span class="wf-avatar" data-size="sm"></span>
|
|
230
|
+
</div>
|
|
231
|
+
<div class="wf-row wf-shell wf-grow">
|
|
232
|
+
<div class="wf-sidebar">
|
|
233
|
+
<span class="wf-text" data-lines="1" style="width:60%"></span>
|
|
234
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Inbox</span></div>
|
|
235
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Weekly plan</span></div>
|
|
236
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Clients</span></div>
|
|
237
|
+
<div class="wf-row" style="gap:8px"><span class="wf-icon"></span><span>Archive</span></div>
|
|
238
|
+
</div>
|
|
239
|
+
<div class="wf-col wf-grow" style="padding:24px;gap:14px">
|
|
240
|
+
<span class="wf-heading">Weekly plan</span>
|
|
241
|
+
<span class="wf-text" data-lines="4"></span>
|
|
242
|
+
<span class="wf-box" style="height:96px"></span>
|
|
243
|
+
<span class="wf-text" data-lines="3"></span>
|
|
244
|
+
<span class="wf-text" data-lines="6"></span>
|
|
245
|
+
<span class="wf-spacer"></span>
|
|
246
|
+
<div class="wf-row">
|
|
247
|
+
<span class="wf-spacer"></span>
|
|
248
|
+
<span class="wf-button primary">Save</span>
|
|
249
|
+
</div>
|
|
250
|
+
</div>
|
|
251
|
+
</div>
|
|
252
|
+
</div>
|
|
253
|
+
|
|
254
|
+
<span class="note-pin" data-note="A frameless window draws its own bar, so the drag region is part of the design. Mark it, and mark where the system puts its controls."
|
|
255
|
+
style="top:8px;left:800px"></span>
|
|
256
|
+
</section>
|
|
257
|
+
|
|
258
|
+
<!-- ============================================ the same tool, bare, dark -->
|
|
259
|
+
<section class="artboard preset-compact-dark" id="tool-bare" data-frame="bare"
|
|
260
|
+
data-title="Compact dark tool, bare frame" data-flush
|
|
261
|
+
data-w="1024" data-h="640">
|
|
262
|
+
|
|
263
|
+
<div class="wf-col" style="height:100%;gap:0">
|
|
264
|
+
<div class="wf-row" style="height:26px;padding:0 8px;gap:12px;border-bottom:1px solid var(--mk-line);font-size:11px">
|
|
265
|
+
<span>File</span>
|
|
266
|
+
<span>Edit</span>
|
|
267
|
+
<span>View</span>
|
|
268
|
+
<span class="wf-spacer"></span>
|
|
269
|
+
<span>beam 0.4</span>
|
|
270
|
+
</div>
|
|
271
|
+
<div class="wf-row wf-shell wf-grow">
|
|
272
|
+
<div class="wf-sidebar" style="width:180px;gap:2px">
|
|
273
|
+
<span class="wf-text" data-lines="1" style="width:70%"></span>
|
|
274
|
+
<span>Scene</span>
|
|
275
|
+
<span>Camera</span>
|
|
276
|
+
<span>Lighting</span>
|
|
277
|
+
<span>Materials</span>
|
|
278
|
+
<span class="wf-spacer"></span>
|
|
279
|
+
<span>Console</span>
|
|
280
|
+
</div>
|
|
281
|
+
<div class="wf-col" style="width:240px;padding:8px;gap:6px;border-right:1px solid var(--mk-line)">
|
|
282
|
+
<span class="wf-text" data-lines="1" style="width:60px"></span>
|
|
283
|
+
<span class="wf-select">Cube</span>
|
|
284
|
+
<span class="wf-select">Mesh 03</span>
|
|
285
|
+
<div class="wf-row" style="gap:6px">
|
|
286
|
+
<span class="wf-checkbox" data-checked="true"></span>
|
|
287
|
+
<span>Cast shadows</span>
|
|
288
|
+
</div>
|
|
289
|
+
<div class="wf-row" style="gap:6px">
|
|
290
|
+
<span class="wf-toggle on"></span>
|
|
291
|
+
<span>Visible</span>
|
|
292
|
+
</div>
|
|
293
|
+
<div class="wf-row" style="gap:6px">
|
|
294
|
+
<span class="wf-input" data-label="X">0.00</span>
|
|
295
|
+
<span class="wf-input" data-label="Y">1.42</span>
|
|
296
|
+
<span class="wf-input" data-label="Z">0.00</span>
|
|
297
|
+
</div>
|
|
298
|
+
<span class="wf-spacer"></span>
|
|
299
|
+
<div class="wf-row" style="gap:6px">
|
|
300
|
+
<span class="wf-button">Reset</span>
|
|
301
|
+
<span class="wf-button primary">Apply</span>
|
|
302
|
+
</div>
|
|
303
|
+
</div>
|
|
304
|
+
<div class="wf-col wf-grow" style="padding:8px;gap:6px">
|
|
305
|
+
<span class="wf-image" style="height:100%"></span>
|
|
306
|
+
</div>
|
|
307
|
+
<div class="wf-col" style="width:220px;padding:8px;gap:6px;border-left:1px solid var(--mk-line)">
|
|
308
|
+
<span>Inspector</span>
|
|
309
|
+
<span class="wf-table" data-rows="4" data-cols="2"></span>
|
|
310
|
+
<span class="wf-text" data-lines="4"></span>
|
|
311
|
+
<span class="wf-spacer"></span>
|
|
312
|
+
<span class="wf-box" style="min-height:0;padding:2px 8px;align-self:flex-start">Saved</span>
|
|
313
|
+
</div>
|
|
314
|
+
</div>
|
|
315
|
+
<div class="wf-row" style="height:22px;padding:0 8px;gap:12px;border-top:1px solid var(--mk-line);font-size:11px">
|
|
316
|
+
<span>4 objects selected</span>
|
|
317
|
+
<span class="wf-spacer"></span>
|
|
318
|
+
<span>60 fps</span>
|
|
319
|
+
</div>
|
|
320
|
+
</div>
|
|
321
|
+
|
|
322
|
+
<span class="note-pin" data-note="A bare frame has no chrome at all: this is what a GPU drawn toolkit looks like, and the tool must not add a window around it."
|
|
323
|
+
style="top:8px;left:300px"></span>
|
|
324
|
+
<span class="note-pin" data-note="The compact dark preset is one block of tokens in skins/custom.css, not a second skin."
|
|
325
|
+
style="top:300px;left:170px"></span>
|
|
326
|
+
</section>
|
|
327
|
+
|
|
328
|
+
</main>
|
|
329
|
+
|
|
330
|
+
</body>
|
|
331
|
+
</html>
|