1.0.0 • Published 2 years ago
md-links-mssroxy v1.0.0
Markdown Links
Índice
1. Introducción a mdLinks
Los archivos markdown son un lenguaje de marcado ligero muy popular entre developers, estos 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.
La librería mdLinks permite leer y analizar archivos en formato Markdown
, para verificar los links que contengan y reportar algunas estadísticas.
2. Instalación
Para la instalación de la librería deberá escribir el siguiente comando en la terminal:
Una vez instalada ya puede empezar a usarla.
3. Guía de uso
Para hacer uso de la librería escriba la siguiente línea de comando:
md-links <path-to-file> --validate --stats
Donde:
md-links
hace el llamado a la librería<path-to-file>
es la ruta hacia el archivo o directorio que se quiere analizar (recuerde que sólo se leen archivos markdown)--validate
argumento que puede estar presente(true) o no (false)--stats
se comporta igual al anterior
Retornos
<path-to-file>
: no ingresa ninguna opción, no se realiza ninguna validación
href
: URL encontrada.text
: Texto que aparecía dentro del link (<a>
).file
: Ruta del archivo donde se encontró el link.
<path-to-file> --validate
o <path-to-file> --v
: se solicita validación de cada link encontrado
href
: URL encontrada.text
: Texto que aparecía dentro del link (<a>
).file
: Ruta del archivo donde se encontró el link.status
: Código de respuesta HTTP.ok
: Mensajefail
en caso de fallo uok
en caso de éxito.
<path-to-file> --stats
o <path-to-file> --s
: se solicita estadísticas de los links
Total
: Cantidad de links encontradosUnique
: Cantidad de links únicos
<path-to-file> --validate --stats
o <path-to-file> --v --s
: se solicita validación y estadísticas de los links
Total
: Cantidad de links encontradosUnique
: Cantidad de links únicosBroken
: Cantidad de links rotos encontrados
Consideraciones
- Se aceptan rutas absolutas o relativas (recuerde que si es relativa se resuelve como relativa al directorio desde donde se invoca node)
- Si se ejecuta en windows se recomienda el uso de la terminal GitBash con el
<path-to-file>
entre comillas
4. Recursos
- Si desea saber más sobre la ruta de trabajo utilizada, puede hacerlo a través del flujograma de procesos desarrolado en Figma
- Autor: Roxy Solano (Laboratoria - Cohort BOG-004)
1.0.0
2 years ago