raquelburgos-md-links

0.1.1 • Public • Published

Markdown links

Índice

1. Resumen del proyecto

Creación de una herramienta de línea de comando (CLI) así como una librería (o biblioteca - library) en JavaScript, que lea y analice archivos en formato Markdown, para verificar los links que contengan y reportar algunas estadísticas.

2. Planeación de sprints

NT. No terminado durante ese sprint.

Sprint 1.

  • [x] Crear diagrama de flujo API
  • [x] Crear diagrama de flujo CLI
  • [x] Existe la ruta
  • [x] Es absoluta la ruta
  • [x] Convertir ruta relativa a absoluta
  • [x] Es directorio

Sprint 2.

Validaciones API.

  • [x] Leer directorio
  • [x] Es archivo .md
  • [x] Leer archivo .md
  • [x] Obtener links

Instalaciones

  • [x] Babel
  • [x] Jest
  • [x] Chalk

Sprint 3.

Validaciones API

  • [x] Petición HTTP para status de links (NT)
  • [x] Petición HTTP para status de links
  • [x] Calculo stats
  • [x] Calculo stats con status

CLI

  • [x] path
  • [x] --validate
  • [x] --stats
  • [x] --validate --stats
  • [x] --help
  • [x] !path
  • [x] Colores con librería chalk

Instalaciones

  • [X] ESLINT

Sprint 4.

Test

  • [x] Función mdLinks

READ ME

  • [x] README

3. Diagramas de flujo

Para la planeación de este proyecto se realizaron dos diagramas de flujo, Uno de los procesos que debe realizar la API y otro de lo que debe realizar el CLI. Diagrama de flujo API

3. Como Realizar la Instalación

Para instalar el módulo, simplemente ejecuta el siguiente comando en la terminal:

$ npm install raquelburgos-md-links

4. Como Utilizarlo

CLI (Command Line Interface - Interfaz de Línea de Comando)

Para utilizar el paquete md-links desde la línea de comando, sigue estos pasos:

  1. Abre la terminal.
  2. Escribe el siguiente comando:
npx md-links <ruta> [opciones]
  • <ruta>: la ruta del archivo que deseas evaluar.
  • [opciones]: selecciona una de las siguientes opciones:

Opciones:

  • --validate: realiza una petición HTTP para verificar si los enlaces funcionan o no.
  • --stats: muestra estadísticas básicas sobre los enlaces.
  • --validate --stats: muestra estadísticas de los enlaces y cuántos de ellos están rotos.

Asegúrate de reemplazar <ruta> por la ruta real de tu archivo Markdown. Esto te permitirá ejecutar el paquete md-links y obtener los resultados correspondientes en la terminal.

Con esta simple línea de comando --validate, el módulo realizará una verificación de los enlaces en tu archivo Markdown y te mostrará el estado de cada uno. De esta manera, podrás identificar aquellos enlaces que no funcionan correctamente y tomar las acciones necesarias para corregirlos.

Si deseas obtener estadísticas básicas sobre los enlaces en tu archivo Markdown, puedes utilizar la opción --stats. Esto te proporcionará información como la cantidad total de enlaces y la cantidad de enlaces únicos presentes en el archivo.

Si deseas obtener estadísticas más detalladas que incluyan el estado de los enlaces, puedes combinar las opciones --stats y --validate. Esto te mostrará cuántos enlaces están rotos o inválidos, brindándote una visión completa de la calidad de los enlaces en tu archivo.

5. Ejemplos de Uso

CLI (Command Line Interface - Interfaz de Línea de Comando)

npx md-links example.md --validate
npx md-links example.md --stats
npx md-links example.md --validate --stats 

¡Con esta herramienta, puedes verificar de forma sencilla y eficiente los enlaces en tus archivos Markdown y obtener valiosa información sobre ellos! Ya no tendrás que preocuparte por enlaces rotos o inválidos en tus documentos Markdown, ya que podrás identificarlos rápidamente.

Package Sidebar

Install

npm i raquelburgos-md-links

Weekly Downloads

4

Version

0.1.1

License

ISC

Unpacked Size

131 kB

Total Files

19

Last publish

Collaborators

  • raquelba