Skip to main content

Creación de una lista de tareas

Puedes crear una lista de tareas usando la interfaz de usuario de GitHub o Markdown.

Nota: Las listas de tareas se encuentran en versión beta privada y están sujetas a cambios. Actualmente, hemos pausado la incorporación a la versión beta.

Creación de listas de tareas en la interfaz de usuario

Puedes usar el botón Agregar lista de tareas para agregar rápidamente una lista de tareas a una incidencia. El botón Agregar lista de tareas está disponible cuando se ve o edita una incidencia.

  1. Ve a la incidencia que quieres que contenga la nueva lista de tareas. También puedes crear una nueva incidencia.

  2. Al final de la descripción de la incidencia, haz clic en Agregar lista de tareas.

    Captura de pantalla de una incidencia. El botón "Agregar lista de tareas" aparece resaltado con un contorno naranja.

  3. Después, puedes agregar incidencias, solicitudes de incorporación de cambios y borradores de tareas a la nueva lista de tareas. Para obtener más información, vea «Administración de tareas en una lista de tareas».

Creación de listas de tareas con Markdown

Puedes crear una lista de tareas usando Markdown en la descripción de la incidencia (comentario de apertura de una incidencia). Puedes incluir vínculos a incidencias y solicitudes de incorporación de cambios o crear borradores de incidencias.

Puedes agregar una lista de tareas copiando el siguiente Markdown en la descripción de la incidencia:

Markdown
```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft task
```

También puedes usar el botón Agregar lista de tareas mientras editas la incidencia para insertar el Markdown para una lista de tareas:

Captura de pantalla de una incidencia. El botón "Agregar lista de tareas" aparece resaltado con un contorno naranja.

Una vez que has empezado a editar el Markdown de la lista de tareas, puedes agregar nuevas tareas anteponiendo - [ ] a cada nueva tarea y agregando uno de los siguientes elementos:

  • El borrador de una tarea. Los borradores de tareas son texto que después se puede convertir en incidencias.
  • Vínculo completo a un problema o solicitud de incorporación de cambios. Por ejemplo, https://github.com/octo-org/octo-repo/issues/45. Si la incidencia o la solicitud de incorporación de cambios se encuentran en el mismo repositorio que su lista de tareas, puede usar la sintaxis abreviada #ISSUE-NUMBER. Por ejemplo, #45.

Si agregas el borrador de una tarea, debe cumplir estos requisitos:

  • A los borradores de tareas se les puede dar formato con Markdown.
  • Los borradores de tareas no deben tener más de 512 caracteres de longitud.

GitHub representará la lista de tareas cuando veas una vista previa de los cambios y cuando guardes la incidencia. Después, puedes realizar cambios y agregar incidencias y borradores de incidencias usando la interfaz de usuario de GitHub. Si editas la descripción de la incidencia, podrás modificar el Markdown directamente o copiarlo para duplicar la lista de tareas en otras incidencias.

Cambio del título de una lista de tareas

Al crear una nueva lista de tareas, el título predeterminado es "Tareas". Puedes modificar el título haciendo clic en Cambiar nombre en el menú contextual de la lista de tareas o editando el Markdown de la incidencia.

  1. En la parte superior derecha del cuerpo del problema, seleccione y haga clic en Editar.

    Captura de pantalla del encabezado de un comentario de incidencia. En la esquina derecha, un icono de kebab horizontal resaltado en naranja oscuro.

  2. En el bloque de código delimitado que comienza con ````[tasklist], add a header with your new title, such as ### My new title`.

    Captura de pantalla de un comentario de incidencia en modo de edición. Debajo de la línea que dice "```tasklist", aparece resaltada en naranja oscuro una línea que dice "### My new title".

  3. Haga clic en Update comment (Actualizar comentario).

Copiado de una lista de tareas

Cuando copias una lista de tareas con la opción "Copiar Markdown", GitHub copia el Markdown en el Portapapeles e incluye el título de la incidencia para que puedas pegar la lista de tareas fuera de GitHub sin perder el contexto. A continuación puedes ver un ejemplo de una lista de tareas en Markdown copiada:

- [x] [Design new landing page](https://github.com/octocat/octoproject/issues/4)
- [ ] [Translate content into supported languages](https://github.com/octocat/octoproject/issues/11)
  1. En la parte superior derecha de la lista de tareas, haz clic en .

    Captura de pantalla de una lista de tareas. El menú de elementos de bloque de seguimiento, que se etiqueta con un icono de kebab horizontal, resaltado en naranja oscuro.

  2. En el menú, haz clic en Copiar markdown.