The TUI's keys¶
Every key of the TUI, screen by screen, as ? lists them there. The foot of each screen shows the keys used most.
In a list to choose from, Space ticks and Enter accepts what is ticked, and / narrows the list to what holds the letters typed. Every line typed has a cursor that ← → Home End move; a sample's value opens selected, so that what is typed replaces it, and an arrow or End keeps it to edit.
Typing¶
In every line typed (the filter, a prompt, a cell of the typing mode, a list's /, the start page's name and narrowing) and in the note. A window's Enter, Esc and Tab stay the window's.
Keys |
What they do |
|---|---|
|
move; Ctrl+← Ctrl+→ by word |
|
select; Ctrl+Shift+← Ctrl+Shift+→ by word; Ctrl+A all |
|
take a character out, or what is selected; what is typed replaces it |
|
take a word out |
|
undo |
|
redo; Alt+Z where the terminal sends Ctrl+Shift+Z as Ctrl+Z |
|
cut, paste |
|
copy what is selected; with nothing selected, close SampleKit, asked first over a line typed and not saved |
|
empty the line; in the note, the line doubled |
|
place the cursor; a drag selects, a double click a word |
In the note (N on a sample), besides:
Keys |
What they do |
|---|---|
|
put around what is selected |
|
a heading of that level; the same again, none |
|
a link around what is selected |
|
an image |
|
a code block |
|
a reference link |
|
a link's definition |
|
a footnote |
|
a new line, indented as this one; in a table, a new row |
|
under a list item's text, to a table's next cell, or four columns in |
|
a table's previous cell, or the selection's indentation taken back |
|
move; Ctrl+Home Ctrl+End to its start, its end |
|
the line deleted |
|
done: the change previewed |
The start page¶
samplekit alone, in a terminal.
Keys |
What they do |
|---|---|
|
open the project marked: the one SampleKit was started in comes first; started in a folder holding projects, those come first, then setting one up there |
|
open that recent project |
|
forget the recent project marked, asked first: its state removed, the folder kept |
|
move; Home End to the first and the last |
|
New project: a folder moved to, or one + makes, then set up by a few questions; Esc on the first question comes back here, the folder + made removed if still empty |
|
Open a folder: Enter on a project opens it, on any other goes in |
|
Configure a project: a recent one holding a .samplekitrc, or another moved to |
|
Guide and demo: the guide in the browser; the demo's page, its steps; the first time, the demo is written and its first step opened |
|
the theme: each tried on the page as the cursor reaches it, Enter keeps it for the projects naming none |
|
quit |
|
quit, from the page or from a project |
|
this help |
Moving through folders¶
Keys |
What they do |
|---|---|
|
into the folder marked |
|
up; Backspace too |
|
the home folder |
|
narrow the folders by typing; Esc clears it, as going in does |
|
a new folder here, for a new project |
|
the folder itself, chosen; a project opened; another gone into |
|
back to the page |
The demo¶
Keys |
What they do |
|---|---|
|
open that step; quitting it comes back to the demo's page |
|
the step marked; the home page, which walks through the steps, in the browser; the demo's folder, in the file manager, to edit its files and try the command line there; or Reset the demo, asked first |
|
back to the start page |
A project opened from here comes back here when it is quit.
The collection¶
What a project opens on: its samples, one per line. The basket, the samples Space puts in it, is kept from one session to the next, with the filter, the sort and the columns: C, p, t and D act on it alone while it holds any, and say so; x empties it.
Moving
Keys |
What they do |
|---|---|
|
next sample |
|
previous sample |
|
first sample |
|
last sample |
|
a page down |
|
a page up |
|
open the sample |
|
the columns further left |
|
the columns further right |
Finding and showing
Keys |
What they do |
|---|---|
|
apply a saved query or a profile |
|
group by fields, a heading above each group |
|
filter, Tab completes |
|
clear the filter |
|
sort by a column |
|
choose the columns |
|
the basket only, or everything |
|
the columns summarised, or the samples again |
Choosing
Keys |
What they do |
|---|---|
|
put in or take out of the basket, then the next row |
|
tag the basket, take a tag off it, or rename a tag: old=new, over every sample shown where the basket is empty |
|
put every sample shown in the basket |
|
empty the basket |
Changing
Keys |
What they do |
|---|---|
|
a new sample beside this one: its name, then field=value …, and keep:field,… from the one under the cursor |
|
undo the last change written |
|
write the changes waiting, all previewed: one change of the history |
|
remove the sample, or the basket's: its file, asked first, u gives it back |
|
rename the sample, its own files and the links leading to it, asked first |
|
the typing mode: ← → the column, what you type goes to the sample, the rows Shift+↑ ↓ took, or the basket |
Computing and checking
Keys |
What they do |
|---|---|
|
compute the selected values, or what is not current: the basket, or every sample shown |
|
the collection's state: what is not current, what is defective |
|
the project's history: each change kept, and what it changed |
Figures and exports
Keys |
What they do |
|---|---|
|
run a script, draw a figure, or write an export: of the basket, or of what is shown; w on a figure writes it to a file |
The project
Keys |
What they do |
|---|---|
|
the sample's own files |
|
the sample in $EDITOR |
|
the project's configuration, section by section |
|
the project's model in $EDITOR |
|
save what is shown in .samplekitrc: the filter, the columns, an export |
The TUI
Keys |
What they do |
|---|---|
|
the theme: each tried on the screen as the cursor reaches it, Enter keeps it |
|
this help |
|
quit |
A sample¶
One sample, value by value, and its tables.
Moving
Keys |
What they do |
|---|---|
|
next value |
|
previous value |
|
first value |
|
last value |
|
a page down |
|
a page up |
|
unfold a table |
|
back to the collection, or to the control screen it was opened from |
|
scroll the note down; the wheel over it too |
|
scroll the note up |
Finding and showing
Keys |
What they do |
|---|---|
|
show or hide the note, remembered |
Choosing
Keys |
What they do |
|---|---|
|
select the value, for c |
|
select every value a formula gives |
|
clear the selection |
Changing
Keys |
What they do |
|---|---|
|
write the changes waiting, all previewed: one change of the history |
|
remove this sample: its file, asked first, u gives it back |
|
rename this sample, its own files and the links leading to it, asked first |
|
the typing mode: what you type replaces the cell, the arrows go from cell to cell, Esc leaves |
|
edit the note |
|
add an attribute: its name, then its value |
|
undo the last change written |
Computing and checking
Keys |
What they do |
|---|---|
|
this sample's history: each change kept, and what it changed |
|
the value's card: its state, what it reads and what reads it, each typed in with e |
|
an attribute's items; a link, its sample or its address; a table, unfolded |
|
compute the selected values, or this one, even if current or edited |
|
compute what is not current in the sample |
Figures and exports
Keys |
What they do |
|---|---|
|
run a script, draw a figure, or write an export: of the basket, or of the sample |
The project
Keys |
What they do |
|---|---|
|
the sample's own files, or where the link under the cursor leads |
|
the sample in $EDITOR |
The TUI
Keys |
What they do |
|---|---|
|
the theme: each tried on the screen as the cursor reaches it, Enter keeps it |
|
this help |
A table¶
One table of a sample, row by row.
Moving
Keys |
What they do |
|---|---|
|
next row |
|
previous row |
|
first row |
|
last row |
|
a page down |
|
a page up |
|
next column |
|
previous column; from the first, back to the sample |
|
back to the sample |
Choosing
Keys |
What they do |
|---|---|
|
select the column, for c |
|
clear the selection |
Changing
Keys |
What they do |
|---|---|
|
write the changes waiting, all previewed: one change of the history |
|
the typing mode: what you type replaces the cell, a value with its uncertainty; on the empty row, a new row; Delete takes a row out |
|
undo the last change written |
Computing and checking
Keys |
What they do |
|---|---|
|
the sample's history: each change kept, and what it changed |
|
the cell's card: its state, what it reads and what reads it, each typed in with e |
|
compute the selected columns, or this one, even if current or edited |
|
compute what is not current in the sample |
Figures and exports
Keys |
What they do |
|---|---|
|
a figure of this table: a column against another, the selected first |
The project
Keys |
What they do |
|---|---|
|
the sample's own files |
|
the sample in $EDITOR |
The TUI
Keys |
What they do |
|---|---|
|
this help |
A value's card¶
i on a value of a sample, or on a table's cell holding one: the value, its readings, what it reads and what reads it, each with its value and its state.
Keys |
What they do |
|---|---|
|
the next line, the line above |
|
type over the line under the cursor: what is typed waits, and the card is drawn again as it makes it |
|
the changes waiting, previewed, written by y |
|
take back the last change |
|
close the card |
A list's window¶
Enter on an attribute: its items, one per row.
Moving
Keys |
What they do |
|---|---|
|
next item |
|
previous item |
|
back |
Changing
Keys |
What they do |
|---|---|
|
change the item, previewed; on the empty row, add one |
|
take the item out, previewed |
|
move the item down, previewed |
|
move the item up, previewed |
|
an attribute: a list of one to its single value, or back |
|
undo the last change written |
Computing and checking
Keys |
What they do |
|---|---|
|
where the item leads, where it is a link |
The project
Keys |
What they do |
|---|---|
|
where the item leads, where it is a link: its sample, its file or its address |
The TUI
Keys |
What they do |
|---|---|
|
this help |
The collection's state¶
v: what is not current, what is defective.
Moving
Keys |
What they do |
|---|---|
|
next |
|
previous |
|
first |
|
last |
|
a page down |
|
a page up |
|
open the sample, on its value |
|
back to the collection |
Changing
Keys |
What they do |
|---|---|
|
undo the last change written |
Computing and checking
Keys |
What they do |
|---|---|
|
compute every sample with a value outdated, failed or never computed |
The TUI
Keys |
What they do |
|---|---|
|
this help |
The history¶
H: each change kept, and what it changed.
Moving
Keys |
What they do |
|---|---|
|
next |
|
previous |
|
the newest |
|
the oldest |
|
a page down |
|
a page up |
|
scroll what it changed down |
|
scroll what it changed up |
|
back |
The history
Keys |
What they do |
|---|---|
|
take the files back to this snapshot, previewed: restore --at |
|
what this snapshot changed, and it marked; d on another compares the two: diff --from --to |
The TUI
Keys |
What they do |
|---|---|
|
this help |
Setting a project up¶
A folder with no project: a few questions.
Moving
Keys |
What they do |
|---|---|
|
the next answer |
|
the previous answer |
|
this answer, then the next question; at the end, set the project up |
|
the previous question; from the first, back to the start page or the collection |
The TUI
Keys |
What they do |
|---|---|
|
this help |
The configuration¶
P: the project's .samplekitrc, section by section.
Moving
Keys |
What they do |
|---|---|
|
next |
|
previous |
|
into the section |
|
back to the sections |
|
change the setting; on an entry, add a key to it |
|
back to the collection, keeping the changes not written |
Changing
Keys |
What they do |
|---|---|
|
change the setting; on an entry, add a key to it |
|
add a setting: key = value, or name.key = value |
|
remove the setting, or the whole entry |
|
write the file, its changes previewed |
|
read the file again, dropping the changes not written |
The TUI
Keys |
What they do |
|---|---|
|
this help |
Questions and lists¶
A question before a write shows what would change, as the command line's preview does:
Keys |
What they do |
|---|---|
|
write it |
|
leave it: nothing is written |
|
read a long question to its end |
A list to choose from, as s, c, g or p open one:
Keys |
What they do |
|---|---|
|
move |
|
first, last, a page |
|
in the sort, the columns and the groups, tick or untick |
|
in the sort, the columns and the groups, the item under the cursor up or down: its order |
|
in the sort, the field under the cursor descending, or back, and ticked |
|
narrow the list to what holds the letters typed |
|
in |
|
in |
|
accept |
|
clear the narrowing, then leave the list |
Marks¶
The marks beside a sample or a value, on the collection, a sample, a table and the collection's state.
Mark |
What it says |
|---|---|
● |
in the basket |
⚠ |
outdated: an input changed, or its record cannot be checked; C computes it |
✎ |
edited: a value typed over its formula, or its record missing |
✗ |
failed: its formula raised an error when last run |
∅ |
never computed, or waits for an input: what the model owes |
· |
readings with no statistic chosen: nothing computes the value |
⊘ |
defective, on the control screen: what validate refuses |
¶ |
a note, on the control screen: what validate remarks on |