Skip to content

Commit 41353ae

Browse files
committed
html docs
1 parent ecb7975 commit 41353ae

File tree

1 file changed

+28
-35
lines changed

1 file changed

+28
-35
lines changed

index.html

Lines changed: 28 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -205,46 +205,30 @@ <h1>
205205
<h2>Installation</h2>
206206
<p><a target="_blank" href="https://flatpak.org/">Flatpak</a> - is the proper way to install Stage on your linux desktop. Further commands are for terminal.</p>
207207
<p>Add <a href="https://flathub.org/apps/io.github.aganzha.Stage" target="_blank">Flathub</a> to flatpak remotes <br/>
208-
<code>
209-
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
210-
</code>
211-
</p>
212-
<p>Install Stage<br/>
213-
<code>
214-
flatpak install flathub io.github.aganzha.Stage
215-
</code>
216-
</p>
217-
<p>Run<br/>
218-
<code>
219-
flatpak run flathub io.github.aganzha.Stage
220-
</code>
221-
</p>
208+
<pre><code>flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
209+
flatpak install flathub io.github.aganzha.Stage
210+
flatpak run flathub io.github.aganzha.Stage</code></pre>
211+
</p>
222212
<p>Update<br/>
223213
<code>
224214
flatpak update io.github.aganzha.Stage
225215
</code>
226216
</p>
227217

228-
<p><strong>RPM for Fedora 42</strong></p>
229-
<p>Install copr
230-
<code>sudo dnf install copr</code>
231-
</p>
232-
<p>Enable repo
233-
<code>
234-
sudo dnf copr enable aganzha/stage
235-
</code>
236-
</p>
237-
<p>Install Stage
238-
<code>
239-
sudo dnf install stage-git-gui
240-
</code>
241-
</p>
242-
<p>Run
243-
<code>
244-
stage-git-gui
245-
</code>
218+
<p><strong>Fedora 42</strong></p>
219+
<pre><code>sudo dnf install copr
220+
sudo dnf copr enable aganzha/stage
221+
sudo dnf install stage-git-gui
222+
stage-git-gui</code></pre>
223+
246224
</p>
247225

226+
<p><strong>Ubuntu 25.04</strong></p>
227+
<pre><code>sudo add-apt-repository ppa:aganzha/stage
228+
sudo apt update
229+
sudo apt install stage-git-gui
230+
stage-git-gui</code></pre>
231+
248232
<h2>Usage</h2>
249233

250234
<h3>Main screen - Status window </h3>
@@ -277,13 +261,19 @@ <h4>Main commands</h4>
277261
<video controls autoplay muted loop width="960">
278262
<source src="https://storage.yandexcloud.net/www.aganzha.online/static/stage1.mp4" type="video/mp4">
279263
</video>
280-
<h4>Commands does not related to cursor position</h4>
264+
<h4>Commit/Push/Pull</h4>
281265
<ul>
282266
<li><code>c</code> - <b>C</b>ommit. Button in headerbar - <img class="inline" src="https://raw.githubusercontent.com/keenlycode/gnomicon/refs/heads/main/src/icon/object-select-symbolic.svg"/> </li>
283267
<li><code>p</code> - <b>P</b>ush. Button - <img class="inline" src="https://raw.githubusercontent.com/keenlycode/gnomicon/refs/heads/main/src/icon/send-to-symbolic.svg"/> </li>
284268
<li><code>f</code> - Pull (as in <b>F</b>etch). Button - <img class="inline" src="https://raw.githubusercontent.com/keenlycode/gnomicon/refs/heads/main/src/icon/document-save-symbolic.svg"/> </li>
285269
</ul>
286-
270+
<h4>Other commands</h4>
271+
<ul>
272+
<li><code>o</code> - opens quick repo selector</li>
273+
<li><code>Ctrl</code> + <code>o</code> opens repo choosing dialog</li>
274+
<li><code>Ctrl</code> + <code>b</code> blame line under cursor</li>
275+
</ul>
276+
287277
<h4>Command for displaying additional windows</h4>
288278
<ul>
289279

@@ -338,7 +328,10 @@ <h3>Stashes panel</h3>
338328
<p>Hitting <code>z</code> or <img class="inline" src="https://raw.githubusercontent.com/keenlycode/gnomicon/refs/heads/main/src/icon/sidebar-show-symbolic.svg"/> icon will open stashes panel. Hitting <code>z</code> one more time will stash all changes.</p>
339329
<h3>Tags window</h3>
340330
<p>Hitting <code>t</code> in Status window brings up Tags window. That window behave as a simple list where you can <code>c</code>reate, <code>k</code> delete (as in <b>K</b>ill) and <code>p</code> push tags to remote.</p>
341-
<p></p>
331+
<h3>Blame</h3>
332+
<p>Git blame in Stage is a bit strange :) Stage do not want to read your files directly. It only operates on diffs produced by libgit2. So, to view history of some line in code this line must somehow apear in Stage. This means you have to edit or delete this line :) Or line nearby (each change in git surrounded by 3 lines of context above and below). When you see your line in Stage you can put cursor on it and hit <code>Ctrl</code>+<code>b</code>. This will open up commit window pointing this line origin. Again, this works in Commit window to: hitting any line (except green one) in Commit window will bring another window with commit which contains this line adding.
333+
</p>
334+
<p></p>
342335
<footer style="font-size: 50%">
343336
<p>&copy; 2025 Alexey Ganzha.</p>
344337
</footer>

0 commit comments

Comments
 (0)