Skip to content

Command line tool, identifying broken links, validate basic html standards and reporting

License

Notifications You must be signed in to change notification settings

csuwu/w3c-link-validator

 
 

Repository files navigation

Crawling algorithm flowchart

Join the chat at https://gitter.im/w3c-link-validator/Lobby GitHub license Build Status Coverage Status

Very good command line tool for W3C validation and broken link detection of your local development or production URL. Validation errors,warnings or suggestions will be reported to terminal.

Installation

Install with the terminal.

$ npm install w3c-link-validator -g

After installation w3clink command will be available globally.

Note : 'w3c-link-validator' is not in the npm registry yet. Therefore kindly follow developers installation.

Tutorial

Get started

See the command line help first.

$ w3clink --help
  Usage: w3clink [options]


  Options:

    -V, --version                                            output the version number
    check, --check <url> [verbose] [onlyhtml] [suggestions]  Validate links and html both
    -h, --help                                               output usage information

Validation command

$ w3clink check <url> [options]

This command will start validation service for specific URL. URLs per each page will be tested recursively.

Options

  • verbose will show you anything during the validation. Eg hyperlinks per page.
  • onlyhtml will block the deep url traversing. Use if you want to validate html standards only.
  • suggestions will log the suggestions also.

Example

$ w3clink check http://localhost/w3ctest/ suggestions

Sample output on Windows terminal

Sample terminal output

Massive websites may log bunch of messages to your terminal. Therefore you may save your log to a file.

 $ w3clink check http://localhost/w3ctest/ suggestions > mylogfile.txt

Contributing

Click here to view the full contribution guidelines

Development setup

Fork and clone repo

$ git clone https://github.com/<username>/w3c-link-validator.git

Install dependencies

$ npm install

Link to global commands

$ npm link

Run the tests

$ npm run test

Check the code coverage with istanbul. HTML report will be generated to /coverage/lcov-report

$ npm run coverage

Crawling algorithm

Crawling algorithm flowchart

Your contribution

We expect your contribution to improve this project. You may..

  • Open issues for bug reporting or new feature suggestions.
  • Submit pull requests from your fork in order to close existing issues.

We encourage you to apply Github best practices for the communication and development through the repo.

Happy contributing!

Acknowledgement

w3c-link-validator is initially developed for the Hacktitude open source hackathon. Special thanks goes to project mentors @thinkholic, @lakindu95, @rehrumesh and awesome Dotitude Family from 99xt.

License

MIT © 99XT

About

Command line tool, identifying broken links, validate basic html standards and reporting

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 93.6%
  • HTML 6.4%