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 column

y 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áxis https://github.com/:owner:/:repo:/new/main) en el que describas tu experiencia hasta ahora en este master y lo enlazas desde el fichero README.md.
1. Incluyas alguna imagen en el repo en una carpeta img y la muestres desde el texto
2. 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 fichero README.md. Añade una referencia/enlace de vuelta en objetivos.md a tu README.md
- En el fichero master.md pon un enlace de vuelta al README.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

En este enlace puedes visitar ejemplos de lo que han hecho algunos alumnos de la asignatura Aprendizaje y Enseñanza de la Tecnología del master de Formación de Profesorado en el curso 21/22

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

Borja repo , Commits, Commit Activity and Summary
Casiano repo , Commits, Commit Activity and Summary
Daniel repo , Commits, Commit Activity and Summary
Konrad repo , Commits, Commit Activity and Summary

Prácticas

GitHub Campus Expert
- Repos en GH: github-campus-expert
- Rúbrica
Learning Markdown
- Repos en GH: aprender-markdown
- Rúbrica
Setting up Our Environment
- Repos en GH: setup
- Rúbrica
Introduction to Systems Development
- Repos en GH: intro2sd
- Rúbrica
Asyncmap
- Repos en GH: asyncmap
- Rúbrica
Search in Jekyll
- Repos en GH: jekyll-search
- Rúbrica
Building a Mini Prompt Engineering Framework
- Repos en GH: prompt-engineering
- Rúbrica
Building a Web App with Next.js
- Repos en GH: nextjs13
- Rúbrica
OpenAI and Next.js
- Repos en GH: nextjs
- Rúbrica