v0.19.0 55a688e

tree-subdir.html RawHistoryFolder

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 · 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">tree</a>
47</li>
48<li>
49<a href="/files/tree/main">main</a>
50</li>
51<li>
52<a href="/files/tree/main/docs" aria-current="page">docs</a>
53</li>
54</ol>
55</nav>
56<div class="hdr-acts">
57<a class="btn ref" href="/files/refs" data-fire="refs" aria-keyshortcuts="b" title="switch branch or tag (b)">
58<span class="ico i-branch" aria-hidden="true">
59</span>
60<span class="ref-name">main</span>
61<span class="sha">SHA7</span>
62</a>
63<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">
64<span class="ico i-search" aria-hidden="true">
65</span>
66<span class="search-label">Go to…</span>
67<kbd aria-hidden="true">ctrl k</kbd>
68</button>
69</div>
70</div>
71<nav class="tabs" aria-label="Sections">
72<ul>
73<li>
74<a href="/files" data-key="s" aria-keyshortcuts="s">Summary <kbd aria-hidden="true">s</kbd>
75</a>
76</li>
77<li>
78<a href="/files/tree/main" data-key="t" aria-keyshortcuts="t" aria-current="page">Files <kbd aria-hidden="true">t</kbd>
79</a>
80</li>
81<li>
82<a href="/files/commits/main" data-key="c" aria-keyshortcuts="c">Commits <kbd aria-hidden="true">c</kbd>
83</a>
84</li>
85<li>
86<a href="/files/refs" data-key="r" aria-keyshortcuts="r">Branches &amp; tags <kbd aria-hidden="true">r</kbd>
87</a>
88</li>
89<li>
90<a href="/files/merge-requests" data-key="m" aria-keyshortcuts="m">Merge requests <kbd aria-hidden="true">m</kbd>
91</a>
92</li>
93<li>
94<a href="/files/actions" data-key="a" aria-keyshortcuts="a">Actions <kbd aria-hidden="true">a</kbd>
95</a>
96</li>
97</ul>
98</nav>
99</header>
100<div class="work">
101<main id="main" tabindex="-1">
102<div class="filter">
103<label for="finder-q" class="sr">find a file</label>
104<input id="finder-q" type="search" data-filter role="combobox" aria-autocomplete="list" aria-controls="finder-list" aria-expanded="false" placeholder="Find a file…" autocomplete="off" spellcheck="false" hx-on:focus="ermiteFinder.load()" hx-on:input="ermiteFinder.input(this)" hx-on:keydown="ermiteFinder.key(this, event)">
105</div>
106<div id="finder" hidden>
107<p id="finder-status" class="dim" aria-live="polite">
108</p>
109<ul id="finder-list" class="cmd-list" role="listbox" aria-label="Files">
110</ul>
111</div>
112<div id="tree-view">
113<table class="list tree" aria-label="Entries">
114<thead>
115<tr>
116<th class="cur">
117</th>
118<th class="c-kind">
119</th>
120<th class="c-name">name</th>
121<th class="c-size">size</th>
122<th class="c-sub">last commit</th>
123<th class="c-who">author</th>
124<th class="c-when">date</th>
125</tr>
126</thead>
127<tbody id="tree-rows" data-rows hx-on:click="ermiteTree.click(event)">
128<tr data-cursor>
129<td class="cur" aria-hidden="true">
130</td>
131<td class="c-kind" aria-hidden="true">·</td>
132<td class="c-name">
133<a href="/files/blob/main/docs/README.md">README.md</a>
134</td>
135<td class="c-size num dim">62 B</td>
136<td class="c-sub dim">
137<a href="/files/commit/SHA40">add docs/README.md</a>
138</td>
139<td class="c-who dim">T</td>
140<td class="c-when nowrap dim">
141<time datetime="STAMP" title="STAMP">AGO</time>
142</td>
143</tr>
144<tr>
145<td class="cur" aria-hidden="true">
146</td>
147<td class="c-kind" aria-hidden="true">·</td>
148<td class="c-name">
149<a href="/files/blob/main/docs/guide.md">guide.md</a>
150</td>
151<td class="c-size num dim">47 B</td>
152<td class="c-sub dim">
153<a href="/files/commit/SHA40">add docs/guide.md</a>
154</td>
155<td class="c-who dim">T</td>
156<td class="c-when nowrap dim">
157<time datetime="STAMP" title="STAMP">AGO</time>
158</td>
159</tr>
160</tbody>
161</table>
162<section class="card readme" aria-labelledby="readme-h">
163<h2 class="card-h" id="readme-h">
164<span class="ico i-file" aria-hidden="true">
165</span> README.md</h2>
166<article class="prose" aria-label="README.md" hx-ignore>
167<h1 id="md-docs">Docs</h1>
168<p>Back to <a href="/files/blob/main/docs/guide.md">the guide</a> and <a href="/files/blob/main/main.go">root</a>.</p>
169</article>
170</section>
171</div>
172</main>
173</div>
174<footer class="foot">
175<span>ermite devel</span>
176<a href="http://example.test/ermite" rel="noopener" title="source of this version (AGPL-3.0-or-later)">source</a>
177<button type="button" class="foot-keys" data-js data-fire="help" aria-haspopup="dialog" aria-controls="panel-help" aria-keyshortcuts="?">
178<kbd aria-hidden="true">?</kbd> keyboard shortcuts</button>
179</footer>
180<div class="hint" role="status" aria-live="polite">
181<span class="hint-nav" :text="document.body.dataset.nav || ''">
182</span>
183<span class="hint-sel" :text="document.body.dataset.sel ? document.body.dataset.sel + ' · y permalink' : ''">
184</span>
185<span class="hint-flash" :text="document.body.dataset.flash || ''">
186</span>
187</div>
188<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()">
189<div class="panel-head">
190<h2>Keyboard shortcuts</h2>
191<button type="button" class="panel-x" aria-label="Close" hx-on:click="closest('dialog').close()">
192<kbd>esc</kbd> close</button>
193</div>
194<dl class="keys">
195<div>
196<dt>
197<kbd>ctrl k</kbd>
198<kbd>:</kbd>
199</dt>
200<dd>go to a section, branch, tag, file or repository</dd>
201</div>
202<div>
203<dt>
204<kbd>?</kbd>
205</dt>
206<dd>this list</dd>
207</div>
208<div>
209<dt>
210<kbd>j</kbd>
211<kbd>k</kbd>
212</dt>
213<dd>move the row cursor down / up</dd>
214</div>
215<div>
216<dt>
217<kbd>enter</kbd>
218</dt>
219<dd>open the row under the cursor</dd>
220</div>
221<div>
222<dt>
223<kbd>l</kbd>
224<kbd>h</kbd>
225</dt>
226<dd>into the side panel (on a merge request, its files) / back to the content; there j k move between its controls</dd>
227</div>
228<div>
229<dt>
230<kbd>g g</kbd>
231<kbd>G</kbd>
232</dt>
233<dd>first / last row</dd>
234</div>
235<div>
236<dt>
237<kbd>/</kbd>
238</dt>
239<dd>filter the list; on Files, find a file in the repository</dd>
240</div>
241<div>
242<dt>
243<kbd>b</kbd>
244</dt>
245<dd>switch branch or tag</dd>
246</div>
247<div>
248<dt>
249<kbd>s</kbd>
250<kbd>t</kbd>
251<kbd>c</kbd>
252<kbd>r</kbd>
253<kbd>m</kbd>
254</dt>
255<dd>tabs: summary, files, commits, branches &amp; tags, merge requests</dd>
256</div>
257<div>
258<dt>
259<kbd>g h</kbd>
260</dt>
261<dd>home</dd>
262</div>
263<div>
264<dt>
265<kbd>y</kbd>
266</dt>
267<dd>copy a permalink pinned to the commit</dd>
268</div>
269<div>
270<dt>
271<kbd>d</kbd>
272<kbd>u</kbd>
273<kbd>x</kbd>
274</dt>
275<dd>diff: split / unified / collapse or expand all</dd>
276</div>
277<div>
278<dt>
279<kbd>n</kbd>
280</dt>
281<dd>merge request: next note in the diff</dd>
282</div>
283<div>
284<dt>
285<kbd>esc</kbd>
286</dt>
287<dd>close a dialog, leave a field</dd>
288</div>
289</dl>
290</dialog>
291<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()">
292<div class="panel-head">
293<label for="refs-filter" class="sr">filter branches and tags</label>
294<input id="refs-filter" type="search" placeholder="Switch branch or tag…" autocomplete="off" data-pick="#panel-refs li" hx-on:input="ermite.filter(this)">
295<button type="button" class="panel-x" aria-label="Close" hx-on:click="closest('dialog').close()">
296<kbd>esc</kbd>
297</button>
298</div>
299<div class="panel-cols" data-picklist>
300<section aria-label="Branches">
301<h2>Branches <span class="count">2</span>
302</h2>
303<ul>
304<li>
305<a href="/files/tree/feature/x">
306<span class="mark" aria-hidden="true">&nbsp;</span>feature/x</a>
307</li>
308<li>
309<a href="/files/tree/main" aria-current="true">
310<span class="mark" aria-hidden="true">●</span>main</a>
311</li>
312</ul>
313</section>
314<section aria-label="Tags">
315<h2>Tags <span class="count">1</span>
316</h2>
317<ul>
318<li>
319<a href="/files/tree/v1.0">
320<span class="mark" aria-hidden="true">&nbsp;</span>v1.0</a>
321</li>
322</ul>
323</section>
324</div>
325</dialog>
326<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()">
327<div class="panel-head">
328<label for="cmd-q" class="sr">go to</label>
329<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)">
330<button type="button" class="panel-x" aria-label="Close" hx-on:click="closest('dialog').close()">
331<kbd>esc</kbd>
332</button>
333</div>
334<ul id="cmd-list" class="cmd-list" aria-label="Targets">
335<li data-k="go home" data-cursor>
336<a href="/" tabindex="-1">
337<span class="lbl">home</span>
338<span class="k">go</span>
339</a>
340</li>
341<li data-k="section summary">
342<a href="/files" tabindex="-1">
343<span class="lbl">summary</span>
344<span class="k">section</span>
345</a>
346</li>
347<li data-k="section files">
348<a href="/files/tree/main" tabindex="-1">
349<span class="lbl">files</span>
350<span class="k">section</span>
351</a>
352</li>
353<li data-k="section commits">
354<a href="/files/commits/main" tabindex="-1">
355<span class="lbl">commits</span>
356<span class="k">section</span>
357</a>
358</li>
359<li data-k="section branches &amp; tags">
360<a href="/files/refs" tabindex="-1">
361<span class="lbl">branches &amp; tags</span>
362<span class="k">section</span>
363</a>
364</li>
365<li data-k="section merge requests">
366<a href="/files/merge-requests" tabindex="-1">
367<span class="lbl">merge requests</span>
368<span class="k">section</span>
369</a>
370</li>
371<li data-k="section actions">
372<a href="/files/actions" tabindex="-1">
373<span class="lbl">actions</span>
374<span class="k">section</span>
375</a>
376</li>
377<li data-k="branch feature/x">
378<a href="/files/tree/feature/x" tabindex="-1">
379<span class="lbl">feature/x</span>
380<span class="k">branch</span>
381</a>
382</li>
383<li data-k="branch main">
384<a href="/files/tree/main" tabindex="-1">
385<span class="lbl">main</span>
386<span class="k">branch</span>
387</a>
388</li>
389<li data-k="tag v1.0">
390<a href="/files/tree/v1.0" tabindex="-1">
391<span class="lbl">v1.0</span>
392<span class="k">tag</span>
393</a>
394</li>
395</ul>
396<p class="panel-foot">
397<span>
398<kbd>↑</kbd>
399<kbd>↓</kbd> move</span>
400<span>
401<kbd>enter</kbd> open</span>
402<span>
403<kbd>esc</kbd> close</span>
404</p>
405</dialog>
406<div id="keys" hidden hx-on="k-j from:body -> ermite.move(1);
407         k-k from:body -> ermite.move(-1);
408         k-top from:body -> ermite.edge(false);
409         k-bottom from:body -> ermite.edge(true);
410         k-open from:body -> ermite.open();
411         k-right from:body -> ermite.rail(true);
412         k-left from:body -> ermite.rail(false);
413         k-esc from:body -> ermite.closeDialogs();
414         k-help from:body -> ermite.dialog('panel-help');
415         k-refs from:body -> ermite.dialog('panel-refs', 'refs-filter');
416         k-cmd from:body -> ermite.dialog('panel-cmd', 'cmd-q'); ermiteFinder.load();
417         k-filter from:body -> ermite.focusFilter();
418         k-gh from:body -> ermite.go('.brand');
419         k-s from:body -> ermite.tab('s');
420         k-t from:body -> ermite.tab('t');
421         k-c from:body -> ermite.tab('c');
422         k-r from:body -> ermite.tab('r');
423         k-m from:body -> ermite.tab('m');
424         k-next from:body -> ermite.nextNote();
425         k-split from:body -> ermite.layout('split');
426         k-unified from:body -> ermite.layout('unified');
427         k-collapse from:body -> ermite.collapse();
428         k-permalink from:body -> ermite.permalink();
429         k-merge from:body -> window.ermiteMR?.openMerge();
430         k-read from:body -> window.ermiteMR?.markRead();
431         k-gf from:body -> window.ermiteMR?.focusFiles()">
432</div>
433</body>
434</html>

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 2

Tags 45

↑↓ moveenter openesc close