Markdown Links

Índice

• 1. Preámbulo
• 2. Resumen del proyecto
• 3. Diagrama de flujo
• 4. Guía de instalación
• 5. Manual de uso

1. Preámbulo

Markdown es un lenguaje de marcado ligero muy popular entre developers. Es usado en muchísimas plataformas que manejan texto plano (GitHub, foros, blogs, ...) y es muy común encontrar varios archivos en ese formato en cualquier tipo de repositorio (empezando por el tradicional README.md).

Estos archivos Markdown normalmente contienen links (vínculos/ligas) que muchas veces están rotos o ya no son válidos y eso perjudica mucho el valor de la información que se quiere compartir.

2. Resumen del proyecto

md-Links es una librería que facilita la lectura y análisis de los archivos con formato Markdown, esta ha sido desarrollada en Node.js. Esta librería permite verificar los enlaces que se encuentran dentro de los archivos con extensión .md y genera informes sobre ellos para su posterior necesidad.

3. Diagrama de flujo

Este proyecto se trabajo mediante método SCRUM, previo un diagrama de flujo, apoyado de planificación semanal Diagrama de flujo

4. Guía de instalación

Lleva esta librería a tu proyecto, mediante el siguiente comando de instalación

npm i Maarlenf/DEV005-md-links

5. Manual de uso

A través de tu terminal de Git, podras acceder a los resultados con las siguientes instrucciones de CLI:

Con mdLinks <path-to-file> :

$ md-links ./some/example.md
  [{
    href: 'https://someExample.com/some',
    text: 'some links',
    file: 'C:\\Users\\Some\\OneDrive\\Escritorio\\some-path'
   }]

Con mdLinks <path-to-file> --validate:

$ md-links ./some/example.md --validate
  [{
    href: 'https://someExample.com/some',
    text: 'some links',
    file: 'C:\\Users\\Some\\OneDrive\\Escritorio\\some-path'
    status: 200,
    message: 'ok'
  }]

Con mdLinks <path-to-file> --stats:

$ md-links ./some/example.md --stats
{ Total: 3, Unique: 3 }

Con mdLinks <path-to-file> --stats -validate:

$ mdLinks ./some/example.md --stats --validate
{ Total: 3, Unique: 3, Broken: 2 }

*Recuerda que esta librería esta diseñada para leer archivos unicos o directorios completos.