The reason for dockerizing LinkChecker is to facilitate Praqma’s Gijeli set-up and produce reports for web projects. There are other Docker images of LinkChecker out there, but we find them lacking when it comes to entertaining stable automated builds.
Any change applied to the image will trigger a new Jenkins job and the build process will tag each release with a version number.
GiJeli is a word made up as a contraction of
- Jekyll is the stand-alone engine that drives GitHub pages.
- By running Jekyll you can effectively have an equivalent to GitHub pages anywhere.
Pulling LinkChecker Docker Image
All versions will be available at Praqma’s Docker Hub.
docker pull praqma/linkchecker:v[version number]
linux / iOS:
docker run -v $(pwd):/data praqma/linkchecker:v[version number] [Options] [Output Options] [URL]
docker run -v /$(pwd):\\data praqma/linkchecker:v[version number] [Options] [Output Options] [URL]
Using the LinkChecker Docker image we want to produce a report for http://www.yourURL.com/ in CSV format named linkchecker.report.csv and place it in /your-project/your-report-folder/. To achieve this, the following steps will be taken:
- cd to your-project directory
- Create your-report-folder with write privileges.
mkdir -p -m 777 your-report-folder
- Run the LinkChecker Docker image with the following command:
docker run -v $(pwd):/data praqma/linkchecker:v1 --check-css --check-html --complete --anchors -F=csv/your-report-folder/linkchecker.report.csv http://www.yourURL.com/
Have a cup of coffee or tea while you wait for your report to be generated. We are using Jenkins jobs to automate report production for our jekyll web projects. Don’t forget to read our extra article for a deeper dive into generating and publishing LinkChecker reports.
For a detailed overview of LinkChecker options see the documentation