Libreria desarrollada para extraer los links de un archivo de tipo markdown, el usuario puede ingresar ya sea la ruta absoluta o relativa del archivo que desea evaluar, tambien puede verificar si los links econtrados estan rotos o no.
Antes de utilizar esta libreria es necesario instalar las dependencias que utiliza para su correcto desempeño.
En primera instancia es necesario tener instalado Node.js y npm, para verificarlo nos colocamos en la terminal y ejecutamos este comando:
nodejs-v
si no esta instalado, puedes instalarlo según tu sistema operativo desde acá: [Node.js] (https://nodejs.org/en/download/). Una vez instalado node, instalamos npm:
install npm
Ahora instalamos las demás dependencias, estas pueden instalarse ya sea de manera global:
$npm install marked --global
$npm install node-fetch --global
Ó como dependencia del proyecto instalandolas directamente en la carpeta contenedora del proyecto:
$npm install marked --save
$npm install node-fetch --save
La libreria se instala directamente desde la terminal con npm
$ npm install mDownLinks --save
Una vez instalado en la terminal o añadido como modulo al proyecto hay 2 maneras de utilizar la libreria:
1️⃣ Puede utilizarse ingresando una ruta absoluta donde se encuentre el archivo a evaluar:
$ md-links C:/Users/Admin/Documents/PROYECTO/TALLERES
En este caso la libreria verifica si hay un archivo de tipo .md en la dirección especificada, si lo hay mostrará un listado de los links que se encuentren en el.
2️⃣ Tambien puede utilizarse ingresando la ruta relativa y nombre del archivo a evaluar:
$ md-links ./readme2.md
En ambos casos la libreria responderá mostrando un listado con los links encontrados:
En el listado se muestran los siguientes datos de interés: la ruta relativa del archivo, el nombre del archivo que se esta evaluando, la linea en la que se encontró el link, la direccion URL del link y el texto de este.
Ahora, si queremos validar si los links encontrados estan rotos o no, ejecutamos denuevo agregando la opcion --validate
$ md-links C:/Users/Admin/Documents/PROYECTO/TALLERES --validate
Ó
$ md-links ./readme2.md --validate
Nos mostrará lo siguiente:
Donde se agrega al listado el status de los links:
🙆♀️ Ok si los links son validos.
🙅 Fail si estan rotos.
Información utilizada para crear la libreria
- Node.js - Documentacion node (español).
- FileSystem - Modulo File System Node (español).
- Modulos npm - Como crear Librerias.
- npm - Publicación de Modulos con NPM.
- Markdown - Estructura de los archivos Markdown.
Link directo a la libreria en npm Libreria mDownLinks npm
Para la realización del proyecto se siguió el modelo Kanban, dividiendo la historia de usuario en tareas y así optimizando mejor los tiempos y sprints. Puede verificar la organización acá: Modelo Kanban mDownLinks - Organización del Proyecto.