- 1. Introducción
- 2. Resumen del proyecto
- 3. Instalación
- 4. Instrucciones de uso
- 5. Planificación
- 6. Test unitarios
- 7. Referencias
Hola Coders 😎 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.
Es una herramienta de línea de comando (CLI) 💻 una librería (o biblioteca - library) en JavaScript.
Con esta herramienta podrás analizar 🔍 tus archivos Markdown (.md) y verificar ✅ los links encontrados.
Esta librería te dirá que links están en tu archivo, cuál es su estado de validación y estadísticas de cuales links son válidos, únicos y rotos (no válidos).
Debes realizarla por npm:
npm i md-links
Para que la librería :archivador: opere de manera correcta debes ingresar la ruta para analizar, si no ingresas te mostrara el error, aquí unos ejemplos:
Ingresas de esta forma tu ruta
md-links <tu-ruta>
- Ejemplo si no ingresas ruta
- Ejemplo si ingresas una ruta errónea
- Ejemplo ruta correcta
Dentro de la librería tenemos opciones --validate
y --stats
, aquí te muestro su uso.
--validate
Si pasamos la opción --validate
, el módulo hace una petición HTTP para
averiguar si el link funciona o no. Si el link resulta en una redirección a una
URL que responde ok, entonces consideraremos el link como ok.
- Ejemplo
md-links <ruta-ejemplo> --validate
--stats
Si pasamos la opción --stats
el output (salida) será un texto con estadísticas
básicas sobre los links.
- Ejemplo
md-links <ruta-ejemplo> --stats
También podemos combinar --stats --validate
o --validate --stats
para obtener estadísticas que necesiten de los resultados de la validación.
- Ejemplo
md-links <ruta-ejemplo> --stats --validate
md-links <ruta-ejemplo> --validate --stats
Para este proyecto inicie con un Diagrama de Flujo que fue plasmando paso a paso las tareas a realizar dentro del código.
DIAGRAMA DE FLUJO
Ya teniendo las ideas de este proyecto me organice con Trello y Project GitHUb
TRELLO
PROJECT GITHUB
Para este proyecto se realizaron test a todo el módulo de funciones.js
TEST
😉
https://github.com/JoceChile