- 1. ¿Qué es md-links?
- 2. ¿Cómo instalar?
- 3. ¿Cómo usar?
- 4. Resultados
- 5. Testing
- 6. Diagrama de flujo
- 7. Autora
Es una herramienta con una librería instalable que implementa una interfaz de línea de comandos (CLI) para facilitar la validación de archivos Markdown (md) y extraer los enlaces que se encuentran en ellos, también permite verificar si los archivos .md encontrados tienen links y si estos estan funcionando correcatamente o no.
Para instalar la libreria siga los siguientes pasos:
- Abra la terminal del sistema operativo de la pc.
- Navegue hasta el directorio raíz del proyecto o la ubicación donde desea instalar la biblioteca.
- Ejecute el siguiente comando en la terminal para instalar la biblioteca desde el registro del paquete npm:
npm install md-roquelinks
- Una vez la instalación esté completa, puede importar y usar la biblioteca en el proyecto que así lo desee de acuerdo a las instrucciones de uso a continuación.
Para obtener instrucciones sobre cómo utilizar el comando completo, ejecute 'md-links'.
md-links
Una vez instalado, debe colocar en la terminal lo siguiente:
md-links <path-to-file> [opciones]
donde:
path-to-file = es la ruta que requiere analizar (absoluta o relativa).
Puede utilizar las siguientes opciones adicionales para realizar validaciones u obtener estadísticas de enlaces:
Ingrese:
--validate
Esta opción permite validar los enlaces encontrados, verifica si están activos y accesibles y devuelve información sobre el estado de cada enlace.
ejemplo:
md-links --validate
Ingrese:
--stats
esta opción muestra estadísticas generales sobre los enlaces encontrados como el recuento total de enlaces.
ejemplo:
md-links --stats
Ingrese:
-- validate --stats
Esta opción que surge de la combinación de las opciones anteriores permite buscar enlaces, validarlos y obtener estadísticas al mismo tiempo.
ejemplo:
md-links --validate --stats
md-links --stats --validate
Al de ejecutar el comando con las opciones correspondientes y la ruta del archivo que desee evaluar, el paquete "md-links" mostrará la información requerida en la línea de comando, incluyendo los enlaces encontrados, su estado y estadísticas generales.
Se realizaron pruebas unitarias para la verificación del correcto funcionamiento de los siguientes archivos JS: index, modules y stats. Se obtuvo el siguiente resultado:
