GitHub CLI를 사용하여 파일 첨부

명령줄을 벗어나지 않고 문제, 끌어오기 요청 및 주석에 로컬 이미지 및 비디오를 첨부합니다.

이 기사에서

명령줄에서 --attach를 사용하여 GitHub CLI 플래그로 로컬 이미지 또는 비디오를 첨부할 수 있습니다. GitHub CLI 파일을 GitHub 업로드하고 결과 URL을 문제, 끌어오기 요청 또는 주석의 본문에 씁니다. 따라서 브라우저에 첨부한 경우와 마찬가지로 인라인으로 렌더링됩니다.

파일을 첨부하려면 리포지토리에 대한 푸시 액세스 권한이 필요합니다.

플래그는 --attach 다음 명령에서 사용할 수 있습니다.

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

파일 첨부

로컬 파일 경로와 함께 --attach를 전달하세요. 다음 예제에서는 ISSUE-NUMBER 문제 수로 바꾸고 PATH/TO/IMAGE를 이미지 경로로 바꿉다. 플래그를 반복하여 둘 이상의 파일을 첨부할 수 있지만 동일한 파일을 두 번 첨부할 수는 없습니다.

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

--body을(를) --attach 또는 --body-file와 함께 사용하여 Markdown에 이미지와 동영상을 삽입할 수 있습니다. 다음 예제에서는 끌어오기 요청 제목, Markdown 본문 파일 및 두 개의 이미지 파일에 자리 표시자를 사용합니다.

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

이미지에 대한 대체 텍스트를 설정하려면 ALT-TEXT 대신 경로 #의 끝에 추가합니다.

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

대체 텍스트를 GitHub CLI 제공하지 않으면 파일 이름을 사용합니다.

참고

대체 텍스트는 비디오 파일에서 지원되지 않습니다.

Markdown에 첨부 파일 포함

Markdown 텍스트가 이미 로컬 파일을 참조하고 동일한 파일을 --attachGitHub CLI 첨부하는 경우 마지막에 두 번째 복사본을 추가하는 대신 업로드된 파일을 가리키도록 참조를 다시 작성합니다. 이렇게 하면 일반 로컬 경로를 사용하여 Markdown을 작성하고, 이미지가 렌더링되는 위치에서 로컬로 미리 본 다음, 변경되지 않은 상태로 게시할 수 있습니다. 본문 텍스트의 출처가 --body, --body-file, 표준 입력 또는 텍스트 편집기인지와 관계없이 참조는 다시 작성됩니다.

이미지 포함

예를 들어 다음 콘텐츠를 다음과 같이 저장합니다.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)

다음 명령을 사용하여 실행합니다.--body-file

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

GitHub CLI 는 로컬 경로를 업로드된 URL로 바꾸고 Markdown 및 대체 텍스트를 유지합니다. 참조를 다시 작성하면 대체 텍스트가 Markdown에서 제공되므로 플래그의 모든 # 대체 텍스트는 추가된 파일에만 적용됩니다.

본문에서 참조하지 않는 첨부 파일은 플래그를 전달한 순서대로 본문 끝에 추가됩니다.

비디오 포함

비디오를 플레이어로 포함하려면 다음 Markdown 이미지 참조를 저장합니다 PATH/TO/VIDEO-BODY-FILE. 참조는 해당 단락의 유일한 콘텐츠여야 합니다.

![](PATH/TO/VIDEO)

그런 다음, 동일한 비디오를 첨부합니다.

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

GitHub CLI 는 전체 참조를 업로드된 URL로 바꿉니다. 이 URL은 플레이어로 렌더링됩니다. 참조가 문장 내에 나타나면 대신 링크로 렌더링됩니다.

Limitations

GitHub CLI 이미지 및 미디어 파일 업로드만 지원합니다. 지원되는 파일 형식 목록은 파일 첨부을 참조하세요.