markdown-links-finder v1.0.1
Proyecto - Markdown-links-finder
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.
En respuesta a esta petición nace "Markdown-links-finder", librería de Node.js que permite al usuario, por medio de comandos, leer y analizar archivos con extensión ".md". La finalidad de esta librería es que al revisar una ruta o el nombre de un archivo, recibamos todos los links que se encuentran en el archivo, además del texto incluido y por medio de un nuevo comando, conocemos el estado de estos links, ya 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.
Características generales de "Markdown-links-finder"
Encuentra (lee) los archivos con extensión ".md". Muestra en la terminal todos los links encontrados en el archivo, además de su texto y la ruta. *Por medio del comando --validate, muestra el estado de los links.
Instalación
Primero que todo para instalar esta librería debe tener instalado Node.js.
Posteriormente, debe ejecutar los siguientes comandos en la terminal:
Instalación de dependencias:
marked:
- $npm install --save marked
node-fetch:
- $ npm install node-fetch --save
colors:
- npm install colors
Instalación de "Markdown-links-finder":
Para implementar esta librería debes ingresar el siguiente comando:
- npm install markdown-links-finder
Uso
Para ejecutar la librería deber usar los siguientes comandos:
$ md-links <ruta-de-archivo> o $ mdlinks <nombre-de-archivo.md>
Ejemplo de uso:
md-links $C:\Users\CaroloFantasma\Documents\scl-2018-01-FE-markdown\README.md
/posicionarse-en-la-ruta-del-archivo/ md-links README.md
Resultado md-links:
href
: URL encontrada.text
: Texto que aparecía dentro del link (<a>
).file
: Ruta del archivo donde se encontró el link.
$ md-links <ruta-de-archivo> --validate o $ mdlinks <nombre-de-archivo.md> --validate
Ejemplo de uso:
md-links $C:\Users\CaroloFantasma\Documents\scl-2018-01-FE-markdown\README.md --validate
/posicionarse-en-la-ruta-del-archivo/ md-links README.md --validate
Resultado --validate:
Ruta:https://www.google.com/ 200 OK
Ruta:https://github.com/CaroFantasma 404 Not Found
Versión
Markdown-links-finder se encuentra en su versión 1.0.1, que incluye:
- Lectura de archivos ".md"
- Ruta
- Nombre de archivo
- Links
- Texto de links
- Validación de links con --validate
Documentación utilizada para crear este proyecto:
- NPM
- Publicar packpage
- Crear módulos en Node.js
- Leer un archivo
- Leer un Directorio
- Path
- Node.js file system - Documentación oficial
- Node.js http.get - Documentación oficial
- Node.js - Wikipedia
- What exactly is Node.js? - freeCodeCamp
- ¿Qué es Node.js y para qué sirve? - drauta.com
- ¿Qué es Nodejs? Javascript en el Servidor - Fazt en YouTube
- ¿Simplemente qué es Node.js? - IBM Developer Works, 2011
Planificación
En lugar de utilizar issues y milestones, se decidió utilizar Trello para planificar este proyecto, puede revisar la planificación en el siguiente link:
Planificación de Markdown-links-finder
NPM
Autor
Carolina Lastra Cofré