Anfügen von Dateien mit GitHub CLI

Fügen Sie lokale Bilder und Videos an Probleme, Pullanforderungen und Kommentare an, ohne die Befehlszeile zu verlassen.

In diesem Artikel

Sie können über die Befehlszeile mit GitHub CLI ein lokales Bild oder Video mithilfe der Option --attach anhängen. GitHub CLI lädt die Datei in GitHub hoch und schreibt die resultierende URL in den Text Ihres Issues, Pull Requests oder Kommentars, sodass sie direkt im Text angezeigt wird – genauso, als hätten Sie sie in Ihrem Browser angehängt.

Sie benötigen Pushzugriff auf das Repository, um Dateien anzufügen.

Das --attach Flag ist in den folgenden Befehlen verfügbar:

  • gh issue create
  • gh issue edit
  • gh issue comment
  • gh pr create
  • gh pr edit
  • gh pr comment

Anfügen einer Datei

Übergeben Sie --attach mit dem Pfad zu einer lokalen Datei. Ersetzen Sie im folgenden Beispiel ISSUE-NUMBER durch die Anzahl Ihres Problems und PATH/TO/IMAGE durch den Pfad zu Ihrem Bild. Sie können das Flag wiederholen, um mehrere Dateien anzufügen, aber Sie können dieselbe Datei nicht zweimal anfügen.

gh issue comment ISSUE-NUMBER --attach PATH/TO/IMAGE

Sie können --attach mit --body oder --body-file kombinieren, um Bilder und Videos in Ihr Markdown einzubetten. Im folgenden Beispiel werden Platzhalter für den Titel der Pullanforderung, die Markdown-Textkörperdatei und zwei Bilddateien verwendet.

gh pr create \
  --title "PULL-REQUEST-TITLE" \
  --body-file PATH/TO/BODY-FILE \
  --attach PATH/TO/FIRST-IMAGE \
  --attach PATH/TO/SECOND-IMAGE

Wenn Sie Alternativtext für ein Bild festlegen möchten, fügen Sie ihn am Ende des Pfads nach einem #, anstelle von ALT-TEXT, hinzu.

gh issue comment ISSUE-NUMBER --attach 'PATH/TO/IMAGE#ALT-TEXT'

Wenn Sie keinen Alternativtext angeben, verwendet GitHub CLI den Dateinamen.

Hinweis

Alternativtext wird für Videodateien nicht unterstützt.

Einbetten eines Anhangs in Markdown

Wenn der Markdown-Text bereits auf eine lokale Datei verweist und Sie dieselbe Datei mit --attach anhängen, schreibt GitHub CLI den Verweis direkt um, sodass er auf die hochgeladene Datei verweist, anstatt am Ende eine zweite Kopie anzuhängen. Auf diese Weise können Sie Markdown mit normalen lokalen Pfaden schreiben, lokal eine Vorschau anzeigen, wo die Bilder gerendert werden, und dann unverändert posten. Der Verweis wird unabhängig davon neu geschrieben, wo der Fließtext herkommt: --body, --body-file, Standardeingabe oder der Texteditor.

Einbetten eines Bilds

Speichern Sie z. B. den folgenden Inhalt in PATH/TO/BODY-FILE:

The sign-in screen shows an error where the form should be:

![the sign-in screen showing an authentication error](PATH/TO/IMAGE)

Führen Sie den folgenden Befehl mit --body-file:

gh issue comment \
  ISSUE-NUMBER \
  --body-file PATH/TO/BODY-FILE \
  --attach PATH/TO/IMAGE

GitHub CLI ersetzt den lokalen Pfad durch die hochgeladene URL und behält Den Markdown- und Alternativtext bei. Wenn ein Verweis neu geschrieben wird, stammt der Alternativtext aus dem Markdown, sodass alle # Alternativtexte auf dem Flag nur auf Dateien angewendet werden, die angefügt werden.

Jede angefügte Datei, auf die der Textkörper nicht verweist, wird an das Ende des Textkörpers angefügt, in der Reihenfolge, in der Sie die Flags übergeben haben.

Einbetten eines Videos

Wenn Sie ein Video als Player einbetten möchten, speichern Sie den folgenden Markdown-Bildverweis in PATH/TO/VIDEO-BODY-FILE. Der Verweis muss der einzige Inhalt in seinem Absatz sein.

![](PATH/TO/VIDEO)

Fügen Sie dann dasselbe Video an:

gh issue comment \
  ISSUE-NUMBER \
  --body-file PATH/TO/VIDEO-BODY-FILE \
  --attach PATH/TO/VIDEO

GitHub CLI ersetzt die gesamte Referenz durch die hochgeladene URL, die als Player angezeigt wird. Wenn der Verweis in einem Satz angezeigt wird, wird er stattdessen als Link gerendert.

Einschränkungen

Dies GitHub CLI unterstützt nur das Hochladen von Bild- und Mediendateien. Eine Liste der unterstützten Dateitypen finden Sie unter Anfügen von Dateien.