Librería gabrielac3-md-links

Índice

• 1. Descripción del módulo
• 2. Diagrama de Flujo
• 3. Instrucciones de Instalación
• 4. Documentación
• 5. Ejemplos
• 6. Developer

1. Descripción del módulo

gabrielac3-md-links es una librería desarrollada en JavaScript y node.js que lee y analiza archivos en formato Markdown, para verificar los links que contengan y devuelve algunas estadísticas.

2. Diagrama de Flujo

Diagrama de Flujo de API md-links

Diagrama de Flujo de CLI md-links

3. Instrucciones de Instalación

Para instalar la librería debe ejecutar lo siguiente:

npm i gabrielac3-md-links

4. Documentación

La librería puede ejecutarse de la siguiente manera a través de la terminal:

md-links <path-to-file> [options]

En el caso de que ingrese como argumento solo la ruta (path), la librería indentificará los archivos markdown, analizará el archivo Markdown e imprimirá los links que vaya encontrando, junto con la ruta del archivo donde aparece y el texto que hay dentro del link (truncado a 50 caracteres).

**Salida:**
file:
href:
text:

Options

--validate

Si se ingresa como segundo argumento la opción --validate, el módulo debe hará 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 se considera el link como ok.

El output en este caso incluirá la palabra ok o fail después de la URL, así como el status de la respuesta recibida a la petición HTTP a dicha URL.

**Salida:**
file:
href:
ok:
status:
text:

--stats

Si se ingresa como argumento la opción --stats el output (salida) será un texto con estadísticas básicas sobre los links.

Número total de links
Número de links únicos

También podemos combinar --stats y --validate para obtener estadísticas que necesiten de los resultados de la validación.

Número total de links
Número de links únicos
Número de links rotos

5. Ejemplos

En el caso de ingresar solo la ruta:

md-links <path-to-file> [options]

Options

--validate

--stats

--validate --stats

--help

sin argumentos

6. Developer

Gabriela Córdova