La librería md-links
-creada con Node.js- se encarga de leer y analizar los archivos en formato
Markdown para verificar los links que contengan y reportar algunas estadísticas, ya que muchos de estos links pueden encontrarse rotos o ya no son válidos y perjudican el valor de la información que se desea compartir.
Puede instalarse de la siguiente forma:
$ npm i --global thainole/LIM014-mdlinks
En la línea de interfaz de comando (CLI), se coloca lo siguiente:
md-links <path-to-file> [options]
Si solo se coloca la ruta sin opciones, retornará el file, href y text de cada uno de los links encontrados.
Si se coloca la opción --stats
, el resultado serán el total de links encontrados y los links únicos (sin repetir).
Si se coloca la opción --validate
, retornará el file, href y el texto de los links encontrados, además del status (200, 404, 500) y su mensaje respectivo (ok o fail).
Si se colocan ambas opciones (--stats --validate
), arrojará la cantidad total de links, así como de los links sin repetir y de los que estén rotos.
En caso se coloque alguna otra opción no válida, la consola arrojará lo siguiente:
Y si se intenta con la opción --help
, se mostrará para qué sirve cada una de las opciones a insertar en el CLI.
Para poder realizar esta librería, se realizaron 2 diagramas de flujo para cada tipo: uno del API donde se pondrían las funciones principales, y uno para el CLI con los resultados que saldrían al colocar o no ciertas opciones.