Adjuntar archivos con la CLI de GitHub

Adjunte imágenes y vídeos locales a problemas, solicitudes de incorporación de cambios y comentarios sin salir de la línea de comandos.

En este artículo

Puede adjuntar una imagen o un vídeo locales desde la línea de comandos con GitHub CLI usando la opción --attach. GitHub CLI carga el archivo en GitHub y escribe la URL resultante en el cuerpo de la incidencia, la solicitud de extracción o un comentario, para que se muestre en línea igual que si lo adjuntaras en tu navegador.

Necesita acceso de inserción al repositorio para adjuntar archivos.

La --attach marca está disponible en los siguientes comandos:

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

Adjuntar un archivo

Pase --attach con la ruta de acceso a un archivo local. En el ejemplo siguiente, reemplace ISSUE-NUMBER por el número de su problema y PATH/TO/IMAGE por la ruta de acceso a la imagen. Puede repetir la marca para adjuntar más de un archivo, pero no puede adjuntar el mismo archivo dos veces.

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

Puede combinar --attach con --body o --body-file para insertar imágenes y vídeos en Markdown. En el ejemplo siguiente se usan marcadores de posición para el título de la solicitud de incorporación de cambios, el archivo con el cuerpo en Markdown y dos archivos de imagen.

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

Para definir el texto alternativo de una imagen, añádalo al final de la ruta, después de #, en lugar de ALT-TEXT.

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

Si no proporciona texto alternativo, GitHub CLI usa el nombre de archivo.

Nota:

El texto alternativo no se admite en archivos de vídeo.

Inserción de datos adjuntos en Markdown

Si el texto de Markdown ya hace referencia a un archivo local y adjunta ese mismo archivo con --attach, GitHub CLI vuelve a escribir la referencia en su lugar para que apunte al archivo cargado, en lugar de anexar una segunda copia al final. Esto le permite escribir Markdown con rutas de acceso locales normales, obtener una vista previa de ellas localmente donde se representan las imágenes y, a continuación, publicarlas sin cambios. La referencia se reescribe independientemente de dónde procede el texto del cuerpo: --body, --body-file, entrada estándar o el editor de texto.

Inserción de una imagen

Por ejemplo, guarde el siguiente contenido en 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)

Ejecute el comando siguiente con --body-file:

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

GitHub CLI reemplaza la ruta local por la URL subida y mantiene tu Markdown y el texto alternativo. Cuando se vuelve a escribir una referencia, el texto alternativo procede de Markdown, por lo que cualquier # texto alternativo de la marca solo se aplica a los archivos que se anexan.

Cualquier archivo adjunto al que no se haga referencia en el cuerpo se añade al final del cuerpo, en el orden en que se pasaron los indicadores.

Inserción de un vídeo

Para insertar un vídeo como reproductor, guarde la siguiente referencia de imagen de Markdown en PATH/TO/VIDEO-BODY-FILE. La referencia debe ser el único contenido de su párrafo.

![](PATH/TO/VIDEO)

A continuación, adjunte el mismo vídeo:

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

GitHub CLI reemplaza toda la referencia por la dirección URL cargada, que se representa como un reproductor. Si la referencia aparece dentro de una oración, se representa como un vínculo en su lugar.

Limitations

El GitHub CLI solo admite la carga de archivos de imagen y multimedia. Para obtener una lista de los tipos de archivo admitidos, consulte Adjuntar archivos.