@carolgmonteiro/md-links
Software that analizes links from markdown files
Last updated 9 months ago by carolgmonteiro .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @carolgmonteiro/md-links 
SYNC missed versions from official npm registry.

Md-Links | Libreria para extraer links de archivos Markdown

Markdown es un lenguaje de marcado ligero muy popular entre developers. Es usado en muchas 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.

La libreria, que está en el idioma inglés, fue creada usando Node.js, e su función es leer y analizar archivos en formato Markdown desde el input de un unico archivo hasta un directorio. Extrae links de los archivos y los verifica el status de los links y saca estadísticas cómo total de links, links que no funcionan y unicos.

Guía de Uso e Instalación

Instalación

const mdLinks = require("cgm-md-links");

Con el comando npm install cgm-md-links podemos instalar directamente. Ver docs oficiales de npm install acá.

npm install cgm-md-links

Como usar

En el archivo JS:

const mdlinks = require("cgm-md-links");

Cómo llamar a libreria desde la terminal:

  • Para path-to-file igual a un Directorio
md-links <"path-to-directory"> [options]
  • Para path-to-file igual a un archivo
md-links <"path-to-file"> [options]

CLI (Command Line Interface)

La libreria hace las seguientes entregas:

1. El usuario no elije ninguna opción y recibe los links extraiedos de los archivos analizados

2. Elije las opciones disponibles:

  • stats (dados estadisticos de los links)
  • validate (status de los links en la red)
  • stats validate (dados estadisticos del status de los links)

PATH

  • Leer archivos con extensión .md

md-links <file.md>

SIN-OP-FILE

  • Leer un directorio

md-links <"path-to-directory">

SIN-OP-DIRECTORY

En ambos casos, se obtiene como resultado:

  • file: archivo o ruta donde fue encontrado el link.
  • text: descripción del link.
  • href: link encontrado.

OPTIONS

--validate

Entrega la validacion o status de los links (status: 200, 300, 404, 500 etc).

Usar así md-links <"path-to-file"> --stats

VALIDATE-OP-FILE

--stats

Entrega las seguientes estadísticas de los links: Total - el total de links encontrados; Unique - el total de links unicos.

Usar así md-links <"path-to-directory"> --stats --validate md-links <"path-to-file"> --stats --stats | --s

STATS-OP-FILE

--stats --validate

Entrega las seguientes estadísticas de los links: Total - el total de links encontrados; Unique - el total de links unicos. Broken - el total de links rotos;

Usar así md-links <"path-to-directory"> --stats --validate md-links <"path-to-file"> --stats --validate --stats --validate | --validate --stats | --s --v | --v --s

STATS-VALIDATE-OP-FILE


Documentación técnica

Dependencias:

  • node.js versión 11
  • "chalk": "^2.4.2"
  • "fetch": "^1.1.0"
  • "filehound": "^1.17.3"
  • "marked": "^0.7.0",
  • "node-fetch": "^2.6.0"
  • "eslint": "^6.2.1",
  • "eslint-plugin-jest": "^22.15.2",
  • "jest": "^24.9.0"

Planificación:

Diagrama de Flujo

Slide2

Trello

El board con el backlog de la implementación de la librería puede ser encontrado aquí. Slide11

Milestones del proyecto

El proyecto fue ordenado en milestones en trello, recorriendo cada parte del diagrama de flujo

Slide3 Slide4 Slide5 Slide6 Slide7 Slide8 Slide9 Slide10 Slide11 Slide12


Autora

Carolina Guido Monteiro Desarrolladora Front-end


Current Tags

  • 1.0.0                                ...           latest (9 months ago)

1 Versions

  • 1.0.0                                ...           9 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 2
Last Day 0
Last Week 1
Last Month 0
Dependencies (6)
Dev Dependencies (3)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |