Projekt
FreeDas Werkzeugfenster Projekt (⌘1) ist der Dateibaum des Editors. Hier öffnest du einen Ordner als Projekt, siehst alle Dateien mit ihrem Git-Status, legst neue an, benennst um, verschiebst per Ziehen und startest Terminal oder Claude direkt im passenden Ordner. Mehrere Ordner lassen sich zu einer Zusammenstellung verbinden, und einzelne Unterordner zeigst du als eigenes Unterprojekt.
Was du hier machst
- Der Baum: Projekt öffnen, Ordner anhängen, Kopfleiste, Anzeigen und Tastatur
- Unterprojekte: einen Unterordner als eigenes Projekt zeigen, auch in Mission Control
- Neue Datei: neue Dateien mit passendem Dateityp anlegen, auch Word und Excel
- Das Menü: alles, was der Rechtsklick auf Dateien und Ordner bietet
- Ziehen: verschieben, kopieren, in Codefläche, Terminal, Claude oder auf einen Server ablegen
- Mehrfachauswahl: viele Einträge auf einmal bearbeiten
- Repository klonen: ein Git-Repository von einer Adresse, aus einem lokalen Repository oder von GitHub holen
Aufbau der Seite
- Kopfleiste je Ordner: Für das Projekt, für jeden angehängten Ordner und für jedes Unterprojekt gibt es eine eigene Leiste mit Name, Git-Branch und Knöpfen. Ein Klick auf die Leiste klappt den Ordner auf oder zu.
- Baum: die Dateien und Ordner darunter, mit Symbolen nach Dateityp, Git-Farben und auf Wunsch der Zeit der letzten Änderung.
- Griff zwischen zwei Ordnern: Sind mehrere Ordner aufgeklappt, teilst du die Höhe per Ziehen auf.
Ist noch kein Projekt offen, zeigt das Fenster Kein Projekt geöffnet und den Knopf Ordner öffnen …. Weitere Wege zum Projekt sind ⌘O, das Projektmenü in der Titelleiste, Datei ▸ Zuletzt geöffnet und der Startbildschirm. Mit WebDonkey zeigt der Startbildschirm auch deine Sites.
Free und Premium
Der Projektbaum ist vollständig frei, auch Unterprojekte, Klonen und das Anlegen von Word- und Excel-Dateien. Nur die Einträge, die einen Ordner mit einem Server verbinden (Mappings, Hochladen, Vergleichen), gehören zu Premium, siehe Mappings und Sync.
Der Baum Free
Der Projektbaum zeigt den Ordner deines Projekts mit allen Unterordnern und Dateien. Du öffnest Dateien, klappst Ordner auf, siehst auf einen Blick, was Git geändert sieht, und arbeitest fast alles mit der Tastatur ab. Hängst du weitere Ordner an, bekommt jeder seinen eigenen Baum im selben Fenster.
So findest du es
- ⌘1 blendet das Fenster Projekt ein und aus. Ab Werk liegt es oben links.
- Das Symbol Projekt in der linken Leiste macht dasselbe.
So gehst du vor
Projekt öffnen
- Drücke ⌘O oder klicke im leeren Fenster auf Ordner öffnen ….
- Wähle den Ordner im Finder-Dialog.
- Ist in diesem Fenster schon ein Projekt offen, fragt der Editor, wo der Ordner hin soll:
- Neues Fenster (Vorgabe): Das offene Projekt bleibt, wo es ist, der Ordner öffnet in einem eigenen Fenster.
- Dieses Fenster: Der Ordner ersetzt das offene Projekt. Ungespeicherte Dateien fragt der Editor vorher ab.
- Anhängen: Der Ordner kommt als weiterer Ordner in dieses Fenster (siehe unten).
- Abbrechen
Ist ein Ordner schon in einem anderen Fenster offen, holt der Editor dieses Fenster nach vorn, statt ihn ein zweites Mal zu öffnen. Zuletzt geöffnete Projekte findest du unter Datei ▸ Zuletzt geöffnet, im Projektmenü und auf dem Startbildschirm.
Datei öffnen
Ein Klick auf eine Datei öffnet sie als Tab, ein Klick auf einen Ordner klappt ihn auf oder zu. Mit der Tastatur geht beides mit ↩. Wo die Datei in einer Teilung landen soll, steuerst du über Daneben öffnen im Menü oder per Ziehen.
Ordner anhängen
Mit Anhängen nimmst du weitere Ordner in dieselbe Zusammenstellung auf, zum Beispiel ein Plugin neben dem Shop. Jeder Ordner bekommt eine eigene Kopfleiste mit eigenem Baum. Die Kopfleiste eines angehängten Ordners hat ein X (Vom Projekt lösen). Der Editor fragt vorher nach und entfernt den Ordner nur aus der Zusammenstellung, auf der Platte wird nichts gelöscht. Im Projektmenü gibst du der Zusammenstellung mit Zusammenstellung umbenennen … einen eigenen Namen.
Projekt schließen
Datei ▸ Projekt schließen fragt „Projekt „Name“ schließen?“. Leere Terminals schließt der Editor dabei. Programme, die in einem Terminal noch laufen, laufen weiter und sind wieder da, wenn du das Projekt das nächste Mal öffnest.
Die Kopfleiste
Jeder Ordner im Fenster hat eine Leiste. Sie zeigt:
- einen Pfeil zum Auf- und Zuklappen. Ein Klick irgendwo auf die Leiste klappt ebenfalls.
- den Namen des Ordners. Fährst du darüber, zeigt der Tooltip den ganzen Pfad.
- bei einem Git-Repository den Branch (⎇) mit ↓ (Commits zum Pullen), ↑ (Commits zum Pushen) und der Zahl der geänderten Dateien. ∅ heißt: nichts zu tun.
- ein farbiges Zeichen, wenn der Ordner einem Server zugeordnet ist (Mappings).
Die Knöpfe der Leiste des Hauptprojekts, solange es aufgeklappt ist:
| Knopf | Wirkung |
|---|---|
| Neue Datei | öffnet die Liste der Dateitypen, siehe Neue Datei |
| Neuer Ordner | legt eine neue Zeile für einen Ordnernamen an |
| Aktive Datei zeigen | springt im Baum zur Datei des aktiven Tabs |
| Alles einklappen | klappt alle Ordner zu |
| Versteckte Dateien ausblenden / Versteckte Dateien zeigen | blendet Dateien und Ordner mit Punkt am Anfang (.env, .git) aus oder ein. Ab Werk sind sie sichtbar. |
| Aktualisieren | liest den Baum und den Git-Status neu |
Angehängte Ordner haben Aktualisieren und Vom Projekt lösen, Unterprojekte Aktualisieren und Unterprojekt entfernen. Neue Dateien legst du dort über das Kontextmenü an. Wird die Leiste schmal, zeigt sie den Branch nur noch als Symbol und packt die Knöpfe in das Menü Weitere Aktionen (…). Der Name bleibt immer lesbar.
Mehrere Ordner untereinander
Sind mehrere Ordner aufgeklappt, teilen sie sich die Höhe des Fensters. Zwischen zwei aufgeklappten Ordnern liegt ein Griff:
- Ziehen verschiebt die Grenze. Sie rastet bei ¼, ⅓, ½, ⅔ und ¾ ein. Jeder Ordner behält mindestens seine Leiste und zwei Zeilen.
- Doppelklick teilt die beiden wieder gleich.
Welche Ordner zugeklappt sind und wie hoch jeder ist, merkt sich der Editor je Projekt, auch über einen Neustart.
Was die Zeilen zeigen
- Symbole nach Dateityp. Ein Ordner, der selbst ein Git-Repository ist, trägt ein kleines Branch-Zeichen und seinen eigenen Branch-Hinweis.
- Git-Farben am Namen: geändert und umbenannt in der Akzentfarbe, neu im Index grün, gelöscht und Konflikte rot, nicht versionierte Dateien in der Warnfarbe. Ordner mit Änderungen darin sind ebenfalls eingefärbt.
- Von .gitignore ausgeschlossen: Was
.gitignoreausschließt, hat einen grauen Namen und eine dezente Hinterlegung, der Tooltip sagt es. - Versteckte Dateien (Name mit Punkt am Anfang) und ausgeschnittene Einträge sind halbtransparent.
- Symbolische Links stehen kursiv, der Tooltip sagt Symbolischer Link.
- Gemappte Ordner sind farbig hinterlegt, der Tooltip nennt Server und Ziel (Mappings).
- Änderungszeit rechts: bei Dateien die letzte Änderung, bei Ordnern die neueste Änderung darin (der Tooltip nennt die Datei). Angezeigt werden jetzt, Minuten, Stunden, gestern, Wochentag, Datum oder Jahr. Änderungen der letzten zehn Minuten stehen in der Akzentfarbe. Ein- und ausschalten unter Einstellungen › Erscheinungsbild › Änderungszeit im Projektbaum (ab Werk an).
- Start-Knopf an Dateien und Ordnern, die der Editor starten kann, siehe Starter.
Tastatur
Klicke einmal in den Baum, dann gelten diese Tasten:
| Taste | Wirkung |
|---|---|
| ↑ ↓, Bild ↑ Bild ↓, Pos1 Ende | bewegen; mit ⇧ die Auswahl erweitern |
| → | Ordner aufklappen, bei offenem Ordner in den ersten Eintrag |
| ← | Ordner zuklappen, sonst zum übergeordneten Ordner |
| ↩ | Datei öffnen, Ordner auf- oder zuklappen |
| Leertaste | Datei öffnen |
| F2 oder ⇧F6 | umbenennen |
| ⌘D | duplizieren |
| ⌘⌫ | in den Papierkorb |
| ⌘N | neue Datei mit Dateityp |
| ⌘C, ⌘X, ⌘V | kopieren, ausschneiden, einfügen |
| ⌥⌘C / ⇧⌥⌘C | Pfad / relativen Pfad kopieren |
| ⌥⌘R | im Finder zeigen |
| ⇧F10 oder Kontextmenü-Taste | Kontextmenü öffnen |
| Buchstaben | springt zum nächsten Eintrag mit diesem Anfang |
| Esc | bricht ein „Ausschneiden“ ab |
Kopierst du Einträge mit ⌘C und fügst sie im Terminal oder in einer Datei ein, kommen die Pfade als Text an, einer je Zeile.
Was im Hintergrund passiert
- Der Editor beobachtet die Ordner. Was sich auf der Platte ändert, erscheint von selbst im Baum, auch in angehängten Ordnern. Fehlte ein aufgeklappter Ordner kurz, liest er sich neu ein, sobald er wieder da ist.
- Löschen legt in den Papierkorb von macOS. Von dort holst du alles zurück.
- Den Zustand des Projekts (offene Ordner, Tabs, angehängte Ordner, Unterprojekte, Höhen) speichert der Editor im Projekt unter
.webdonkey-editor/workspace.json. Der Ordner bringt eine eigene.gitignoremit, die alles darin von Git ausschließt.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Diesen Ordner gibt es nicht mehr. im Baum | Der Ordner wurde außerhalb des Editors gelöscht oder verschoben. | Aktualisieren in der Kopfleiste oder den Ordner neu öffnen |
| Keine Berechtigung für diesen Ort. | macOS erlaubt dem Editor den Ordner nicht. | Rechte des Ordners im Finder prüfen (Informationen, Abschnitt Teilen & Zugriffsrechte) |
| Ein Eintrag mit diesem Namen existiert schon. | Beim Umbenennen oder Anlegen | anderen Namen wählen |
Dateien wie .env fehlen |
Versteckte Dateien sind ausgeblendet. | Versteckte Dateien zeigen in der Kopfleiste |
Siehe auch
Unterprojekte Free
Ein Unterprojekt zeigt einen Unterordner deines Projekts zusätzlich als eigenes Projekt, mit eigener Kopfleiste direkt unter dem Hauptprojekt. Das hilft, wenn du in einem großen Projekt meist in einem Teil arbeitest, zum Beispiel in einem Plugin unter custom/plugins/ eines Shops. Es ist derselbe Ordner wie im Hauptbaum: keine Kopie und kein Link auf der Platte. Was du dort änderst, gilt sofort an beiden Stellen.
So findest du es
Rechtsklick auf einen Ordner im Projektbaum ▸ Als Unterprojekt anzeigen.
So gehst du vor
- Klappe im Projektbaum den Ordner auf, der den gewünschten Unterordner enthält.
- Rechtsklick auf den Unterordner ▸ Als Unterprojekt anzeigen.
- Direkt unter der Kopfleiste des Hauptprojekts erscheint eine eingerückte Leiste mit dem Namen des Unterordners und einem kleinen Pfeil (↳). Der Tooltip des Pfeils sagt Unterprojekt von ….
- Klappe die Leiste auf. Darunter steht der Baum des Unterordners, mit denselben Gesten wie im Hauptbaum.
Umbenennen
Ein Unterprojekt heißt zunächst wie sein Ordner. Rechtsklick auf seine Kopfleiste (oder auf den Ordner im Hauptbaum) ▸ Unterprojekt umbenennen … gibt ihm einen eigenen Namen. Lässt du das Feld Name (leer = Ordnername) leer, gilt wieder der Ordnername. Der Ordner auf der Platte behält seinen Namen.
Entfernen
Das X in der Kopfleiste des Unterprojekts oder Unterprojekt entfernen im Kontextmenü nimmt die Leiste wieder heraus. Der Ordner bleibt im Hauptbaum, auf der Platte ändert sich nichts.
Regeln
- Eine Ebene: Ein Unterprojekt liegt in einem Ordner des Fensters, also im Projekt oder in einem angehängten Ordner. In einem Unterprojekt gibt es kein weiteres Unterprojekt, und ein Ordner, der schon ein Unterprojekt enthält, wird selbst keines.
- Das Projekt selbst und angehängte Ordner sind schon eigene Leisten, für sie fehlt der Eintrag.
- Gehört ein Unterprojekt zu einem angehängten Ordner, steht seine Leiste unter der Leiste dieses Ordners.
- Benennst du den Ordner um oder verschiebst ihn mit dem Projekt, bleibt er Unterprojekt.
In Mission Control
Jedes Unterprojekt ist in Mission Control ein eigenes Projekt mit eigenen Sitzungen. Startest du eine Claude-Sitzung ohne gewähltes Projekt, gehört sie zu dem Projekt, in dessen Ordner sie startet. Ein Unterprojekt geht dabei seinem Hauptprojekt vor. Ein im Dialog Neue Sitzung gewähltes Projekt hat immer Vorrang.
Was im Hintergrund passiert
Die Unterprojekte speichert der Editor mit dem Zustand des Projekts in .webdonkey-editor/workspace.json, mit Pfaden relativ zum Projekt. Sie bleiben über einen Neustart erhalten und gelten nur für dieses Projekt.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Als Unterprojekt anzeigen fehlt im Menü | Der Ordner ist das Projekt selbst, ein angehängter Ordner, liegt in einem Unterprojekt oder enthält eines. Oder du hast mehrere Einträge gewählt. | genau einen passenden Ordner wählen, vorher ein störendes Unterprojekt entfernen |
| Der Baum des Unterprojekts meldet Diesen Ordner gibt es nicht mehr. | Der Ordner wurde außerhalb des Editors gelöscht oder verschoben. | Unterprojekt entfernen und am neuen Ort neu anlegen |
Siehe auch
Neue Datei Free
⌘N im Projektbaum legt eine neue Datei an und bietet dir dabei eine Liste von Dateitypen. Wählst du einen Typ, steht die Endung schon fest und die Datei beginnt mit dem, was praktisch jede Datei dieses Typs braucht, etwa <?php oder dem Grundgerüst einer HTML-Seite. Du tippst nur noch den Namen.
So findest du es
- ⌘N, während der Projektbaum den Fokus hat. Die Datei landet im markierten Ordner oder neben der markierten Datei.
- Knopf Neue Datei in der Kopfleiste des Projekts.
- Rechtsklick auf einen Ordner, eine Datei oder die leere Fläche ▸ Neu ▸.
Datei ▸ Neue Datei und Datei ▸ Neuer Ordner in der Menüleiste legen direkt eine leere Zeile im Projektbaum an, ohne Typenliste. Dort tippst du Name und Endung frei.
So gehst du vor
- Markiere im Baum den Ordner, in den die Datei soll (oder eine Datei darin), und drücke ⌘N.
- Ganz oben steht Leere Datei. Sie ist schon markiert, ↩ nimmt sie. Bei ⌘N und Neu ▸ folgt Neuer Ordner.
- Darunter stehen In diesem Projekt (die Typen, die im Ordner und im Projekt am häufigsten vorkommen, höchstens fünf) und Zuletzt verwendet (deine letzten Typen, höchstens drei).
- Es folgen die Gruppen Web, Skripte, Programmiersprachen, Daten und Konfiguration und Dokumente als Untermenüs.
- Oder tippe einfach los: Tippen, um zu filtern findet Typen nach Name oder Endung (
php,.twig,yaml,excel). Der beste Treffer steht oben, ↩ nimmt ihn. - Nach der Wahl erscheint im Baum eine neue Zeile. Die Endung steht grau hinter dem Feld. Tippe den Namen und bestätige mit ↩. Esc bricht ab.
Die Datei öffnet sich sofort als Tab, bei Typen mit Vorlage steht der Cursor dort, wo du weiterschreibst.
Die Dateitypen
| Gruppe | Typen |
|---|---|
| Web | HTML, CSS, SCSS, JavaScript, TypeScript, TSX, JSX, Vue, Twig (.html.twig), PHP |
| Skripte | Shell-Skript, Python, Ruby |
| Programmiersprachen | Go, Rust, Java, Kotlin, Swift, C, C++, C# |
| Daten und Konfiguration | JSON, YAML (.yaml und .yml), TOML, XML, SQL, CSV, .env |
| Dokumente | Markdown, Textdatei, Word-Dokument, Excel-Arbeitsmappe |
Mit Inhalt beginnen: HTML (Grundgerüst mit der Sprache der Oberfläche), PHP (<?php), Shell-Skript (#!/usr/bin/env bash), Python (#!/usr/bin/env python3), JSON ({}) und XML (Kopfzeile mit UTF-8). Alle anderen Typen beginnen leer. Word-Dokument und Excel-Arbeitsmappe sind ein leeres, gültiges Dokument; die Arbeitsmappe hat ein erstes Blatt.
Wie aus dem Namen der Dateiname wird
- Nur ein Name: Die Endung des Typs kommt dazu (
CheckoutwirdCheckout.php). - Der Anfang der eigenen Endung getippt: Der Rest wird ergänzt (
index.htmlals Twig wirdindex.html.twig). - Eine andere Endung aus der Liste getippt: Sie gilt, und die Datei beginnt leer (
Foo.htmlmit dem Typ PHP wird eine leereFoo.html). - Ein Pfad wie
src/Service/Foo: Fehlende Ordner legt der Editor mit an und zeigt sie im Baum. - Beim Typ
.envsteht der ganze Name schon im Feld, du kannst dahinter weitertippen (.env.local).
Free und Premium
Alle Dateitypen sind frei, auch Word-Dokument und Excel-Arbeitsmappe. Bearbeiten kannst du solche Dateien im Editor mit den Viewern.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Ein Eintrag mit diesem Namen existiert schon. unter dem Feld | Im Ordner gibt es den Namen schon. | anderen Namen tippen, das Feld bleibt offen |
| Dieser Name ist nicht erlaubt | Der Name enthält . oder .. als Teil. |
Namen ändern |
| ⌘N tut nichts | Der Fokus liegt nicht im Projektbaum. | einmal in den Baum klicken oder den Knopf Neue Datei nehmen |
Siehe auch
Ziehen Free
Im Projektbaum fasst du Dateien und Ordner mit der Maus an und legst sie woanders ab: in einem anderen Ordner, in der Codefläche, im Terminal, bei Claude, auf einem Server oder außerhalb des Editors im Finder. Ein Ziehen beginnt erst, wenn du die Maus ein paar Pixel bewegst. Ein normaler Klick bleibt ein Klick.
So gehst du vor
Im Baum verschieben
- Fasse eine Datei, einen Ordner oder eine Mehrfachauswahl an und ziehe sie auf einen Ordner. Der Zielordner wird hervorgehoben.
- Bleibst du kurz (etwa eine Dreiviertelsekunde) über einem zugeklappten Ordner, klappt er von selbst auf.
- Lass los. Der Editor fragt Nach „Ordner“ verschieben? und zeigt, was wohin geht. Bestätige mit Verschieben.
Ein versehentliches Ziehen verschiebt so nie unbemerkt etwas. Offene Tabs folgen den verschobenen Dateien, aufgeklappte Ordner bleiben am neuen Ort aufgeklappt.
Im Baum kopieren
Halte beim Loslassen ⌥ gedrückt. Dann kopiert der Editor ohne Rückfrage, das Original bleibt, wo es ist.
Wenn es den Namen schon gibt
Liegt am Ziel schon ein Eintrag mit demselben Namen, fragt der Editor Name existiert schon:
- Überspringen: Dieser Eintrag bleibt, wo er ist.
- Beide behalten (Vorgabe): Der neue Eintrag bekommt eine Nummer.
- Ersetzen: Der vorhandene Eintrag kommt in den Papierkorb. Bei Ordnern heißt das: Der alte Ordner wird als Ganzes ausgetauscht, die Inhalte werden nicht zusammengeführt. Liegt der gezogene Eintrag selbst in dem Ordner, den er ersetzen würde, gibt es Ersetzen nicht.
Haben mehrere gezogene Einträge denselben Namen, nennt die Rückfrage sie. Alle werden verschoben, ab dem zweiten mit Nummer („Name 2“). Einen Ordner kann der Editor nicht in sich selbst verschieben.
Auf andere Ziele ziehen
| Ziehen auf | Wirkung |
|---|---|
| Codefläche | öffnet die Dateien als Tabs. Am Rand einer Editorgruppe teilt der Editor zuerst und öffnet in der neuen Hälfte. |
| Terminal | fügt die Pfade an der Eingabe ein. Läuft dort gerade Claude Code, landen sie als Erwähnungen in Claudes Eingabe. |
| Eingabefeld einer Sitzung in Mission Control | hängt die Dateien als Anhänge an die nächste Nachricht |
| Ordner auf einem Server (Remote-Fenster) | lädt die Einträge dorthin hoch (Premium), siehe Übertragungen |
| Finder, Mail, ein Upload-Feld im Browser | Ziehst du aus dem Editorfenster heraus, gibt macOS die Dateien als normale Dateien weiter (als Kopie). |
Aus dem Finder hinein
- Auf den Projektbaum: Der Editor kopiert die Dateien in den Ordner unter dem Zeiger. Gibt es den Namen schon, kommt dieselbe Rückfrage wie oben.
- Auf die Codefläche: Die Dateien öffnen sich in dieser Editorgruppe.
- Auf ein Terminal: Die Pfade landen an der Eingabe.
Zeilen aus dem Baum eines Servers, die du auf den Projektbaum ziehst, lädt der Editor in den Zielordner herunter.
Werkzeugfenster und Tabs ziehst du ebenfalls an andere Plätze, siehe Plätze und Fensterarten.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Ein Ordner kann nicht in sich selbst verschoben werden. | Das Ziel liegt im gezogenen Ordner. | ein anderes Ziel wählen |
| Nicht alle Einträge sind angekommen | Am Ziel ist inzwischen ein gleicher Name entstanden. | Ziel prüfen und den Rest noch einmal ziehen |
| Nichts passiert beim Ablegen auf den eigenen Ordner | Eine Datei in ihren eigenen Ordner zu verschieben ändert nichts. | mit ⌥ kopieren oder ein anderes Ziel wählen |
Siehe auch
Mehrfachauswahl Free
Im Projektbaum wählst du mehrere Dateien und Ordner auf einmal und bearbeitest sie gemeinsam: verschieben, kopieren, löschen, Pfade kopieren, an Claude senden oder Git-Aktionen auslösen.
So gehst du vor
- Klicke den ersten Eintrag an.
- Erweitere die Auswahl:
- ⌘-Klick nimmt einen Eintrag dazu oder wieder heraus.
- ⇧-Klick wählt alles vom zuletzt gewählten bis zum angeklickten Eintrag.
- ⇧↑ / ⇧↓, ⇧Bild ↑ / ⇧Bild ↓ und ⇧Pos1 / ⇧Ende erweitern mit der Tastatur.
- Rechtsklick auf einen der gewählten Einträge öffnet das Menü für alle, oder du nutzt direkt ein Tastenkürzel.
Ein Klick ohne Taste wählt wieder nur einen Eintrag.
Was mit mehreren Einträgen geht
| Aktion | Hinweis |
|---|---|
| Ausschneiden (⌘X), Kopieren (⌘C), Einfügen (⌘V) | Ausgeschnittene Einträge sind halbtransparent, bis du einfügst. Esc bricht das Ausschneiden ab. |
| In den Papierkorb (⌘⌫) | Die Rückfrage nennt die Namen und die Zahl der Einträge. |
| Verschieben per Ziehen | Die ganze Gruppe wandert gemeinsam. Gleiche Namen bekommen ab dem zweiten eine Nummer („Name 2“). |
| Pfad kopieren (⌥⌘C), Relativen Pfad kopieren (⇧⌥⌘C) | ein Pfad je Zeile |
| An Claude senden | alle gewählten Einträge als Erwähnungen |
| Git ▸ | wirkt auf die gewählten Dateien, zum Beispiel Restore (Änderungen verwerfen) … oder Commit … mit diesen Dateien vorausgewählt |
Umbenennen und Duplizieren gehen nur bei genau einem Eintrag. Im Menü sind sie bei mehreren ausgegraut.
⌘-Klick, ⇧-Klick und ⇧↑ / ⇧↓ wählen auch im Baum eines Servers mehrere Einträge, siehe Dateien auf dem Server.
Siehe auch
Repository klonen Free
Repository klonen … holt ein Git-Repository auf deinen Mac und öffnet es danach als Projekt. Die Quelle ist eine Adresse, ein Repository, das schon auf deinem Mac liegt, oder eines deiner Repositories auf GitHub. Du wählst Branch, Tag oder Commit, Zielordner und Ordnernamen. Der Editor überschreibt dabei nie einen vorhandenen Ordner und sieht nie ein Passwort oder Token.
So findest du es
- Datei ▸ Repository klonen …
- im Projektmenü der Titelleiste
- auf dem Startbildschirm
- in der Befehlspalette (⌘K): Repository klonen …
- Rechtsklick auf einen Ordner im Projektbaum, der in keinem Repository liegt ▸ Repository klonen …. Dieser Ordner ist dann schon als Ziel eingetragen.
So gehst du vor
Von einer Adresse
- Öffne Repository klonen …. Das Adressfeld ganz oben hat den Fokus.
- Füge einen Link ein (
https://…,git@…,ssh://…) oder schreib kurzowner/repo. - Prüfe unten Zielordner und Ordnername.
- Drücke ↩ oder klicke Klonen.
Aus einem lokalen Repository
- Wechsle in den Reiter Lokal. Der Editor sucht in den Ordnern deiner Projekte (offenes Projekt, angehängte Ordner, zuletzt geöffnete Projekte, Sites aus WebDonkey) nach Repositories, nie im ganzen Home-Ordner.
- Wähle ein Repository. Mehrere Worktrees desselben Repositorys stehen als ein Eintrag mit „n Worktrees“. Repositories filtern grenzt die Liste ein.
- Wähle unter Branches, Tags oder Commits den Stand, oder lass Aktueller Stand stehen.
- Wähle Worktree oder Kopie (siehe unten).
- Klicke Worktree anlegen oder Klonen.
Von GitHub
- Wechsle in den Reiter GitHub. Der Editor fragt die GitHub-CLI
gh, wer angemeldet ist. - Unter deinem Konto stehen Meine Repositories und deine Organisationen. Wähle eines davon.
- Die Liste zeigt die Repositories, neueste zuerst, mit Fork, archiviert und der Zeit des letzten Pushes. Repositories filtern sucht in der geladenen Liste. Gibt es mehr bei GitHub, sucht ↩ dort (Auf GitHub nach „…“ suchen). Weitere laden holt die nächste Seite.
- Wähle ein Repository, dann bei Bedarf Branch, Tag oder Commit. Der Standard-Branch ist markiert.
- Klicke Klonen.
Hält gh mehrere Konten, steht ein nicht aktives Konto mit in gh nicht das aktive Konto in der Liste. Wechseln macht es zum aktiven Konto von gh, auch für gh im Terminal. Ein Konto mit Anmeldung abgelaufen meldest du im Terminal neu an.
Felder und Optionen
| Feld | Bedeutung |
|---|---|
| Quelle | Zeile über dem Ziel: was geklont wird, mit Branch, Tag oder Commit. Ohne Wahl steht dort Adresse eingeben oder ein Repository auswählen. |
| Branch, Tag, Commit | der Stand, der ausgecheckt wird. Tag oder einzelner Commit werden ohne Branch ausgecheckt (detached HEAD); der Editor sagt dir, dass du dort zuerst einen Branch anlegen solltest. |
| Worktree | nur bei lokalen Repositories: ein eigener Ordner am selben Repository. Verlauf und Branches sind gemeinsam, der Haupt-Checkout bleibt unberührt. Git erlaubt einen Branch nur in einem Worktree, deshalb braucht ein Worktree einen anderen Branch, einen Tag oder einen Commit als den, der schon ausgecheckt ist. |
| Kopie | nur bei lokalen Repositories: ein unabhängiges Repository, aus dem lokalen Ordner geklont. Eine Kopie enthält nur lokale Branches. |
| Zielordner | wo der neue Ordner entsteht. Wählen … öffnet den Finder-Dialog. Vorgabe: der Ordner aus dem Kontextmenü, sonst der zuletzt gewählte, sonst der Ordner, in dem die meisten deiner Projekte liegen, sonst dein Home-Ordner. |
| Ordnername | Vorschlag: Name des Repositorys, bei gewähltem Stand mit Branch, Tag oder kurzem Commit dahinter (theme-feature-cart). Darunter steht, was passiert: Wird angelegt: … oder Nutzt den leeren Ordner …. |
Ist ein Fall nicht möglich, ist die Option ausgegraut und eine Zeile darunter sagt, warum.
Was im Hintergrund passiert
- Beim Klonen läuft die Ausgabe von
git(odergh) sichtbar mit. Abbrechen stoppt den Lauf und entfernt den angelegten Ordner wieder. - Ist das Klonen fertig, meldet der Editor Geklont: … und öffnet den Ordner als Projekt, mit der üblichen Frage nach Neues Fenster, Dieses Fenster oder Anhängen.
- Die GitHub-Liste liest der Editor über
gh, jede Liste erst, wenn du sie öffnest. Die Anmeldung haltenghund der Schlüsselbund. Der Editor speichert keine Zugangsdaten. - Gibt es das Ziel schon und ist es nicht leer, schreibt der Editor nichts hinein.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| Die GitHub-CLI (gh) ist nicht installiert | Im Terminal installieren (installiert gh mit Homebrew) oder cli.github.com öffnen, danach Neu prüfen. Klonen über eine Adresse und aus lokalen Repositories geht auch ohne gh. |
| gh ist nicht bei GitHub angemeldet | Im Terminal anmelden: gh zeigt einen Einmal-Code und öffnet den Browser. Das Klon-Fenster tritt so lange zur Seite. Danach Zurück zu „Repository klonen“. |
| git braucht eine Eingabe (Passwort, Passphrase, unbekannter Host-Schlüssel) | Im Terminal ausführen startet genau denselben Befehl sichtbar im Terminal, dort beantwortest du die Frage. |
| Das Ziel gibt es schon und ist nicht leer | anderen Ordnernamen wählen, es wird nichts überschrieben |
| Die Organisation verlangt Single Sign-on. | im Terminal gh auth refresh ausführen und die Organisation freigeben |
| Das Anfragelimit von GitHub ist erreicht. | ein paar Minuten warten |
| Nicht gefunden (oder kein Zugriff) | Schreibweise prüfen, mit Wechseln ein Konto mit Zugriff aktiv machen |
| git ist nicht installiert. | Git auf dem Mac installieren, dann das Fenster neu öffnen |