# Aprender Markdown
La siguiente sección establece los objetivos y competencias que debes lograr. Las subsiguientes secciones presentan los recursos para lograr estos objetivos.
# Aprender Markdown
Un objetivo de esta tarea es aprender Markdown. Para ello, en el repositorio que se crea cuando aceptas la asignación deberás rellenar los contenidos del fichero README.md
con un pequeño curriculum vitae/carta de presentación usando markdown.
Incluye alguna imagen
Incluye algunos enlaces (por ejemplo un enlace a tu usuario en el campus virtual o el LMS de tu institución educativa).
Incluya al menos una lista enumerada y una lista no ordenada (bullets)
Una cita favorita (blockquote)
Un fragmento de código inline de un lenguaje de programación
Incluye un trozo de código que ocupe varias líneas como este y asegúrate de que aparece coloreado:
function fancyAlert(arg) { if(arg) { $.facebox({div:'#foo'}) } }
1
2
3
4
5Incluye una tabla. Puede hacerse así:
First Header | Second Header ------------ | ------------- Content from cell 1 | Content from cell 2 Content in the first column | Content in the second column
1
2
3
4y se verá así:
First Header Second Header Content from cell 1 Content from cell 2 Content in the first column Content in the second column Incluye un emoji. Por ejemplo
:+1:
se ve: 👍Añade un fichero
master.md
(puedes crearlo usando el menu o bien visitando una ruta con la sintáxishttps://github.com/:owner:/:repo:/new/main
) en el que describas tu experiencia hasta ahora en este master y lo enlazas desde el ficheroREADME.md
.
- Incluyas alguna imagen en el repo en una carpeta
img
y la muestres desde el texto - Añadas un segundo fichero en el repo con nombre
objetivos.md
contando cuáles son tus objetivos con respecto a este curso y lo referencies desde el ficheroREADME.md
. Añade una referencia/enlace de vuelta enobjetivos.md
a tuREADME.md
- En el fichero
master.md
pon un enlace de vuelta alREADME.md
- Podemos hacer uso del editor que provee la interfaz web de GitHub.
- Pero hay editores alternativos mejores como el editor web de GitHub y GitPod
- Recuerda hacer "commits" para guardar los cambios.
- En la tarea entrega el enlace al repo con los contenidos de tu trabajo
- Añade una imagen-enlace. Se deberá ver la imagen pero esta será un enlace a otra página
Te puede ayudar el tutorial de GitHub Markdown (opens new window)
# Introduccion al Lenguaje de Marcas MarkDown
Lee
- Escribir en GitHub (opens new window)
- El tutorial Mastering Markdown para saber mas sobre esta forma de elaborar documentos
- Para mas detalles consulta la guía de usuario Getting started with writing and formatting on GitHub
# Aprender a Usar un Editor en la Nube
Hay múltiples formas de editar en la nube un repositorio GitHub. En estas notas recogemos estas alternativas:
- Editar directamente usando el editor on-line de GitHub (opens new window)
- Usar el editor GitHub.dev (opens new window): se activa simplemente tecleando el punto cuando se está visitando el repo
- Usar Codespaces (Probablemente la opción mas recomendable si dispones de este servicio)
- Usar GitPod, una alternativa a Codespaces
# Introducción a la Edición en la Nube de Repositorios GitHub
Para manejar todo el proceso de edición pueden ayudarte estas notas sobre Edición en la Nube.
# Aprender a Usar Incidencias
Cuando termines esta tarea puedes generar una incidencia comunicándoselo al profesor. Así practicas un poco mas de markdown.
# Crea tu repo profile
Siguiendo las instrucciones en la documentación de GitHub Managing your profile README (opens new window) añade un README a tu perfil de GitHub para que otras personas sepan sobre ti.
GitHub muestra el README de tu perfil al inicio de tu página de perfil.
Tú decides qué información incluir en el README de tu perfil. Reutiliza el material creado en la práctica anterior.
Puedes encontrar ejemplos curiosos de repos profile en esta referencia:
- abhisheknaiidu/awesome-github-profile-readme (opens new window)
- La misma información pero en la web (opens new window) asociada
- articles about how to write a profile readme (opens new window).
# Referencias
- Mastering (GitHub) Markdown (opens new window)
- Documentación GitHub sobre la Interfaz Web
- How to use VS Code to submit an assignment to Github Classroom (initially empty repository) (opens new window) Vídeo que muestra como deben hacer los estudiantes para aceptar, trabajar y entregar una tarea asignada con GHC usando el editor VS Code
- GitHub Glossary (opens new window)