Skip to content

Librería que identifica y/o valida vía HTTP los links de los archivos .md del directorio/archivo solicitados.

Notifications You must be signed in to change notification settings

arelyweb/DEV008-md-links

 
 

Repository files navigation

Markdown Links

Índice


1. Preámbulo

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.

2. Resumen del proyecto

Es un proyecto en linea de comando ejecutado en Node.js que instala una librería, la cual permite realizar un barrido a la ruta ingresada y buscar los archivos .md y validar vía HTTP cada link del archivo en caso de requerirlo, de lo contrario solo muestra los links que encontró.

3. Intalación de librería

Para la instalación de la librería se deberá ejecutar el suguiente comando:

  • Desde consola
npm i arrely.web-md-links

4. Uso de la librería

El módulo ofrece dos procesos: validar y/u obtener estadísticas de los links.

md-links <path> [options]

Argumentos
  • path: Se ingresa la ruta absoluta o relativa al archivo o al directorio.
  • options: Solo se acepta la siguiente opción:
    • -vl o --validate: Determina si se desea validar via HTTP los links encontrados.
    • -s o --stats: Determina si se desea validar via HTTP los links encontrados.
    • -vl -s o --validate --stats: Muestra el conteo del total, los links únicos y los links inválidos.
Valor de retorno

En caso de recibir solo la ruta solo mostrará en consola los siguientes datos para cada link encontrado :

  • href: URL encontrada.
  • text: Título del link.
  • file: Ruta del archivo donde se encontró el link.

En caso de recibir -vl o --validate mostrará en consola los siguientes datos para cada link encontrado :

  • href: URL encontrada.
  • text: Título del link.
  • file: Ruta del archivo donde se encontró el link.
  • status: Código de respuesta HTTP.
  • ok: Mensaje fail en caso de fallo u ok en caso de éxito.

En caso de recibir -s o --stats mostrará las estadísticas en consola :

  • Total: Total de liks encontrados en la ruta.
  • Unique: Total de links únicos encotrados en la ruta.

En caso de recibir -vl -s o --validate --stats mostrará las estadísticas en consola :

  • Total: Total de liks encontrados en la ruta.
  • Unique: Total de links únicos encotrados en la ruta.
  • Broken: Total de links rotos encotrados en la ruta.
Ejemplos
$ md-links ./some/example.md
./some/example.md http://algo.com/2/3/ Link a algo
./some/example.md https://otra-cosa.net/algun-doc.html algún doc
./some/example.md http://google.com/ Google
Options
--validate
$ md-links ./some/example.md --validate
./some/example.md http://algo.com/2/3/ ok 200 Link a algo
./some/example.md https://otra-cosa.net/algun-doc.html fail 404 algún doc
./some/example.md http://google.com/ ok 301 Google
--stats
$ md-links ./some/example.md --stats
Total: 3
Unique: 3
--validate y --stats
$ md-links ./some/example.md --stats --validate
Total: 3
Unique: 3
Broken: 1

About

Librería que identifica y/o valida vía HTTP los links de los archivos .md del directorio/archivo solicitados.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%