VERSOFOLD 0.4.1 · HANDBOOK

Keyboard shortcuts & glossary

A quick reference for controls and the terms used throughout the app.

← All guidesRead as Markdown ↓

On a Mac the tables show Command and Option shortcuts. On Linux and Windows the app shows the same shortcuts with Ctrl and Alt. Some native desktop commands are unavailable in a browser window.

Workspace shortcuts

ShortcutAction
⌘KSearch tools, views, actions and files in the command palette.
⌘PFind a file.
⌘EnterCompile the selected document root.
⌘SSave immediately; source also autosaves.
⌘FSearch the active source editor.
⌘ShiftFSearch the project.
⌘ShiftMComment on the source selection.
⌘ShiftRReview tracked changes (the Changes tab).
⌘ShiftAOpen or close the agent's column.
⌘ShiftETrack changes on or off for your edits.
⌘Option] / ⌘Option[In the LaTeX editor: next / previous tracked change, with its card.
⌘ShiftHOpen versions/history.
⌘ShiftTDeadlines, tasks and reviews.
⌘ShiftISnippets and wrappers.
ControlSpaceExpand a template shortcut in the editor.
⌘JBuild log/problems.
⌘ShiftJShow the cursor position in the PDF (Show in PDF).
⌘BToggle file-tree visibility.
⌘Option OOpen the view you are working in in its own window; in a view's own window, return it to the main window.
⌘WClose the active tab where the editor handles it.
⌘,Settings.
Double-click PDF textJump to source when SyncTeX is available.
Double-click sourceShow the corresponding PDF location when the PDF is on screen.
Enter / ⌘Enter, ← →, EscIn a reference review: confirm, move to the previous or next record, close the review.

Use ordinary Undo/Redo for source edits. Conversation Undo/Redo changes the active conversation boundary and does not undo manuscript files.

In the Response view

While you write an answer to a reviewer, the formatting bar's shortcuts belong to the answer (so ⌘B makes text bold there instead of toggling the sidebar).

ShortcutAction
⌘B / ⌘IBold / italic.
⌘EInline code.
⌘ShiftKLink (⌘K stays the command palette).
⌘Shift8 / ⌘Shift7Bulleted / numbered list.
⌘Shift.Quote.
Control-MInline equation, $…$ (Ctrl+M on Linux and Windows; ⌘M stays the Mac's Minimize).
Control-Shift-MDisplay equation, $…$ on lines of their own.
EnterIn a list item or quote, start the next one; in an empty item, end the list.

Documentation and accessibility

Desktop Help → VersoFold Documentation also uses F1. In the handbook, ⌘K focuses search, Tab moves among controls, Enter activates the focused item, and Escape closes the handbook. Closing returns you to the underlying workspace.

The handbook provides category colors as an additional cue; headings and labels also identify every category. A contents rail appears in wide windows, while narrow layouts retain chapter navigation and search. Code examples have Copy controls, and tables scroll when necessary.

Focus a pane divider and use arrows to resize where supported. Split's divider also offers Home to reset its proportions. Reduced-motion preferences affect decorative effects and supported exported web-edition motion.

Document and writing terms

TermMeaning
WorkspaceA saved project pointing to a folder and its associated app records.
SourceThe editable .tex, .bib and supporting files used to build a paper.
Root / entryThe complete LaTeX document selected for compilation.
PreambleCommands before \begin{document}, including packages and definitions.
PackageA LaTeX extension loaded with \usepackage.
EnvironmentContent enclosed by matching \begin and \end.
FloatA figure/table whose placement is chosen by LaTeX within requested constraints.
LabelA unique key used to refer to a numbered object.
Citation keyAn identifier connecting a citation command to a bibliography record.
SyncTeXBuild metadata mapping PDF locations to LaTeX source.
Build artifactOutput/intermediate files produced by compilation or generation.

Review and data terms

TermMeaning
Snapshot / checkpointA preserved source state used for comparison or recovery.
Named versionAn intentional manuscript milestone, optionally with a matching PDF.
BaselineThe source state against which changes are compared.
Tracked changeAn insertion or deletion recorded with its author, pending until someone accepts or rejects it; the file already holds it (insertions in, deletions out).
Live editA change already applied to working source.
Staged proposalA proposed source state awaiting author acceptance.
StaleA result/preview no longer known to match current inputs.
FingerprintA content identity used to detect changed source/data.
ProvenanceRecorded origins, transformations and evidence behind an output.
RecipeA declarative Figure Studio design and data-processing specification.
Publish table/figureGenerate manuscript assets from a saved draft/recipe.
FreezePin a source, asset or version to preserve a chosen state.
Evidence assessmentA recorded interpretation of inspected sources, separate from metadata checking.

Agent and sharing terms

TermMeaning
ContextMaterial supplied to a conversation or read by its tools.
DiscussA conversation mode primarily for reading and analysis.
EditA mode enabling authorized guarded changes.
GrantExplicit access to a scope/capability; separate from per-action approval.
MCPA protocol through which an external agent discovers and invokes app tools.
CompactionA continuation summary for long context while local history is retained.
Review invitationAccess to a shared workspace under a role and grants.
Offline review fileA self-contained exported reader for feedback returned later.

Phases, rebuttals and editions

TermMeaning
PhaseWhere the paper is in its life (Drafting to Published); it arranges the side panel and the tools in view, and locks nothing.
Submitted versionThe version saved by Mark as submitted; changes since submission are measured against it.
Response viewThe rebuttal as the reviewers' comments with your answers under them: the file rebuttal/response.md.
Follow-upA reviewer's later comment in the discussion, answered under the point it replies to.
Marked PDFA latexdiff build of the paper with every change since submission coloured.
EditionOne form of the paper built from the same source: the paper, the preprint, the supplementary material, or a copy.
Edition mark\ifpreprint … \fi and its kin: text only some editions print.
Edition viewThe LaTeX and PDF as one edition prints them; what it leaves out folds away.

Related: navigation, agent, troubleshooting.

← Browse the handbookGet VersoFold →