docs

De zijbalk

Vier secties, geordend naar wat dingen betekenen in plaats van waar ze vandaan komen: wat je open hebt, de plekken waar je bladert, de pull requests die je reviewt, en waar je bent geweest.

Geopende bestanden

De werkset: elk document dat je expliciet hebt geopend — vanuit de Finder, met slepen & neerzetten, ⌘O, de command line, of door een bestand uit een Locatie vast te houden. Plat, herordenbaar door te slepen, elke rij te verwijderen met de ✕ bij hover (of ⌫ op de geselecteerde rij). Rechtsklik op de sectiekop voor Sluit alles.

Previews

Eén klik op een bestand binnen een Locatie en het rendert direct — en verschijnt in Geopende bestanden als preview: één cursieve regel, altijd als laatste in de sectie. Klik op een ander bestand en de preview-regel wordt vervangen, dus bladeren door een grote boom stapelt nooit rijen op. Het is hetzelfde idee als de preview-tabs van VS Code of Xcodes tijdelijke editor, met dezelfde cursivering.

Een preview wordt een gewone, vastgezette regel zodra je meer betrokkenheid toont dan alleen lezen:

• Dubbelklik op het bestand in de boom, of op de cursieve regel zelf
• Begin te bewerken — Editmodus ingaan of een blokbewerking opslaan zet hem vast
• Houd open in het rechtsklikmenu

Leesinteracties — blame, regelgeschiedenis, een afbeelding of diagram inspecteren — promoveren een preview bewust nooit. Wil je liever dat elke klik bestanden volledig opent, zet dan Klikken op bestanden in Locaties om in de instellingen.

Remote repo's previewen op dezelfde manier, op dezelfde plek. Bladeren door de boom van een GitHub-repo, of links volgen binnen een remote document, zet dezelfde ene cursieve regel in Geopende bestanden — met een boekicoon en een tweede regel owner/repo @ ref, omdat het bestand niet op je Mac staat. Er is altijd maar één preview per venster, lokaal of remote: iets previewen vervangt wat je daarvoor aan het previewen was. Een remote doc vasthouden (dubbelklik of Houd open) is wat hem bij zijn repo archiveert — hij verhuist naar de vastgezette lijst van de repo onder Locaties. ⌘K opent direct vastgezet, want een URL plakken is expliciete intentie.

Elke rij in Geopende bestanden die binnen een open Locatie woont krijgt Toon in Locaties in zijn rechtsklikmenu — de sprong terug van "wat ik aan het lezen ben" naar "waar het woont".

Locaties

Doorbladerbare startpunten, waar ze ook wonen. Twee soorten delen de sectie, te onderscheiden aan het icoon:

Een lokale map die een git-checkout is krijgt een branch-chip (branch-teken + naam); staat haar remote op GitHub, dan verschijnt er ook een klein dichtgeslagen boekje — hover erover om te zien welke repo. Klikken op de branch-chip opent het branches-en-worktrees-menu:

• Worktrees — elke worktree van de repo, met een vinkje op degene die deze rij is; kies een andere om die als eigen Locatie te openen. Worktrees worden vanuit PullMark nooit uitgecheckt of omgeschakeld — de app opent de map die er al staat.
• Bekijk branch van GitHub — lees de bestanden van een andere branch op afstand, zonder je checkout aan te raken. Een branch die al een lokale worktree heeft springt in plaats daarvan naar de worktree — lokaal wint van remote.
• Open op GitHub — de repo (op deze branch) in je browser.

Op een remote repo (boekicoon) toont dezelfde chip branches: Wissel naar pint de sessie opnieuw vast op een andere branch, en met ⌥ ingedrukt verschijnt Open branch apart om zij aan zij te lezen. Blader door repo-bestanden… laadt de hele Markdown-boom van de repo. De vastgehouden docs van de repo staan boven de boom, zodat ze nooit verdrinken onder een grote repo; een vastgehouden doc die in de boom zichtbaar is wordt daar gewoon weergegeven. (Een doc die je alleen aan het previewen bent staat in Geopende bestanden, niet hier.)

Een map waarvan het pad niet meer oplost (een niet-geactiveerd volume, een verwijderde worktree) dimt met een vraagtekenbadge in plaats van te verdwijnen — ze herleeft vanzelf wanneer het pad terugkeert.

Pull requests

Elke geopende PR is een groep: de overzichtsrij (statusicoon + aantal gewijzigde Markdown-bestanden), dan de gewijzigde Markdown-bestanden — een tekstballonnetje met teller markeert bestanden met onopgeloste reviewthreads. Onder je geopende PR's verzamelt Reviewverzoeken de PR's die op jouw review wachten, met een ongelezen-teller die ook ingeklapt zichtbaar blijft (te verbergen in de instellingen, en te filteren tot alleen PR's die Markdown raken).

Statusiconen op PR-rijen:

Markeringen per bestand binnen een PR: + in cirkel (groen) voor toegevoegd, − in cirkel (rood) voor verwijderd, → in cirkel voor hernoemd, potlood in cirkel voor gewijzigd.

Recent

Recent geopende bestanden, mappen en pull requests die hierboven niet al zichtbaar zijn. PR-regels dragen hun live statusicoon; een recent item waarvan het bestand zoek is dimt (klokbadge) in plaats van te verdwijnen en herleeft wanneer het pad terugkeert — gebouwd voor branchwissels en niet-geactiveerde volumes. Rechtsklik op de kop voor Wis recente onderdelen.

Dingen verwijderen

Hover over een rij op het hoogste niveau voor de ✕ — die haalt de rij uit de zijbalk, nooit iets van schijf of van GitHub. ⌫ op een geselecteerde rij doet hetzelfde. Bestanden binnen de boom van een Locatie hebben geen ✕: ze zijn de inhoud van een plek, geen zijbalkitems.

Icoonoverzicht

Het branch-teken verschijnt alleen op echte git-refs (chips, nooit als mapicoon) — een map is een map, een repo is een boek, een branch is een branch.