- Markdown Links
Este biblioteca auxilia os usuários a encontrarem links dentro de arquivos com extensão .md
.
Pré-requisitos:
- instalação do noje.js versão >16;
- instalação do gitbash para utiliza-lo como ambiente de execução.
Para instalar utilize o comando:
$ npm install helouiseitokazo-md-links
O módulo oferece a seguinte interface:
mdLinks(path, options)
-
path
: Rota absoluta ou relativa ao arquivo ou diretório. -
options
: Um objeto com a seguinte propriedade:-
validate
: Um booleano que determina se deseja validar os links encontrados. -
stats
: Booleano que determina se deseja obter um output com informações estatísticas gerais.
-
A função retorna uma promessa (Promise
) que
resolve um array (Array
) de objetos (Object
), onde cada objeto representa um link, contendo as seguintes propriedades:
Apenas com o parâmetro path
:
-
link
: URL encontrada. -
label
: Texto que faz referência ao link. -
path
: Rota do arquivo onde foi encontrado o link.
Com os parâmetros: path
e validate:true
:
-
link
: URL encontrada. -
label
: Texto que faz referência ao link. -
path
: Rota do arquivo onde foi encontrado o link. -
status
: Código de resposta HTTP. -
msg
: Mensagemfail
em caso de falha ouok
em caso de sucesso.
Com os parâmetros: path
e stats:true
:
-
link
: URL encontrada. -
label
: Texto que faz referência ao link. -
path
: Rota do arquivo onde foi encontrado o link. -
status
: Código de resposta HTTP. -
msg
: Mensagemfail
em caso de falha ouok
em caso de sucesso. -
total
: Número total de links encontrados. -
unique
: Número de links que não se repetem.
Com os parâmetros: path
, stats:true
e validare:true
:
-
link
: URL encontrada. -
label
: Texto que faz referência ao link. -
path
: Rota do arquivo onde foi encontrado o link. -
status
: Código de resposta HTTP. -
msg
: Mensagemfail
em caso de falha ouok
em caso de sucesso. -
total
: Número total de links encontrados. -
unique
: Número de links que não se repetem subtraindo os links quebrados. -
broken
: Quantidade de links quebrados.
A lib deve ser usada no terminal via linha de comando, recomendamos a utilização do gitbash para evitar problemas de permissão.
Existem quatro formas de buscar por links dentro de arquivos .md usando esta lib, são elas:
O Markdown Links utiliza o comando md-links para fazer a busca e recebe como parâmetro o path
absoluto ou relativo.
Exemplo de utilização do comando:
$ md-links ./path/arquivo.md
Exemplo de retorno que será exibido no terminal:
Path: path/arquivo.md
Label: Markdown
Link: https://pt.wikipedia.org/wiki/Markdown
Path: path/arquivo.md
Label: Exemplo
Link: https://pt.exemplo.org/wiki/Exemplo
Cenário 1: md-links executado apenas com o parâmetro path
Pré-requisito: inserir um path válido.
Exemplo de utilização do comando:
$ md-links ./path/arquivo.md --validate
Exemplo de retorno que será exibido no terminal:
Path: path/arquivo.md
Label: Markdown
Link: https://pt.wikipedia.org/wiki/Markdown
Status: 200
Msg: Ok!
Path: path/arquivo.md
Label: Exemplo
Link: https://pt.exemplo.org/wiki/Exemplo
Status: 404
Msg: Fail!
Cenário 2: md-links executado com os parâmetros path e --validate
Pré-requisito: inserir um path válido.
Exemplo de utilização do comando:
$ md-links ./path/arquivo.md --stats
Exemplo de retorno que será exibido no terminal:
Path: path/arquivo.md
Label: Markdown
Link: https://pt.wikipedia.org/wiki/Markdown
Status: 200
Msg: Ok!
Path: path/arquivo.md
Label: Exemplo
Link: https://pt.exemplo.org/wiki/Exemplo
Status: 404
Msg: Fail!
Total: 2
Unique: 2
Cenário 3: md-links executado com os parâmetros path e --stats
Pré-requisito: inserir um path válido.
Exemplo de utilização do comando:
$ md-links ./path/arquivo.md --stats --validate
Exemplo de retorno que será exibido no terminal:
Path: path/arquivo.md
Label: Markdown
Link: https://pt.wikipedia.org/wiki/Markdown
Status: 200
Msg: Ok!
Path: path/arquivo.md
Label: Exemplo
Link: https://pt.exemplo.org/wiki/Exemplo
Status: 404
Msg: Fail!
Total: 2
Unique: 1
Broken: 1
Cenário 4: md-links executado com os parâmetros path. --stats e --validate
Pré-requisito: inserir um path válido.