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

← → Home End

move; Ctrl+← Ctrl+→ by word

Shift+← Shift+→ Shift+Home Shift+End

select; Ctrl+Shift+← Ctrl+Shift+→ by word; Ctrl+A all

Backspace Delete

take a character out, or what is selected; what is typed replaces it

Ctrl+Backspace Ctrl+Delete

take a word out

Ctrl+Z

undo

Ctrl+Shift+Z Alt+Z

redo; Alt+Z where the terminal sends Ctrl+Shift+Z as Ctrl+Z

Ctrl+X Ctrl+V

cut, paste

Ctrl+C

copy what is selected; with nothing selected, close SampleKit, asked first over a line typed and not saved

Ctrl+D

empty the line; in the note, the line doubled

click

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

Alt+1…6

a heading of that level; the same again, none

Alt+L

a link around what is selected

Alt+I

an image

Alt+C

a code block

Alt+K

a reference link

Alt+R

a link's definition

Alt+F

a footnote

Enter

a new line, indented as this one; in a table, a new row

Tab

under a list item's text, to a table's next cell, or four columns in

Shift+Tab

a table's previous cell, or the selection's indentation taken back

↑ ↓ PgUp PgDn

move; Ctrl+Home Ctrl+End to its start, its end

Ctrl+Y

the line deleted

Esc

done: the change previewed

The start page

samplekit alone, in a terminal.

Keys

What they do

Enter

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

1…9

open that recent project

x

forget the recent project marked, asked first: its state removed, the folder kept

j k ↑ ↓

move; Home End to the first and the last

n

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

o

Open a folder: Enter on a project opens it, on any other goes in

c

Configure a project: a recent one holding a .samplekitrc, or another moved to

g

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

T

the theme: each tried on the page as the cursor reaches it, Enter keeps it for the projects naming none

q Esc

quit

Ctrl+C

quit, from the page or from a project

?

this help

Moving through folders

Keys

What they do

→ l

into the folder marked

← h

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

Enter

the folder itself, chosen; a project opened; another gone into

Esc

back to the page

The demo

Keys

What they do

1…6

open that step; quitting it comes back to the demo's page

Enter

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

Esc q

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

j ↓

next sample

k ↑

previous sample

Home

first sample

End

last sample

PgDn

a page down

PgUp

a page up

Enter l →

open the sample

<

the columns further left

>

the columns further right

Finding and showing

Keys

What they do

f

apply a saved query or a profile

g

group by fields, a heading above each group

/

filter, Tab completes

Esc

clear the filter

s

sort by a column

c

choose the columns

b

the basket only, or everything

S

the columns summarised, or the samples again

Choosing

Keys

What they do

Space

put in or take out of the basket, then the next row

t

tag the basket, take a tag off it, or rename a tag: old=new, over every sample shown where the basket is empty

a

put every sample shown in the basket

x

empty the basket

Changing

Keys

What they do

N

a new sample beside this one: its name, then field=value …, and keep:field,… from the one under the cursor

u

undo the last change written

w

write the changes waiting, all previewed: one change of the history

D

remove the sample, or the basket's: its file, asked first, u gives it back

R

rename the sample, its own files and the links leading to it, asked first

e

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

C

compute the selected values, or what is not current: the basket, or every sample shown

v

the collection's state: what is not current, what is defective

H

the project's history: each change kept, and what it changed

Figures and exports

Keys

What they do

p

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

o

the sample's own files

E

the sample in $EDITOR

P

the project's configuration, section by section

M

the project's model in $EDITOR

W

save what is shown in .samplekitrc: the filter, the columns, an export

The TUI

Keys

What they do

T

the theme: each tried on the screen as the cursor reaches it, Enter keeps it

?

this help

q

quit

A sample

One sample, value by value, and its tables.

Moving

Keys

What they do

j ↓

next value

k ↑

previous value

Home

first value

End

last value

PgDn

a page down

PgUp

a page up

→ l

unfold a table

Esc h ← q

back to the collection, or to the control screen it was opened from

J

scroll the note down; the wheel over it too

K

scroll the note up

Finding and showing

Keys

What they do

n

show or hide the note, remembered

Choosing

Keys

What they do

Space

select the value, for c

a

select every value a formula gives

x

clear the selection

Changing

Keys

What they do

w

write the changes waiting, all previewed: one change of the history

D

remove this sample: its file, asked first, u gives it back

R

rename this sample, its own files and the links leading to it, asked first

e

the typing mode: what you type replaces the cell, the arrows go from cell to cell, Esc leaves

N

edit the note

A

add an attribute: its name, then its value

u

undo the last change written

Computing and checking

Keys

What they do

H

this sample's history: each change kept, and what it changed

i

the value's card: its state, what it reads and what reads it, each typed in with e

Enter

an attribute's items; a link, its sample or its address; a table, unfolded

c

compute the selected values, or this one, even if current or edited

C

compute what is not current in the sample

Figures and exports

Keys

What they do

p

run a script, draw a figure, or write an export: of the basket, or of the sample

The project

Keys

What they do

o

the sample's own files, or where the link under the cursor leads

E

the sample in $EDITOR

The TUI

Keys

What they do

T

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

j ↓

next row

k ↑

previous row

Home

first row

End

last row

PgDn

a page down

PgUp

a page up

→ l

next column

← h

previous column; from the first, back to the sample

Esc q

back to the sample

Choosing

Keys

What they do

Space

select the column, for c

x

clear the selection

Changing

Keys

What they do

w

write the changes waiting, all previewed: one change of the history

e

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

u

undo the last change written

Computing and checking

Keys

What they do

H

the sample's history: each change kept, and what it changed

i

the cell's card: its state, what it reads and what reads it, each typed in with e

c

compute the selected columns, or this one, even if current or edited

C

compute what is not current in the sample

Figures and exports

Keys

What they do

p

a figure of this table: a column against another, the selected first

The project

Keys

What they do

o

the sample's own files

E

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

j k ↓ ↑

the next line, the line above

e Enter F2

type over the line under the cursor: what is typed waits, and the card is drawn again as it makes it

w

the changes waiting, previewed, written by y

u

take back the last change

Esc q i

close the card

A list's window

Enter on an attribute: its items, one per row.

Moving

Keys

What they do

j ↓

next item

k ↑

previous item

Esc q ← h

back

Changing

Keys

What they do

e

change the item, previewed; on the empty row, add one

d

take the item out, previewed

J

move the item down, previewed

K

move the item up, previewed

L

an attribute: a list of one to its single value, or back

u

undo the last change written

Computing and checking

Keys

What they do

Enter

where the item leads, where it is a link

The project

Keys

What they do

o

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

j ↓

next

k ↑

previous

Home

first

End

last

PgDn

a page down

PgUp

a page up

Enter

open the sample, on its value

Esc q

back to the collection

Changing

Keys

What they do

u

undo the last change written

Computing and checking

Keys

What they do

C

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

j ↓

next

k ↑

previous

Home

the newest

End

the oldest

PgDn

a page down

PgUp

a page up

J

scroll what it changed down

K

scroll what it changed up

Esc q ← h

back

The history

Keys

What they do

r

take the files back to this snapshot, previewed: restore --at

d

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

j ↓

the next answer

k ↑

the previous answer

Enter

this answer, then the next question; at the end, set the project up

Esc q

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

j ↓

next

k ↑

previous

→ l Tab

into the section

← h

back to the sections

Enter

change the setting; on an entry, add a key to it

Esc q

back to the collection, keeping the changes not written

Changing

Keys

What they do

e

change the setting; on an entry, add a key to it

a

add a setting: key = value, or name.key = value

d

remove the setting, or the whole entry

w

write the file, its changes previewed

r

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

y

write it

n Esc

leave it: nothing is written

j k ↓ ↑

read a long question to its end

A list to choose from, as s, c, g or p open one:

Keys

What they do

j k ↓ ↑

move

Home End PgUp PgDn

first, last, a page

Space

in the sort, the columns and the groups, tick or untick

Shift+↑ Shift+↓ K J

in the sort, the columns and the groups, the item under the cursor up or down: its order

r

in the sort, the field under the cursor descending, or back, and ticked

/

narrow the list to what holds the letters typed

Tab

in p, the next group: scripts, figures, exports

w

in p, a figure to a file

Enter

accept

Esc

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