tucan studio

Docs / User guides

Browse topics
On this page

Editor & Tabs

Clicking a file in the folder tree opens it in the editor.

Tabs

Every open file gets a tab in the top bar. Click a tab to activate it; click the small x to close. Unsaved changes are marked with a modified indicator.

Saving

  • File -> Save -- writes the active tab's contents. Ctrl+S inside the editor does the same thing.
  • Amiga shortcut: right-Amiga + S.
  • File -> Save As... is handled by the editor that owns the tab. Extension editors that implement it get it; a plain text tab leaves the entry disabled.
  • An unmodified tab shows the Save item disabled.

Finding text

  • Ctrl+F opens the find bar under the editor. Type a query and press Enter to jump to the first match.
  • Ctrl+G repeats the last search. With no previous query it opens the find bar instead.
  • The status line reports Not found when a search fails.
  • Escape, or the X at the right of the bar, closes it.

While a search is active every occurrence on screen is highlighted, and the one you are currently on gets a different colour -- so stepping through a page of the same word tells you where you are. Closing the bar clears the highlighting, but the query survives: Ctrl+G keeps stepping without reopening it.

Markdown

.md files open with three view modes, in the File menu:

  • Edit -- plain text editor.
  • Preview -- rendered markdown.
  • Split -- editor on the left, preview on the right.

The mode is remembered per tab. Which one a markdown file opens in is the markdownDefaultView key in config/settings.json (default split) -- see the Settings topic.

Syntax highlighting

Tucan Studio ships highlighting for AmLang, C, JS, JSON, XML, HTML, Markdown and others. config/highlighting.json maps each file extension to the backend that colours it: a built-in tokenizer, a data-driven rules file, or an am-script tokenizer. Change an entry to switch backends without rebuilding.

Highlighting can be turned off entirely with the syntaxHighlightingEnabled key in config/settings.json, which is worth doing on a slow machine.

Language behaviour

Auto-indent, bracket pairing and comment continuation come from syntax/<language>.behaviour.json under the binary directory, one file per language, named by the language field in highlighting.json.

Selection and paging

Whether selecting text means holding Shift or toggling a select mode with Ctrl+B is a setting -- Settings -> Shortcuts. The same section decides whether Shift+Up/Down pages. See Settings.

Editors from extensions

An extension can claim a file type and open it in its own view instead of the text editor -- that is how the sprite editor opens .dss files. Installing such an extension is all it takes; the claim is in its manifest.

From the Tucan Studio documentation: assets/_default/help/editor.md