md-links-mayrag v0.1.1
Markdown Links
Índice
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.
Dentro de una comunidad de código abierto, nos han propuesto crear una
herramienta usando Node.js, que lea y analice archivos
en formato Markdown
, para verificar los links que contengan y reportar
algunas estadísticas.
2. Resumen del proyecto
Este proyecto tiene como finalidad la verificaciòn de los links que se encuentren en formato Markdown, facilitando tambien un reporte de la cantidad de links validos, unicos o rotos (broken). Utilizando Node.js con entorno de desarrollo JavaScript
3. Guia de uso e instalación de la libreria
Instalación
Para realizar la instalación de la libreria sigue los siguientes pasos:
- En la terminal de tu editor de codigo busca el directorio de tu proyecto
- Ejecuta el siguiente comando:
npm i md-links-mayrag
Modo de Uso:
Para ejecutar las funciones de la librería puedes usar los siguientes comandos desde tu editor de codigo:
Ejecutando el comando:
npm run validate
el cual retornara las siguiente información:text
: Texto que aparece dentro del linkurl
: URL encontradaabsolutePath
: Ruta del archivo donde se encuentra el linkstatusCode
: Codigo de respuesta HTTPok
: Mensaje defail
en caso de fallo uok
en caso de exitoEjecutando el comando:
npm run stats
el cual retorna la siguiente información:Total
: Número de links encontradosUnique
: Número de links unicos (Que no se repiten).Ejecutando el comando:
npm run all
el cual retorna la siguiente información:Total
: Número de links encontradosUnique
:Número de links unicos (Que no se repiten)Broken
:Número de link rotosEjecutando el comando:
npm run none
el cual retorna la siguiente información:text
:Texto que aparece dentro del linkurl
: URL encontradaabsolutePath
: Ruta del archivo donde se encuentra el link
4. Despliegue en NPM
Link de despliegue en https://www.npmjs.com/package/md-links-mayrag