HTML linter for Bootstrap projects

bookmarklet bootlint bootstrap html linter

Перейти к файлу

Chris Rebert c581c9f306 mention ESLint in CONTRIBUTING.md		2014-09-23 15:00:50 -07:00
dist/browser	grunt dist	2014-09-23 14:26:26 -07:00
src	special-case <th> & <td> since they won't normally have a .row parent	2014-09-23 13:34:29 -07:00
test	fix #58	2014-09-23 13:02:02 -07:00
.editorconfig	add editorconfig via yeoman	2014-07-11 01:24:21 -07:00
.eslintrc	add eslintrc	2014-07-29 11:31:57 -07:00
.gitignore	adding vim swap files to ignore	2014-09-10 12:31:00 -05:00
.jscsrc	fix/integrate JSCS	2014-07-11 03:11:31 -07:00
.jshintrc	get initial browserify'd version working	2014-07-20 16:59:14 -07:00
.travis.yml	Travis build: Limit Bootstrap clone to depth of 1	2014-09-15 15:40:51 -07:00
CONTRIBUTING.md	mention ESLint in CONTRIBUTING.md	2014-09-23 15:00:50 -07:00
Gruntfile.js	exclude UTF-16 testcase from PhantomJS testing	2014-09-23 11:56:46 -07:00
LICENSE	Update LICENSE	2014-07-12 21:07:06 -07:00
README.md	add link for CommonJS	2014-07-25 13:16:22 -07:00
package.json	bump grunt-browserify to ^3.0.1	2014-09-15 15:33:43 -07:00

README.md

Bootlint

An HTML linter for Bootstrap projects

What's Bootlint?

Bootlint is a tool that checks for several common HTML mistakes in webpages that are using Bootstrap in a fairly "vanilla" way. Vanilla Bootstrap's components/widgets require their parts of the DOM to conform to certain structures. Bootlint checks that instances of Bootstrap components have correctly-structured HTML. Optimal usage of Bootstrap also requires that your pages include certain <meta> tags, an HTML5 doctype declaration, etc.; Bootlint checks that these are present.

Caveats

Bootlint assumes that your webpage is already valid HTML5. If you need to check HTML5 validity, we recommend tools like vnu.jar, grunt-html, or grunt-html-validation.

Bootlint assumes that you are using Bootstrap's default class names in your webpage, as opposed to taking advantage of the "mixins" functionality of Less or Sass to map them to custom class names. If you are using mixins, Bootlint may report some false-positive warnings. However, there are some Bootlint checks that are applicable even if you are using mixins pervasively.

Getting Started

On the command line

Install the module with: npm install -g bootlint

Run it on some HTML files:

$ bootlint /path/to/some/webpage.html another_webpage.html [...]

This will output the lint warnings applicable to each file.

In the browser

Download the code.

In your webpage:

<script src="dist/browser/bootlint.js"></script>

Then check the JavaScript console for lint warning messages.

API Documentation

Bootlint is a CommonJS module.

Browser

Bootlint exports a bootlint property on the global window object. In a browser environment, the following public APIs are available:

bootlint.lintCurrentDocument(): Lints the HTML of the current document and returns the linting results.
- Returns an array of lint warning strings
bootlint.showLintReportForCurrentDocument(): Lints the HTML of the current document and reports the linting results to the user.
- If there are any lint warnings, one general notification message will be window.alert()-ed to the user. Each warning will be output individually using console.warn().
- Returns nothing (i.e. undefined)

Node.js

Example:

var bootlint = require('bootlint');
bootlint.lintHtml("<!DOCTYPE html><html>..."); // returns list of lint warning messages

In a Node.js environment, Bootlint exposes the following public API:

bootlint.lintHtml(html): Lints the given HTML for a webpage and returns the linting results.
- Has 1 required parameter: the HTML to lint, as a string
- Returns an array of lint warning strings

Contributing

The project's coding style is laid out in the JSHint and JSCS configurations. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Also, please don't edit files in the "dist" subdirectory as they are generated via Grunt. You'll find source code in the "lib" subdirectory!

Release History

(Nothing yet)