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

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.

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

  1. Escribir en GitHub
  2. El tutorial Mastering Markdown para saber mas sobre esta forma de elaborar documentos
  3. 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í:

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:

  1. Editar directamente usando el editor on-line de GitHub
  2. 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
  3. Usar Codespaces (Probablemente la opción mas recomendable si dispones de este servicio)
  4. 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:

Rúbrica

Referencias

Actividad

  1. Aaron repo , Commits, Commit Activity and Summary
  2. Alejandro repo , Commits, Commit Activity and Summary
  3. Casiano repo , Commits, Commit Activity and Summary

Prácticas

  1. NextAuth.js
    1. Repos en GH: nextra
    2. Rúbrica
  2. Introduction to Next.js with v0
    1. Repos en GH: nextjs-intro
    2. Rúbrica
  3. Introduction to Nextra
    1. Repos en GH: nextra
    2. Rúbrica
  4. Search in Jekyll
    1. Repos en GH: jekyll-search
    2. Rúbrica
  5. Introduction to Systems Development
    1. Repos en GH: intro2sd
    2. Rúbrica
  6. Setting up Our Environment
    1. Repos en GH: setup
    2. Rúbrica
  7. Learning Markdown
    1. Repos en GH: aprender-markdown
    2. Rúbrica
  8. GitHub Campus Expert
    1. Repos en GH: github-campus-expert
    2. Rúbrica