docs

De zijbalk

Secties, geordend naar wat dingen betekenen in plaats van waar ze vandaan komen: wat je open hebt, de plekken die je bewaart, de plekken waar je bladert, de pull requests en issues waarbij je betrokken bent, 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".

Vastgezet

De mappen en bestanden waar je steeds naar teruggaat, boven Locaties — zoals de Finder Favorieten boven al het andere houdt. Rechtsklik op een map of bestand in een willekeurige boom en kies Vastzetten…: een map wordt haar eigen startpunt met een eigen boom, een bestand wordt een bladwijzerregel die bij een klik previewt, en het nieuwe item landt onderaan de sectie, meteen in de naam-wijzigen-modus. Een Locatie-startpunt krijgt Vastzetten (het verhuist hierheen) en een vastgezet startpunt krijgt Losmaken (het verhuist naar onderaan Locaties, met behoud van zijn naam).

Naam wijzigen werkt zoals in de Finder: kies Naam wijzigen… of druk op Return op de geselecteerde rij, typ, en Return, ergens anders klikken, of verdergaan bevestigt het; Esc annuleert; een leeggemaakt veld gaat terug naar de echte naam. Een hernoemd item toont zijn werkelijke pad in kleine tekst onder de naam, net als elk paar startpunten dat dezelfde naam deelt, zodat twee mappen die docs heten er nooit hetzelfde uitzien. Vastgezette items zijn een voorkeur, geen deel van de sessie: ze komen terug bij elke start, wat Vorige sessie bij het starten opnieuw openen ook zegt.

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 komen de pull requests waarbij je betrokken bent, in groepen: Reviewverzoeken, Aangemaakt, Toegewezen en Betrokken (je hebt gereageerd, gereviewd of bent genoemd). Lege groepen blijven verborgen, concepten tonen · concept, en een rij legt uit waarom hij er staat (· toegewezen, · genoemd) wanneer de groep alleen dat niet al duidelijk maakt. Elke groep laadt de 30 meest recent bijgewerkte en eindigt in Meer tonen…. Ongelezen-tellers blijven zichtbaar op ingeklapte koppen; het geheel is optioneel in Instellingen, en te filteren tot PR's die Markdown raken.

Volg een repository om alles te zien wat erin open staat, nieuwste eerst: Repository volgen… in de sectiekop biedt de repositories die je al open hebt, of neemt een getypte owner/repo aan. Een gevolgde repository is haar eigen groep met haar eigen ongelezen-regel — rechtsklik erop voor Alles, Alleen de mijne of Geen, en voor Ontvolgen. Elke afzonderlijke PR- of issue-rij kan die regel overschrijven vanuit haar eigen rechtsklikmenu.

Liever één lijst? GitHub-werk groeperen op Betrokkenheid voegt deze sectie en Issues samen tot één sectie GitHub, met groepen die beide soorten mengen en een glyph per rij.

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.

Issues

Hetzelfde idee voor issues — Aangemaakt, Toegewezen, Betrokken, en de issues van gevolgde repositories — omdat het document dat je wordt gevraagd te reviewen vaak een issue is, geen pull request. Klik op een issue en hij opent als document: de gerenderde inhoud, de labels, de commenttijdlijn met reacties, en een commentaarvak aan het einde. Plaats een comment, geef een reactie, en bewerk of verwijder je eigen comments zonder de app te verlaten. Een open issue staat bovenaan de sectie als losse rij, komt in Recent en ⌘K Open snel terecht, en komt terug met de sessie.

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.