diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..f8b4659 --- /dev/null +++ b/README.md @@ -0,0 +1,56 @@ +# Bootlint Server + +[![NPM version](https://img.shields.io/npm/v/bootlint-server.svg)](https://www.npmjs.com/package/bootlint-server) +[![Build Status](https://github.com/twbs/bootlint-server/workflows/Tests/badge.svg)](https://github.com/twbs/bootlint-server/actions?workflow=Tests) +[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg "MIT License")](https://github.com/twbs/bootlint-server/blob/master/LICENSE) +[![Dependency Status](https://img.shields.io/david/twbs/bootlint-server.svg)](https://david-dm.org/twbs/bootlint-server) +[![devDependency Status](https://img.shields.io/david/dev/twbs/bootlint-server.svg)](https://david-dm.org/twbs/bootlint-server?type=dev) + +Run [Bootlint](https://github.com/twbs/bootlint-server) as a server. + +## Getting Started + +Install the module with: `npm install bootlint-server` + +## What's this + +Bootlint can also be run as an HTTP server that exposes a very simple API. Use `npm run start` to run the server. + +By default, it runs on port `7070`. Set the `$PORT` environment variable to change which port it uses. + +POST an HTML document to `/` and the document's lint problems will be returned as JSON. + +The endpoint accepts an optional querystring argument named `disable`, whose value is a comma-separated list of linter IDs to disable. + +Example: + +```http +Request: + POST / HTTP/1.1 + Content-Type: text/html + + <!doctype html> + ... + +Response: + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "id": "W003", + "message": "<head> is missing viewport <meta> tag that enables responsiveness" + }, + { + "id": "W005", + "message": "Unable to locate jQuery, which is required for Bootstrap's JavaScript plugins to work" + }, + ... + ] +``` + +## Contributing + +The project's coding style is laid out in the ESLint configuration. Add unit tests for any new or changed functionality. Lint and test your code using the npm scripts. + +Copyright (c) 2014-2019 The Bootlint Authors. Licensed under the MIT License. |