Desarrollo y Mantenimiento de Sistemas Informáticos
4º. 1er cuatrimestre. Itinerario de Sistemas de la Información. Grado en Ingeniería Informática. ULL
GH Org - GH Template Org - GitHub Classroom - Discussions - Teams - Campus ULL - Students Activity - Chat - Google Meet
- Aprender Markdown
Aprender Markdown
La siguiente sección establece los objetivos y competencias que debes lograr. Las subsiguientes secciones presentan los recursos para lograr estos objetivos.
Puede encontrar una descripción de esta práctica pero para la asignatura AET en Aprender Markdown (aprender-markdown)
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'}) } } -
Incluye 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 columny 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: :+1: - 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
imgy la muestres desde el texto - Añadas un segundo fichero en el repo con nombre
objetivos.mdcontando 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.mda tuREADME.md
- En el fichero
master.mdpon un enlace de vuelta alREADME.md
- Incluyas alguna imagen en el repo en una carpeta
- 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
Introduccion al Lenguaje de Marcas MarkDown
Lee
- Escribir en GitHub
- 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
Matemáticas
Añade una fórmula matemática escrita en \(\LaTeX\)
Si escribes una fórmula matemática en latex y la rodeas de $$, el markdown de GH la mostrará como un bloque. Por ejemplo:
**The Cauchy-Schwarz Inequality**
$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$
Se ve:
The Cauchy-Schwarz Inequality
\[\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)\]Para incluir una expresión matemática en línea con su texto, delimite la expresión con un símbolo de dólar $. Por ejemplo:
This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$
Se ve como esto:
This sentence uses $ delimiters to show math inline: \(\sqrt{3x-1}+(1+x)^2\)
Diagramas con mermaid
Puedes incluir diagramas en tus documentos usando mermaid. Por ejemplo:
```mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
```
que se verá como:
Task lists
Ejemplo:
- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:
Se verá así:
- #739
- https://github.com/octo-org/octo-repo/issues/740
- Add delight to the experience when all tasks are complete :tada:
Este ejemplo muestra también como escribir un emoji por nombre :tada:.
Mas información en Acerca de las listas de tareas
Special notes
To better highlight and separate certain information from the rest in your documentation on GitHub, there is a way to render a special and accessible note or warning blockquote in Markdown documents. It uses the existing syntax for blockquote and bold text.
> **Note**
> This is a note
> **Warning**
> This is a warning
Note This is a note
Warning This is a warning
See An option to highlight a “Note” and “Warning” using blockquote
Ejemplo de como hacer la práctica
Véase ULL-MFP-AET-2223/aprender-markdown-belen-herrera-gimenez-alu0101598581
Edición en la Nube de Repositorios GitHub
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
- Usar el editor GitHub.dev. Véase también las notas en estos apuntes sobre GitHub.dev. Véase también las notas en estos apuntes sobre GitHub.dev: 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 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
- La misma información pero en la web asociada
- articles about how to write a profile readme.
Rúbrica
- Se incluyen todos los aspectos solicitados en el markdown y se visualizan correctamente
- Kanban Board project conteniendo las incidencias en su estado
- Convierto las notas en issues
- He generado el issue de práctica terminada
- Informe elaborado correcto
- Ha creado un repo profile en GitHub
- Ha entregado el .zip en el campus con el repo
Referencias
- Mastering (GitHub) Markdown
- Documentación GitHub sobre la Interfaz Web
- How to use VS Code to submit an assignment to Github Classroom (initially empty repository) 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
Actividad
- Aaron repo , Commits, Commit Activity and Summary
- Alejandro repo , Commits, Commit Activity and Summary
- Casiano repo , Commits, Commit Activity and Summary