docs
De toolbar
Eén toolbar per soort weergave, elk volledig aanpasbaar: klik er met rechts op (of Weergave → Pas toolbar aan…) en sleep items eruit, herschik ze, voeg toe wat verborgen begint. Elke weergave onthoudt haar eigen indeling tussen sessies.
Hoe aanpassen werkt
PullMark heeft niet één toolbar — het heeft er één per soort weergave, zoals het opstelvenster van Mail een andere toolbar houdt dan zijn hoofdvenster. Je past de toolbar aan waar je naar kijkt: open een pull request-bestand om de PR-bestandstoolbar aan te passen, een lokaal document voor de toolbar van lokale bestanden. Het palet biedt alleen de items aan die bestaan waar je het opende.
Alles in het palet mag: verwijderen, herordenen, Flexibele ruimte erin om clusters uit elkaar te duwen. Items die hieronder als verborgen staan beginnen in het palet in plaats van in de balk. De ene plek waar items niet heen gaan is de eigen strook van de zijbalk naast de zijbalkschakelaar: die sectie is van het systeem, en wat je daar loslaat belandt vooraan in de hoofdsectie. Herstel elke toolbar door de standaardset vanaf de onderkant van het palet terug te slepen.
In elke weergave
| Item | Standaard | Wat het doet |
|---|---|---|
| Terug/Vooruit | zichtbaar | Terug en vooruit door alle bekeken documenten — houd een van de pijlen ingedrukt voor de geschiedenis. |
| Review | zichtbaar | De meebewegende reviewknop, alleen in PR-weergaven — teller van openstaande comments, oordeel, indienen. Overleeft een smal venster het langst: de reviewstatus blijft zichtbaar wanneer andere items in het overloopmenu verdwijnen. |
| Open bestand of map | zichtbaar | Open lokale Markdown of een map als Locatie. |
| Open pull request | zichtbaar | Open een GitHub-pull request via een URL. |
| Weergave | zichtbaar | Licht · Donker · Systeem, voor de hele app. |
Lokale bestanden
| Item | Standaard | Wat het doet |
|---|---|---|
| Deel | zichtbaar | Het standaard deelpaneel voor het bestand. |
| Bewerk | zichtbaar | Editmodus — klik op een blok om het ter plekke te bewerken. |
| Vergelijk | zichtbaar | Vergelijk met een commit of branch (vereist een git-repository). Een kleine stip betekent dat het bestand niet-gecommitte wijzigingen heeft. |
| Blame | zichtbaar | Wie elk blok het laatst wijzigde; uitgeschakeld buiten een repository. |
| Outline | zichtbaar | De koppenzijbalk. |
| Herlaad | zichtbaar | Lees het bestand opnieuw van schijf. |
| Bron | verborgen | De ruwe Markdown achter de gerenderde pagina. |
| Zoom in · Werkelijke grootte · Zoom uit | verborgen | Aparte items — voeg alleen het paar toe dat je gebruikt. |
| Tekstbreedte | verborgen | Standard · Wide · Full Width. |
| Voeg margin note toe | verborgen | Alleen in het palet zolang margin notes aanstaan. |
GitHub-documenten
Documenten die rechtstreeks uit een repo worden gelezen — geopend via links, ⌘K of een doorbladerde repo-Locatie.
| Item | Standaard | Wat het doet |
|---|---|---|
| Vergelijk | zichtbaar | Hetzelfde document op een andere branch, als gerenderde diff. |
| Blame | zichtbaar | Blame per blok via de GitHub-API. |
| Outline | zichtbaar | De koppenzijbalk. |
| Deel | verborgen | De github.com-pagina van het document — de link die iemand echt wil, nooit een ruwe URL. |
| Herlaad | verborgen | Lost de branch opnieuw op naar zijn huidige punt en haalt opnieuw op. Uitgeschakeld — mét de reden — voor documenten die op een specifieke commit zijn geopend en dus niet kunnen veranderen. |
| Bron | verborgen | De ruwe Markdown. |
| Zoom-items · Tekstbreedte | verborgen | Zoals bij lokale bestanden. |
Pull request-bestanden
| Item | Standaard | Wat het doet |
|---|---|---|
| PR-navigatie | zichtbaar | Terug naar het overzicht, vorig/volgend Markdown-bestand, en het n-van-m-springmenu — één cluster, één sleepbaar geheel. |
| Weergave | zichtbaar | Gerenderde diff · Bron-diff · Resultaat, gecentreerd. |
| Outline | zichtbaar | De koppenzijbalk. |
| Indeling | zichtbaar | Inline of side-by-side — actief in de Gerenderde diff-weergave (nieuwe bestanden renderen altijd inline). |
| Blame | zichtbaar | Actief in de Resultaat-weergave, waar een afgerond document te annoteren valt. |
| Reageer op bestand | zichtbaar | Een comment op het bestand als geheel, niet op een specifieke regel. |
| Zoom-items · Tekstbreedte | verborgen | Zoals bij lokale bestanden. |
Het PR-overzicht, en repodocs geopend vanuit een PR
Het overzicht houdt het minimaal: Deel (de GitHub-pagina van de pull request) plus de items van elke weergave. Een repodocument dat je vanuit PR-inhoud doorbladert draagt Blame en Outline, met de zoom-items en Tekstbreedte in zijn palet.