pklaschka/ssblc

Static Site Broken Link Chacker: A broken-link checker for static sites, like the ones generated with docsify

@pklachka/ssblc

Static Site Broken Link Checker

A broken-link checker for static sites, like the ones generated with docsify that can get used, for example, for CI purposes on docsify docs (this is what I've developed it for).

It recursively checks internal links found on the static website (until every internal link is checked) and (without recursion) outgoing links. This is achieved by finding href attributes in the HTML, meaning also stylesheets included with <link href="some-file.css"> get checked.

Installation

You can either run it by just using npx, in which case you won't have to install it, or first install it with

npm install -g @pklaschka/ssblc

Usage

When you are in the folder of your static website (i.e., there is an index.html in this folder), simply run

ssblc

after which the checker will begin its work.

To use it with npx, simply run

npx @pklaschka/ssblc

Alternatively, you can also specify an absolute or relative path to the directory of the site, e.g., like this:

ssblc ../my-site

ssblc's Issues

Add tests

Add unit tests (ideally with a test coverage of 100%) to the project, as for usage in CI, developers have to trust that the tool works completely every time it's used

content.matchAll is not a function

Running this on my docs folder, I get an error.

$ ssblc
Running at http://localhost:3000

0/0	 Checking link:  http://localhost:3000/
Something didn't quite work as expected:  content.matchAll is not a function
ferozed:~/stash/ops/docs (main)

Here is my directory listing

$ ls
README.md			_sidebar.md			apple-touch-icon.png		index.html
_coverpage.md			alpha				favicon-16x16.png		site.webmanifest
_footer.md			android-chrome-192x192.png	favicon-32x32.png		v1
_navbar.md			android-chrome-512x512.png	favicon.ico