JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
run in the browser without installing coffeescript
[peach-html5-editor.git] / README.md
index d2acc77..3d463de 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,49 +4,56 @@ wheic
 This project is to build a HTML5 parser, then use that to build a WYSIWYG html
 editor for the browser.
 
-The code is written in coffeescript for modern browsers.
+The code is written in CoffeeScript for modern browsers. The HTML5 parser can
+also run under node.js.
 
 
 Status
 ------
 
-Under development
+HTML5 parser: all (1581) tests pass. Works in the browser and node.js
 
+WYSIWYG editor: planning stages
 
-Getting Started
----------------
 
-Recommended: see "Compiling" below
+Quick Start Guide
+-----------------
 
-(experimental) Alternate: see "Without Compiling"
+1.     Open ``test.html`` in your browser.
 
+2.     Open the console (right-click, inspect this element, console)
 
-Compiling
----------
+3.     After a few seconds, you should see "Tests passed: 1581, Failed: 0" in the
+       console.
 
-You'll need coffeescript, you can hopefully get that with a command such as
-this:
+4.     Try running the parser in the console, example:
 
-       apt-get install coffeescript
+               window.wheic.parse_html("<p>foo</p>", {fragment: "body"})
 
-or
+For further reading, see "Running Under node.js" below.
 
-       npm install -g coffee-script
 
-Then run ``make``
+Running Under node.js
+---------------------
 
-Then run the test suite by opening ``index.html`` in a modern browser.
+Dependancies: node.js, coffeescript
 
+You can get CoffeeScript with a command such as this:
 
-Without Compiling
------------------
+       apt-get install coffeescript
+
+or
+
+       npm install -g coffee-script
+
+Now you can run the test suite like this:
 
-It is recommended to install coffeescript (see Compiling above), but you might
-be able to got it to compile directly in the browser, see here:
+       coffee test.coffee
 
-       http://coffeescript.org/#scripts
+Or use the parser from your own code:
 
-Please nudge Jason (see below) to make this easier.
+       wheic = require './parse-html.coffee'
+       dom = wheic.parse_html "foo <b>bar"
 
 
 Feedback, Questions, Etc