docs

Die Toolbar

Eine Toolbar pro Art von Ansicht, jede voll anpassbar: Rechtsklick darauf (oder Darstellung → Symbolleiste anpassen…), zieh Elemente raus, ordne sie neu, hol dazu, was versteckt startet. Jede Ansicht merkt sich ihre eigene Anordnung über Starts hinweg.

Wie das Anpassen funktioniert

PullMark hat nicht eine Toolbar — es hat eine pro Art von Ansicht, so wie das Verfassen-Fenster von Mail eine andere Toolbar behält als sein Hauptfenster. Du passt die Toolbar an, die du gerade vor dir hast: Öffne eine Pull-Request-Datei, um die PR-Datei-Toolbar anzupassen, ein lokales Dokument für die Toolbar lokaler Dateien. Die Palette bietet immer nur die Elemente an, die es dort gibt, wo du sie geöffnet hast.

Alles in der Palette ist verhandelbar — raus damit, umsortieren, Flexibler Zwischenraum dazwischen, um Gruppen auseinanderzuschieben. Elemente, die unten als versteckt markiert sind, starten in der Palette statt in der Leiste. Der einzige Ort, an den nichts wandert, ist der eigene Streifen der Seitenleiste neben dem Seitenleisten-Schalter: Dieser Bereich gehört dem System, und was du dort fallen lässt, landet stattdessen vorn im Hauptbereich. Jede Toolbar stellst du wieder her, indem du den Standardsatz vom unteren Rand der Palette zurückziehst.

In jeder Ansicht

Element	Standard	Was es tut
Zurück/Vorwärts	sichtbar	Zurück und vorwärts durch alle angesehenen Dokumente — halte einen der Pfeile gedrückt für seinen Verlauf.
Review	sichtbar	Das mitwachsende Review-Element, nur in PR-Ansichten — Zahl der ausstehenden Kommentare, Urteil, Absenden. Übersteht ein schmales Fenster am längsten: Der Review-Status bleibt sichtbar, wenn andere Elemente ins Overflow-Menü rutschen.
Datei oder Ordner öffnen	sichtbar	Lokales Markdown oder einen Ordner als Ort öffnen.
Pull Request öffnen	sichtbar	Einen GitHub-Pull-Request per URL öffnen.
Erscheinungsbild	sichtbar	Hell · Dunkel · System, für die ganze App.

Lokale Dateien

Element	Standard	Was es tut
Teilen	sichtbar	Das übliche Share-Sheet für die Datei.
Bearbeiten	sichtbar	Der Bearbeitungsmodus — klick einen beliebigen Block, um ihn an Ort und Stelle zu bearbeiten.
Vergleichen	sichtbar	Mit einem Commit oder Branch vergleichen (braucht ein Git-Repository). Ein kleiner Punkt heißt: Die Datei hat uncommittete Änderungen.
Blame	sichtbar	Wer jeden Block zuletzt geändert hat; außerhalb eines Repositorys deaktiviert.
Gliederung	sichtbar	Die Gliederungs-Seitenleiste.
Neu laden	sichtbar	Die Datei neu von der Platte lesen.
Quelltext	versteckt	Das rohe Markdown hinter der gerenderten Seite.
Einzoomen · Tatsächliche Größe · Auszoomen	versteckt	Einzelne Elemente — nimm nur das Paar, das du wirklich benutzt.
Inhaltsbreite	versteckt	Standard · Wide · Full Width.
Randnotiz hinzufügen	versteckt	Nur in der Palette, solange Randnotizen eingeschaltet sind.

GitHub-Dokumente

Dokumente, die direkt aus einem Repo gelesen werden — geöffnet über Links, ⌘K oder ein durchstöbertes Repo unter „Orte“.

Element	Standard	Was es tut
Vergleichen	sichtbar	Dasselbe Dokument auf einem anderen Branch, als gerendertes Diff.
Blame	sichtbar	Blame pro Block, aus der GitHub-API.
Gliederung	sichtbar	Die Gliederungs-Seitenleiste.
Teilen	versteckt	Die github.com-Seite des Dokuments — der Link, den ein Mensch wirklich will, nie eine rohe URL.
Neu laden	versteckt	Löst den Branch neu auf seine aktuelle Spitze auf und lädt neu. Deaktiviert — mit Begründung — für Dokumente, die an einem bestimmten Commit geöffnet wurden und sich gar nicht ändern können.
Quelltext	versteckt	Das rohe Markdown.
Zoom-Elemente · Inhaltsbreite	versteckt	Wie bei lokalen Dateien.

Pull-Request-Dateien

Element	Standard	Was es tut
PR-Navigation	sichtbar	Zurück zur Übersicht, vorherige/nächste Markdown-Datei und das n-von-m-Sprungmenü — eine Gruppe, eine ziehbare Einheit.
Darstellung	sichtbar	Gerendertes Diff · Quelltext-Diff · Ergebnis, zentriert.
Gliederung	sichtbar	Die Gliederungs-Seitenleiste.
Layout	sichtbar	Inline oder nebeneinander — aktiv in der Ansicht „Gerendertes Diff“ (neue Dateien rendern immer inline).
Blame	sichtbar	Aktiv in der Ergebnis-Ansicht, wo es ein fertiges Dokument zum Annotieren gibt.
Datei kommentieren	sichtbar	Ein Kommentar zur Datei als Ganzes, nicht zu einer bestimmten Zeile.
Zoom-Elemente · Inhaltsbreite	versteckt	Wie bei lokalen Dateien.

Die PR-Übersicht — und Repo-Docs, die du aus einem PR heraus öffnest

Die Übersicht hält es knapp: Teilen (die GitHub-Seite des Pull Requests) plus die Elemente, die es in jeder Ansicht gibt. Ein Repo-Dokument, das du aus PR-Inhalten heraus durchstöberst, trägt Blame und Gliederung, mit den Zoom-Elementen und der Inhaltsbreite in seiner Palette.