The tern binary includes a terminal profile
manager for creating and editing local profiles and browsing pipelines.
It opens with tern -p, or with plain tern when
the project has no profiles yet.
| Tab | Content |
|---|---|
| Converters | Profile list: create, edit and delete local profiles; template profiles are read-only |
| Pipelines | Pipelines with their stages and items, read-only |
The status bar shows the keys available in the current context.
| Key | Context | Action |
|---|---|---|
j / Down, k /
Up |
Browsing | Move the selection |
Left / Right |
Browsing | Switch tabs |
n |
Converters | Create a profile |
Enter |
Converters | Edit the selected profile |
d |
Converters | Delete the selected profile |
q |
Anywhere | Quit |
Tab / Shift+Tab |
Form | Next / previous field |
Ctrl+Enter / Ctrl+J |
Form, multi-line fields | Insert a newline |
Enter |
Form | Save |
Esc |
Form | Cancel |
y |
Confirmation | Confirm |
n / Esc |
Confirmation | Cancel |
| Field | Content |
|---|---|
| Name | Unique profile name |
| Engine | Converter file name, e.g. pandoc.lua |
| Origin | local (default) or global, reference Converters |
| Source Root | Directory scanned for sources |
| Source Extension | Extension of the sources, e.g. md |
| Output Root | Directory the outputs go to |
| Output Extension | Extension of the outputs, e.g. html |
| Options | One option per line |
| Ignore Patterns | One gitignore pattern per line |
Reference Database for what each field means to a run.
Template profiles are marked [tpl] and cannot be edited
or deleted here: tern -u recomputes them from the
template’s manifest and the overrides in .tern/config.toml,
so a change made in the TUI would be discarded on the next update.
Trying shows a notice naming the owning template. Template profiles
change through their override block in .tern/config.toml,
and go away when their [[templates]] entry is removed.
Deleting a profile that a pipeline stage references asks for confirmation and lists those pipelines and stages. Confirming removes the profile, the stage items that reference it, stages left empty and pipelines left without stages.