mdLinks(path, options), es una librería que busca y analiza, en archivos con extensión ".md" las url's existentes y el texto que les acompaña.
-
path
: Ruta absoluta o relativa al archivo o actual directorio ( current working directory). -
options
:--validate
: Devuelve por consola un listado con:- File: ruta absoluta del archivo .md que se leyó,
- href: url encontrada
- Status: "ok" o "failed"
- Status Code: código de status - destacando en rojo las url's rotas -
- Text: texto que acompaña a url
- Line: número de línea dentro del archivo de procedencia
- Se destaca en color rojo aquellas url's que no están rotas
-- stats
: Devuelve por consola:- Total de url's encontradas (Total)
- Número de url's únicas encontradas (Unique)
--validate
--stats
: Devuelve por consola:- Total de url's encontradas (Total)
- Total de url's únicas encontradas (Unique)
- Total de url's rotas (Broken)
Sin selección de las opciones anteriores.
Devuelve por consola un listado con:
- File: ruta absoluta del archivo .md que se leyó,
- href: url encontradas
- Text: texto que acompaña a url
- Line: número de línea dentro del archivo de procedencia
[1] Lee sólo archivos con extensión ".md"
[2] Si no se escribe el "path", lee y analiza todos los archivos que se encuentren en el directorio donde se ejecuta.
- $ npm install node-fetch -g
- $ npm install chalk install chalk -g
- $ npm install minimist -g
-
Para instalar la librería desde la terminal, situada en el directorio de tu proyecto,escribe el siguiente comando $npm install https://github.com/npgonzalez/SCL012-MD-links- (Si deseas que la instalación sea global, agrega '-g' al final del comando anterior)
-
Para obtener los links, escribe el comando:
node index < ruta de tu archivo>
-
Para usar la opción "--validate" escribe lo siguiente:
node index < ruta de tu archivo> --validate
-
Para usar la opción "--stats" escribe lo siguiente:
node index < ruta de tu archivo> --validate
-
Para usar las opciones "--validate y "--stats", al mismo tiempo escribe lo siguiente:
node index < ruta de tu archivo> --validate --stats
-
Si quieres analizar todos tus archivos .md existentes en tu directorio actual no ingreses el path; de igual modo, sí puedes usar las opciones antes mencionadas
En la próxima versión se espera incluir testeo de las funciones.
- Java Script
- node.js
- npm