Link Checking

Jump to bottom Edit New page

davewilks edited this page Sep 21, 2017 · 3 revisions

We use HTML Proofer.

Setup

The gemfile in devportal should already have the required gems:

gem 'rake'
gem 'html-proofer'

To install, run

bundle exec jekyll build

Check Links

Navigate to devportal, and then run:

bundle exec htmlproofer ./_site --allow-hash-href

Here's a great command that will result in a concise list (I can't get the comma spearated list of --file-ignore to work 😬:

bundle exec htmlproofer --allow-hash-href --http-status-ignore 302 --url-ignore "/cl.ly/,/apps.twitter/,/weebly.com/" --file-ignore "./_site/docs/guides/home.html,./_site/search/index.html" ./_site

False Hits

guides/elements/instances.html shows an incorrect error that it can't find /../../assets/img/elements/element-instance.png.
Docs with API/UI switches will always error.
Anything in ./_site/search/index.html