mlemus-md-links
[Markdown](https://es.wikipedia.org/wiki/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 fo
Last updated a month ago by marineslemus007 .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install mlemus-md-links 
SYNC missed versions from official npm registry.

Markdown Links, mlemus-md-links

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.

Introducción

Node.js es un entorno de ejecución para JavaScript construido con el motor de JavaScript V8 de Chrome. Esto nos va a permitir ejecutar JavaScript en el entorno del sistema operativo, ya sea tu máquina o un servidor, lo cual nos abre las puertas para poder interactuar con el sistema en sí, archivos, redes, ...

En este proyecto nos alejamos un poco del navegador para construir un programa que se ejecute usando Node.js, donde aprenderemos sobre cómo interactuar con el sistema archivos, con el entorno (proceso, env, stdin/stdout/stderr), ...

Objetivos

El objetivo práctico de este proyecto era aorender a cómo crear una librería (o biblioteca - library) en JavaScript.

Estructura del programa

El programa se estructura de la siguiente manera:

imagen-uno Imagen 1. Diagrama de flujo del programa.

La ruta ingresada por el usuario comienza a ser evaluada para saber si ésta es un directorio o si es un archivo. Los archivos Markdown encontrados serán evaluados para capturar sus links. Según la opción ingresada por el usuario se obtendrá diferente información que será mostrada en el terminal. En dado caso que el usuario no ingrese opciones, hay una opción por default que entregará información básica de los links evaluados.

Instalación

Se debe ingresar en consola el siguiente comando:

npm i mlemus-md-links

Guía de uso

Leer un archivo

md-links file.md

Al ingresar solo la ruta, el usuario recibirá:

  • file,
  • href y
  • text

Tal como indica la siguiente imagen

imagen-dos Imagen 2. Opción por default.

Options

-- validate

Al usar la opción --validate podrás obtener:

  • file,
  • href,
  • status,
  • statusText y
  • text

imagen-tres Imagen 3. Opción validate

-- stats

Con --stats podrás obtener:

  • links TOTALES y
  • UNIQUES

imagen-cuatro Imagen 4. Opción stats.

--stats --validate

--stats --validate

Con este combo puedes obtener:

  • links TOTALES,
  • UNIQUES y
  • BROKEN

imagen-cinco Imagen 5. Opción stats y validate.

Leer un directorio

md-links directory.md

Al ingresar solo la ruta, el usuario recibirá:

  • file,
  • href y
  • text

Tal como indica la siguiente imagen

imagen-seis Imagen 6. Opción por default.

Options

-- validate

Al usar la opción --validate podrás obtener:

  • file,
  • href,
  • status,
  • statusText y
  • text

imagen-siete Imagen 7. Opción validate

-- stats

Con --stats podrás obtener:

  • links TOTALES y
  • UNIQUES

imagen-ocho Imagen 8. Opción stats.

--stats --validate

--stats --validate

Con este combo puedes obtener:

  • links TOTALES,
  • UNIQUES y
  • BROKEN

imagen-nueve Imagen 9. Opción stats y validate.

Planificación

Este proyecto se planificó en un tiempo de un poco más de dos semanas.

Se usó Trello(dale click) para organizar el tiempo.

Documentación técnica

Dependencias:

  • chalk
  • eslint
  • eslint-plugin-jest
  • filehound
  • jest
  • marked
  • node-fetch

Current Tags

  • 0.1.4                                ...           latest (a month ago)

5 Versions

  • 0.1.4                                ...           a month ago
  • 0.1.3                                ...           a month ago
  • 0.1.2                                ...           a month ago
  • 0.1.1                                ...           2 months ago
  • 0.1.0                                ...           2 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 5
Last Day 0
Last Week 5
Last Month 76
Dependencies (7)
Dev Dependencies (0)
None
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |