Getting Started with GitHub

[github-learning-lab]

¡Bienvenido a tu repositorio!

En este repositorio ^📖, aprenderás a escribir usando Markdown ^📖, un lenguaje de marcado para formatear texto simple y usado muy frecuentemente. Aquí empezarás a crear un sitio web estático para tu portafolio personalizado.

¿Qué es Markdown?

Markdown es una sintaxis ligera para comunicarse en GitHub y en muchos otros sitios web. Puedes formatear palabras en negrita o cursiva, añadir imágenes o crear listas. Markdown es texto normal combinado con algunos caracteres no alfabéticos, como # o *. Puedes usar Markdown a través de la barra de formato en las propuestas (o issues) ^📖 y solicitudes de extracción (o pull requests) ^📖, o puedes directamente teclear la sintaxis.

Puedes usar Markdown en la mayoría de sitios web de GitHub:

• Comentarios en propuestas y solicitudes de extracción (¡como esta!)
• Archivos con la extensión .md o .markdown
• Compartiendo fragmentos de texto a través de Gists

Para más información, revisa “Writing on GitHub” en la Ayuda de GitHub.

¡Empecemos!

[github-learning-lab]

Paso 1: Crea una lista de tareas

Una lista de tareas crea casillas que las personas con acceso ^📖 en un repositorio pueden marcar como completadas. Son muy útiles para seguir las incidencias y las solicitudes de extracción.

Si incluyes una lista de tareas en el cuerpo de una propuesta o una solicitud de extracción, verás una barra de progreso en tu lista de propuestas.

¡Cuidado! La sintaxis para listas de tareas es muy específica. Asegúrate de incluir los espacios donde hacen falta, de lo contrario no se mostrarán correctamente.

Ejemplo de lenguaje de marcado

- [x] Puedes usar marcado adicional, incluyendo @menciones, #referencias, [enlaces](url), **énfasis** y <del>etiquetas HTML</del>.
- [x] Se requiere la sintaxis de listas.
  - ¡También puedes anidar listas, unas dentro de otras!
- [x] Este elemento está completado.
- [ ] Este elemento está sin completar.

Renderizado

• Puedes usar marcado adicional, incluyendo @menciones, #referencias, enlaces, énfasis y etiquetas HTML.
• Se requiere la sintaxis de listas.
  • ¡También puedes anidar listas, unas dentro de otras!
• Este elemento está completado.
• Este elemento está sin completar.

⌨️ Actividad: Añade un comentario

1. Añade un comentario a esta propuesta, usando Markdown para crear una lista de elementos a completar. Tu lista puede incluir las tareas que quieras, o puedes usar este ejemplo:

   - [ ] Activar GitHub Pages
   - [ ] Hacer un esquema de mi portafolio
   - [ ] Presentarme al mundo
   

2. Utiliza la pestaña Preview para comprobar el formato de tu markdown.

3. Haz clic en Comment.

Para una versión imprimible de los pasos de este curso, revisa la Guía de referencia rápida.

---

Mira debajo de tu comentario para ver mi respuesta.

Si realizas la acción prevista y no ves una respuesta por mi parte después de algunos segundos, actualiza la página para ver los siguientes pasos.

[ElvertMora]

• tarea 1
• tarea 2
• tarea 3

[github-learning-lab]

Paso 2: Activa GitHub Pages

¡Bien hecho @ElvertMora!

Ahora centrémonos en el contenido de tu portafolio. Dado que este portafolio se mostrará como una página estática, es necesario que actives GitHub Pages.

⌨️ Actividad: Activa GitHub Pages

1. Debajo del nombre de tu repositorio, haz clic en Settings.
2. En la sección GitHub Pages, utiliza el desplegable Select source para seleccionar main como tu fuente de publicación para GitHub Pages.

Puede que tarde hasta un minuto responder mientras GitHub Pages crea un despliegue de tu repositorio.

Para más información, consulta Configuring a publishing source for GitHub Pages en la Ayuda de GitHub.

---

Vuelve a esta propuesta para los próximos pasos.

[github-learning-lab]

Echa un ojo a tu sitio publicado aquí: https://elvertmora.github.io/markdown-portfolio/

Según vayamos añadiendo contenido a lo largo del curso, el sitio se actualizará.

He cerrado esta propuesta y he abierto una solicitud de extracción para que trabajes en los encabezados de tu portafolio.

---

¡Accede a la solicitud de extracción ahora!