Pinned Folders
A Pinned Folder is a shortcut to a subfolder you visit often in a Workspace. On the folder page, right-click a subfolder and choose Pin Folder; it appears under its Workspace on the sidebar's Home page, so you can go straight there from then on. It's only a shortcut, not a new Workspace. Pinning is free.
Pin and unpin
Section titled “Pin and unpin”- Find the subfolder on the folder page. Hover over it and click the pin, or right-click it and choose Pin Folder.
- It opens right away, and also appears on the Home page under the Workspace it belongs to.
In ⌘P search, you can also select a folder, press ⌘K and choose Pin Folder.
To remove it, right-click and choose Unpin Folder. Only the shortcut goes away; the folder itself isn't touched.
Where they appear
Section titled “Where they appear”- Home page: indented under the Workspace they belong to. The Home page goes two levels deep at most: if you pin a folder inside a Pinned Folder, it's listed at the same level.
- The Workspace's folder page: has a Pinned Folders section listing all of this Workspace's pins.
- Click a Pinned Folder and the sidebar switches to its folder page, with that folder as the big title.
A pin isn't a separate scope
Section titled “A pin isn't a separate scope”- Search, backlinks and Track Changes still cover the whole Workspace it belongs to.
- On a Pinned Folder's page, Changes and Workspace History list only what's inside this folder.
- If you add a save point on a Pinned Folder's page, only this folder's unreviewed changes are kept, but the save point records the whole Workspace as it is at that moment. See Workspace History.
Adding a folder can make it a pin
Section titled “Adding a folder can make it a pin”- If you add a subfolder of an existing Workspace, it becomes a Pinned Folder of that Workspace instead of a second Workspace.
- If you add a parent folder of an existing Workspace, the parent becomes the Workspace and the original one becomes its Pinned Folder.
- When you remove a Workspace that has Pinned Folders, Resomark asks whether to keep them or remove them too. The ones you keep move under the nearest parent Workspace, or become Workspaces of their own if there isn't one.
Pins stay with the folder
Section titled “Pins stay with the folder”Like Favorites, pins are recorded in the Workspace's .resomark folder: if the folder moves or you open it on another Mac, your pins are still there. Several worktrees of the same Git repository share one set of pins; switching worktrees on a Pinned Folder's page takes you to the folder at the same place in the other worktree.
How they differ from Favorites
Section titled “How they differ from Favorites”| Favorites | Pinned Folders | |
|---|---|---|
| What they hold | Files | Folders |
| Where on the Home page | The Favorites section | Under their Workspace |
| What clicking does | Opens the file | Switches the sidebar to the folder |