What is a Workspace

A Workspace is a real folder that you add to the Resomark sidebar. Resomark doesn't copy it or change its structure; it only remembers where it is. A Workspace is also a scope: search, backlinks, tracked changes and Workspace History all work one Workspace at a time. You can have as many Workspaces as you like, and adding and grouping them is free.

You can open a single file without adding anything, for example by double-clicking it in Finder. The sidebar then shows the folder it's in, as a Temporary Location: there are no backlinks, changes aren't tracked, and the sidebar forgets it once you close it. To use a folder for the long run, add it as a Workspace; the Temporary Location page has an Add as Workspace button.

• Choose File > Add Workspace…, or use the add button on the Workspaces section of the sidebar's Home page.
• Drag folders from Finder onto the Workspaces list on the Home page. Dragging one folder opens the add window first; dragging several adds them all right away.

The add window tells you whether the folder is a Git repository; if it isn't, there's a Track Changes switch. That decides which kind of Workspace it is; see Kinds of Workspace. A folder that's already in the sidebar can't be added twice.

From top to bottom, the Home page has:

• Favorites: files you've added to Favorites, shown only when there are some. See Favorites.
• Unsaved Files: new documents that haven't been saved to disk yet, shown only when there are some.
• Workspaces: all your Workspaces, each with its Pinned Folders indented below it.

Click a Workspace and the sidebar switches to its folder page: Changes at the top (only when something changed), then Favorites and Pinned Folders, and All Files at the bottom. Click Back to Home at the top to come back.

Groups: when you have many Workspaces, you can group them. Use New Group… on the Workspaces section of the Home page, or right-click a Workspace and choose Move to > New Group…. You can also drag Workspaces to reorder them. Groups only change the order in the sidebar; they don't move folders on disk.

• Settings: right-click a Workspace and choose Workspace Settings… to turn Track Changes on or off.
• Remove: right-click and choose Remove Workspace. This only takes it out of the sidebar; the folder and files on disk aren't touched. If it has Pinned Folders, you're asked whether to keep them or remove them too.

If a Workspace's folder is moved to the Trash or deleted, its row stays in the sidebar with Missing after the name. Right-click it for two choices:

• Relocate…: choose the folder again. If you pick the same folder (even if it has moved), its Workspace History continues. If you pick a different folder, a new history starts from scratch, and the old one is kept.
• Remove Workspace.

Workspaces on an external drive that isn't plugged in stay in the sidebar as usual, and work again once you plug it in.

Once you add a file to Favorites or pin a folder, a .resomark folder appears at the top level of the Workspace, recording your Favorites and Pinned Folders. It travels with the folder, so it's still there when you open the folder on another Mac. It contains its own .gitignore, so Git won't commit it. See Where are your files, and are they uploaded?.

• Kinds of Workspace
• Work with your AI