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>docs/guide.md · files · example.test</title>
8<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
9<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#0c0c0c">
10<meta name="apple-mobile-web-app-title" content="ermite">
11<link rel="icon" type="image/svg+xml" href="/-/static/img/icon.HASH.svg">
12<link rel="apple-touch-icon" href="/-/static/app/apple-touch-icon.HASH.png">
13<link rel="manifest" href="/-/static/app/manifest.HASH.webmanifest">
14<link rel="preload" href="/-/static/fonts/atkinson-next.HASH.woff2" as="font" type="font/woff2" crossorigin>
15<link rel="stylesheet" href="/-/static/css/ermite.HASH.css">
16<meta name="htmx-config" content='{"history":false,"includeIndicatorCSS":false,"extensions":"sse, hx-live"}'>
17<script src="/-/static/js/htmx.min.HASH.js" defer>
18</script>
19<script src="/-/static/js/hx-live.min.HASH.js" defer>
20</script>
21<script src="/-/static/js/hx-sse.min.HASH.js" defer>
22</script>
23<script src="/-/static/js/ermite.HASH.js" defer>
24</script>
25<script src="/-/static/js/files.HASH.js" defer>
26</script>
27<script src="/-/static/js/passkey.HASH.js" defer>
28</script>
29<script src="/-/static/js/log.HASH.js" defer>
30</script>
31</head>
32<body data-ref="main" data-sha="SHA40" data-sel="" data-nav="" data-paths="/files/paths/SHA40" data-blob="/files/blob/main">
33<a class="skip" href="#main">skip to content</a>
34<header class="hdr">
35<div class="hdr-top">
36<a class="brand" href="/" data-g="h" aria-label="home" title="home (g h)">
37<span class="brand-mark" aria-hidden="true">
38</span>
39</a>
40<nav class="crumbs" aria-label="Path">
41<ol>
42<li>
43<a href="/files">files</a>
44</li>
45<li>
46<a href="/files/tree/main">blob</a>
47</li>
48<li>
49<a href="/files/tree/main">main</a>
50</li>
51<li>
52<a href="/files/tree/main/docs">docs</a>
53</li>
54<li>
55<a href="/files/blob/main/docs/guide.md" aria-current="page">guide.md</a>
56</li>
57</ol>
58</nav>
59<div class="hdr-acts">
60<a class="btn ref" href="/files/refs" data-fire="refs" aria-keyshortcuts="b" title="switch branch or tag (b)">
61<span class="ico i-branch" aria-hidden="true">
62</span>
63<span class="ref-name">main</span>
64<span class="sha">SHA7</span>
65</a>
66<button type="button" class="btn search" data-js aria-haspopup="dialog" aria-controls="panel-cmd" aria-keyshortcuts="Control+K :" title="go to a section, ref, file or repo (ctrl k or :)" data-fire="cmd">
67<span class="ico i-search" aria-hidden="true">
68</span>
69<span class="search-label">Go to…</span>
70<kbd aria-hidden="true">ctrl k</kbd>
71</button>
72</div>
73</div>
74<nav class="tabs" aria-label="Sections">
75<ul>
76<li>
77<a href="/files" data-key="s" aria-keyshortcuts="s">Summary <kbd aria-hidden="true">s</kbd>
78</a>
79</li>
80<li>
81<a href="/files/tree/main" data-key="t" aria-keyshortcuts="t" aria-current="page">Files <kbd aria-hidden="true">t</kbd>
82</a>
83</li>
84<li>
85<a href="/files/commits/main" data-key="c" aria-keyshortcuts="c">Commits <kbd aria-hidden="true">c</kbd>
86</a>
87</li>
88<li>
89<a href="/files/refs" data-key="r" aria-keyshortcuts="r">Branches & tags <kbd aria-hidden="true">r</kbd>
90</a>
91</li>
92<li>
93<a href="/files/merge-requests" data-key="m" aria-keyshortcuts="m">Merge requests <kbd aria-hidden="true">m</kbd>
94</a>
95</li>
96<li>
97<a href="/files/actions" data-key="a" aria-keyshortcuts="a">Actions <kbd aria-hidden="true">a</kbd>
98</a>
99</li>
100</ul>
101</nav>
102</header>
103<div class="work has-rail">
104<main id="main" tabindex="-1">
105<h1 class="file-h">
106<span>guide.md</span>
107<span class="acts">
108<a class="btn" href="/files/raw/main/docs/guide.md">Raw</a>
109<a class="btn" href="/files/commits/main/docs/guide.md">History</a>
110<a class="btn" href="/files/tree/main/docs">Folder</a>
111</span>
112</h1>
113<article class="prose" aria-label="guide.md" hx-ignore>
114<h1 id="md-guide">Guide</h1>
115<h2 id="md-steps">Steps</h2>
116<p>Run it.</p>
117<pre>
118<code class="language-sh">make all
119</code>
120</pre>
121</article>
122<details class="source">
123<summary>source</summary>
124<pre class="chroma code" data-anchor="" hx-on:click="let a = event.target.closest('a.ln'); if (!a) return; event.preventDefault();
125 let n = +a.textContent; if (!event.shiftKey || !data.anchor) data.anchor = n;
126 let lo = Math.min(+data.anchor, n), hi = Math.max(+data.anchor, n);
127 history.replaceState(null, '', '#L' + lo + (hi > lo ? '-L' + hi : '')); trigger('sel')" hx-on:sel="let m = location.hash.match(/^#L(\d+)(?:-L(\d+))?$/); let lo = m ? +m[1] : 0, hi = m ? +(m[2] || m[1]) : 0;
128 q('.line in this').arr().forEach(l => { let k = +l.id.slice(1); l.classList.toggle('sel', k >= lo && k <= hi) });
129 document.body.dataset.sel = lo ? 'L' + lo + (hi > lo ? '-L' + hi + ' · ' + (hi - lo + 1) + ' lines' : '') : '';
130 if (lo && event.detail?.scroll) document.getElementById('L' + lo)?.scrollIntoView({ block: 'center' })" hx-live="if (!data.ready) { data.ready = '1'; trigger('sel', { scroll: true }) }" data-ready="">
131<code hx-ignore>
132<span class="line" id="L1">
133<a class="ln" href="#L1">1</a>
134<span class="gh"># Guide</span>
135</span>
136<span class="line" id="L2">
137<a class="ln" href="#L2">2</a>
138</span>
139<span class="line" id="L3">
140<a class="ln" href="#L3">3</a>
141<span class="gu">## Steps</span>
142</span>
143<span class="line" id="L4">
144<a class="ln" href="#L4">4</a>
145</span>
146<span class="line" id="L5">
147<a class="ln" href="#L5">5</a>Run it.</span>
148<span class="line" id="L6">
149<a class="ln" href="#L6">6</a>
150</span>
151<span class="line" id="L7">
152<a class="ln" href="#L7">7</a>
153<span class="s">```sh</span>
154</span>
155<span class="line" id="L8">
156<a class="ln" href="#L8">8</a>make all</span>
157<span class="line" id="L9">
158<a class="ln" href="#L9">9</a>
159<span class="s">```</span>
160</span>
161</code>
162</pre>
163</details>
164</main>
165<aside class="rail" aria-label="Context">
166<section aria-labelledby="r-file">
167<h2 id="r-file">File</h2>
168<dl class="kv">
169<dt>size</dt>
170<dd>47 B</dd>
171<dt>lines</dt>
172<dd>9</dd>
173<dt>type</dt>
174<dd>markdown</dd>
175</dl>
176</section>
177<section aria-labelledby="r-last">
178<h2 id="r-last">Last change <a href="/files/commits/main/docs/guide.md">History</a>
179</h2>
180<p>
181<a href="/files/commit/SHA40">SHA7</a> add docs/guide.md</p>
182<p class="dim">T · <time datetime="STAMP" title="STAMP">AGO</time>
183</p>
184</section>
185<section aria-labelledby="r-outline">
186<h2 id="r-outline">On this page</h2>
187<nav class="outline" aria-label="Outline">
188<a class="l1" href="#md-guide">Guide</a>
189<a class="l2" href="#md-steps">Steps</a>
190</nav>
191</section>
192<section aria-labelledby="r-sel">
193<h2 id="r-sel">Selection</h2>
194<p :text="document.body.dataset.sel || 'none · click a line number, shift-click extends'">none · click a line number, shift-click extends</p>
195<p class="dim">y copies a permalink pinned to the commit sha</p>
196</section>
197</aside>
198</div>
199<footer class="foot">
200<span>ermite devel</span>
201<a href="http://example.test/ermite" rel="noopener" title="source of this version (AGPL-3.0-or-later)">source</a>
202<button type="button" class="foot-keys" data-js data-fire="help" aria-haspopup="dialog" aria-controls="panel-help" aria-keyshortcuts="?">
203<kbd aria-hidden="true">?</kbd> keyboard shortcuts</button>
204</footer>
205<div class="hint" role="status" aria-live="polite">
206<span class="hint-nav" :text="document.body.dataset.nav || ''">
207</span>
208<span class="hint-sel" :text="document.body.dataset.sel ? document.body.dataset.sel + ' · y permalink' : ''">
209</span>
210<span class="hint-flash" :text="document.body.dataset.flash || ''">
211</span>
212</div>
213<dialog id="panel-help" class="panel modal" aria-label="Keyboard shortcuts" hx-on:keydown="event.key === 'Escape' && (event.preventDefault(), this.close())" hx-on:click="event.target === this && this.close()">
214<div class="panel-head">
215<h2>Keyboard shortcuts</h2>
216<button type="button" class="panel-x" aria-label="Close" hx-on:click="closest('dialog').close()">
217<kbd>esc</kbd> close</button>
218</div>
219<dl class="keys">
220<div>
221<dt>
222<kbd>ctrl k</kbd>
223<kbd>:</kbd>
224</dt>
225<dd>go to a section, branch, tag, file or repository</dd>
226</div>
227<div>
228<dt>
229<kbd>?</kbd>
230</dt>
231<dd>this list</dd>
232</div>
233<div>
234<dt>
235<kbd>j</kbd>
236<kbd>k</kbd>
237</dt>
238<dd>move the row cursor down / up</dd>
239</div>
240<div>
241<dt>
242<kbd>enter</kbd>
243</dt>
244<dd>open the row under the cursor</dd>
245</div>
246<div>
247<dt>
248<kbd>l</kbd>
249<kbd>h</kbd>
250</dt>
251<dd>into the side panel (on a merge request, its files) / back to the content; there j k move between its controls</dd>
252</div>
253<div>
254<dt>
255<kbd>g g</kbd>
256<kbd>G</kbd>
257</dt>
258<dd>first / last row</dd>
259</div>
260<div>
261<dt>
262<kbd>/</kbd>
263</dt>
264<dd>filter the list; on Files, find a file in the repository</dd>
265</div>
266<div>
267<dt>
268<kbd>b</kbd>
269</dt>
270<dd>switch branch or tag</dd>
271</div>
272<div>
273<dt>
274<kbd>s</kbd>
275<kbd>t</kbd>
276<kbd>c</kbd>
277<kbd>r</kbd>
278<kbd>m</kbd>
279</dt>
280<dd>tabs: summary, files, commits, branches & tags, merge requests</dd>
281</div>
282<div>
283<dt>
284<kbd>g h</kbd>
285</dt>
286<dd>home</dd>
287</div>
288<div>
289<dt>
290<kbd>y</kbd>
291</dt>
292<dd>copy a permalink pinned to the commit</dd>
293</div>
294<div>
295<dt>
296<kbd>d</kbd>
297<kbd>u</kbd>
298<kbd>x</kbd>
299</dt>
300<dd>diff: split / unified / collapse or expand all</dd>
301</div>
302<div>
303<dt>
304<kbd>n</kbd>
305</dt>
306<dd>merge request: next note in the diff</dd>
307</div>
308<div>
309<dt>
310<kbd>esc</kbd>
311</dt>
312<dd>close a dialog, leave a field</dd>
313</div>
314</dl>
315</dialog>
316<dialog id="panel-refs" class="panel modal" aria-label="Switch ref" hx-on:keydown="event.key === 'Escape' && (event.preventDefault(), this.close())" hx-on:click="event.target === this && this.close()">
317<div class="panel-head">
318<label for="refs-filter" class="sr">filter branches and tags</label>
319<input id="refs-filter" type="search" placeholder="Switch branch or tag…" autocomplete="off" data-pick="#panel-refs li" hx-on:input="ermite.filter(this)">
320<button type="button" class="panel-x" aria-label="Close" hx-on:click="closest('dialog').close()">
321<kbd>esc</kbd>
322</button>
323</div>
324<div class="panel-cols" data-picklist>
325<section aria-label="Branches">
326<h2>Branches <span class="count">2</span>
327</h2>
328<ul>
329<li>
330<a href="/files/tree/feature/x">
331<span class="mark" aria-hidden="true"> </span>feature/x</a>
332</li>
333<li>
334<a href="/files/tree/main" aria-current="true">
335<span class="mark" aria-hidden="true">●</span>main</a>
336</li>
337</ul>
338</section>
339<section aria-label="Tags">
340<h2>Tags <span class="count">1</span>
341</h2>
342<ul>
343<li>
344<a href="/files/tree/v1.0">
345<span class="mark" aria-hidden="true"> </span>v1.0</a>
346</li>
347</ul>
348</section>
349</div>
350</dialog>
351<dialog id="panel-cmd" class="panel modal" aria-label="Go to" hx-on:close="ermiteFinder.paletteClose()" hx-on:keydown="event.key === 'Escape' && (event.preventDefault(), this.close())" hx-on:click="event.target === this && this.close()">
352<div class="panel-head">
353<label for="cmd-q" class="sr">go to</label>
354<input id="cmd-q" type="search" placeholder="Go to a section, branch, tag, file or repository…" autocomplete="off" spellcheck="false" aria-controls="cmd-list" hx-on:input="ermite.cmdFilter(this); ermiteFinder.palette(this)" hx-on:keydown="ermite.cmdKey(event)">
355<button type="button" class="panel-x" aria-label="Close" hx-on:click="closest('dialog').close()">
356<kbd>esc</kbd>
357</button>
358</div>
359<ul id="cmd-list" class="cmd-list" aria-label="Targets">
360<li data-k="go home" data-cursor>
361<a href="/" tabindex="-1">
362<span class="lbl">home</span>
363<span class="k">go</span>
364</a>
365</li>
366<li data-k="section summary">
367<a href="/files" tabindex="-1">
368<span class="lbl">summary</span>
369<span class="k">section</span>
370</a>
371</li>
372<li data-k="section files">
373<a href="/files/tree/main" tabindex="-1">
374<span class="lbl">files</span>
375<span class="k">section</span>
376</a>
377</li>
378<li data-k="section commits">
379<a href="/files/commits/main" tabindex="-1">
380<span class="lbl">commits</span>
381<span class="k">section</span>
382</a>
383</li>
384<li data-k="section branches & tags">
385<a href="/files/refs" tabindex="-1">
386<span class="lbl">branches & tags</span>
387<span class="k">section</span>
388</a>
389</li>
390<li data-k="section merge requests">
391<a href="/files/merge-requests" tabindex="-1">
392<span class="lbl">merge requests</span>
393<span class="k">section</span>
394</a>
395</li>
396<li data-k="section actions">
397<a href="/files/actions" tabindex="-1">
398<span class="lbl">actions</span>
399<span class="k">section</span>
400</a>
401</li>
402<li data-k="branch feature/x">
403<a href="/files/tree/feature/x" tabindex="-1">
404<span class="lbl">feature/x</span>
405<span class="k">branch</span>
406</a>
407</li>
408<li data-k="branch main">
409<a href="/files/tree/main" tabindex="-1">
410<span class="lbl">main</span>
411<span class="k">branch</span>
412</a>
413</li>
414<li data-k="tag v1.0">
415<a href="/files/tree/v1.0" tabindex="-1">
416<span class="lbl">v1.0</span>
417<span class="k">tag</span>
418</a>
419</li>
420</ul>
421<p class="panel-foot">
422<span>
423<kbd>↑</kbd>
424<kbd>↓</kbd> move</span>
425<span>
426<kbd>enter</kbd> open</span>
427<span>
428<kbd>esc</kbd> close</span>
429</p>
430</dialog>
431<div id="keys" hidden hx-on="k-j from:body -> ermite.move(1);
432 k-k from:body -> ermite.move(-1);
433 k-top from:body -> ermite.edge(false);
434 k-bottom from:body -> ermite.edge(true);
435 k-open from:body -> ermite.open();
436 k-right from:body -> ermite.rail(true);
437 k-left from:body -> ermite.rail(false);
438 k-esc from:body -> ermite.closeDialogs();
439 k-help from:body -> ermite.dialog('panel-help');
440 k-refs from:body -> ermite.dialog('panel-refs', 'refs-filter');
441 k-cmd from:body -> ermite.dialog('panel-cmd', 'cmd-q'); ermiteFinder.load();
442 k-filter from:body -> ermite.focusFilter();
443 k-gh from:body -> ermite.go('.brand');
444 k-s from:body -> ermite.tab('s');
445 k-t from:body -> ermite.tab('t');
446 k-c from:body -> ermite.tab('c');
447 k-r from:body -> ermite.tab('r');
448 k-m from:body -> ermite.tab('m');
449 k-next from:body -> ermite.nextNote();
450 k-split from:body -> ermite.layout('split');
451 k-unified from:body -> ermite.layout('unified');
452 k-collapse from:body -> ermite.collapse();
453 k-permalink from:body -> ermite.permalink();
454 k-merge from:body -> window.ermiteMR?.openMerge();
455 k-read from:body -> window.ermiteMR?.markRead();
456 k-gf from:body -> window.ermiteMR?.focusFiles()">
457</div>
458</body>
459</html>