KarenAmicone / CDMX007-fe-md-links

This package can be install via "npm i your-md-links" in your local repo
https://www.npmjs.com/package/your-md-links
0 stars 0 forks source link

Your-md-links :mag:

your-md-links es una herramienta que lee y analiza archivos Markdown (.md) para identificar los links que contiene y verificarlos, con el fin de reportar el número de links únicos y su estado de respuesta :bar_chart:.

La librería cuenta con las siguientes opciones de validación [options]:

--validatedevuelve un arreglo de objetos de todos los links únicos del archivo, que contienen la ruta, el link y su estado de respuesta :white_check_mark:.

--statsdevuleve el número total de links y el total de links únicos :chart_with_upwards_trend:.

--stats --validatedevuelve el número total de links, y de links únicos por grupos de estado de respuesta :bookmark_tabs:.

Instrucciones de uso

  1. Abre tu terminal :computer: o shell :shell:. Si usas un sistema operativo "UNIX-like", como GNU/Linux o MacOS, ya tienes una shell (terminal) instalada por defecto (y probablemente git también). Si usas Windows puedes usar Git bash. De preferencia, abre el respositorio o directorio en el que se encuentra el archivo .md que quieres analizar.

  2. Instalar Node.js (que incluye npm) si aún no lo has hecho.

  3. Instala la librería con el comando npm i your-md-links.

  4. Para ejecutar el programa deberás escribir el comando your-md-links, seguido de la ruta del archivo .md y las opciones de validación que deseas ejecutar. Ejemplo:

    your-md-links ./documents/proyecto --stats

Consideraciones de uso

  1. Si en la terminal estás posicionada(o) en el repositorio o directorio :open_file_folder: que contiene el archivo .md que deseas analizar, no es necesario proporcionar una ruta, así que sólo tendrás que ejecutar your-md-links [options].

  2. Por el contrario, si en la terminal no has abierto la carpeta del archivo, tendrás que proporcionar la ruta del mismo seguida de las opciones.

  3. Si tienes más de un archivo .md en la ruta proporcionada, el programa analizará todos los markdown.

Códigos de estado de respuesta

Respuestas informativas

Code Status Text
100 Continue
101 Switching Protocols
102 Processing

Respuestas satisfactorias

Code Status Text
200 OK
201 Created
202 Accepted
203 Non Authoritative Information
204 No Content
205 Reset Content
206 Partial Content
207 Multi-Status

Redirecciones

Code Status Text
300 Multiple Choices
301 Moved Permanently
302 Moved Temporarily
303 See Other
304 Not Modified
305 Use Proxy
307 Temporary Redirect
308 Permanent Redirect

Errores de cliente

Code Status Text
400 Bad Request
401 Unauthorized
402 Payment Required
403 Forbidden
404 Not Found
405 Method Not Allowed
406 Not Acceptable
407 Proxy Authentication Required
408 Request Timeout
409 Conflict
410 Gone
411 Length Required
412 Precondition Failed
413 Request Entity Too Large
414 Request-URI Too Long
415 Unsupported Media Type
416 Requested Range Not Satisfiable
417 Expectation Failed
418 I'm a teapot
419 Insufficient Space on Resource
420 Method Failure
422 Unprocessable Entity
423 Locked
424 Failed Dependency
428 Precondition Required
429 Too Many Requests
431 Request Header Fields Too Large

Errores de servidor

Code Status Text
500 Server Error
501 Not Implemented
502 Bad Gateway
503 Service Unavailable
504 Gateway Timeout
505 HTTP Version Not Supported
507 Insufficient Storage
511 Network Authentication Required