page down key: cursor to end if scrolled bot already

[peach-html5-editor.git] / README.md

diff --git a/README.md b/README.md
index 111cd5d..26edc34 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,30 +1,99 @@
-wheic
-=====
+Peach HTML5 Editor
+==================
+
+This is a WYSIWYG HTML5 editor for the browser.
 
-This project is to build a HTML5 parser, then use that to build a WYSIWYG html
-editor for the browser.
 
 Status
 ------
 
-Under development
+Early development stages.
+
+The HTML5 parser component passes the full test suite (1581 tests).
+
+The interface is starting to exist.
+
+
+Technologies
+------------
+
+Programming language: CoffeeScript (compiles to javascript)
+
+Interface: Implemented using the DOM api. No ``contenteditable`` or jquery.
+
+
+
+Quick Start Guide
+-----------------
+
+1.     Open ``parser_tests_coffee.html`` in your browser.
+
+2.     Open the console (right-click, inspect this element, console)
+
+3.     After a few seconds, you should see "Tests passed: 1581, Failed: 0" in the
+       console.
+
+4.     Try running the parser in the console, example:
+
+               window.peach_parser.parse("<p>foo</p>", {fragment: "body"})
+
+5.     Open ``editor_tests_coffee.html`` in your browser
+
+For further reading, see "Running Under node.js" below.
+
+
+Running Under node.js
+---------------------
+
+With node.js and Coffeescript, you can compile the coffeescript so you can use
+the faster test pages, and you can test the html parser without a browser.
+
+Dependencies: node.js, CoffeeScript
+
+1.     Install node.js https://nodejs.org/en/
+
+2.     Install CoffeeScript. Try:
+
+               apt-get install coffeescript
+       or
+
+               npm install -g coffee-script
+
+4.     Compile to javascript:
+
+               make
+
+Now you can do any of these things in any order:
+
+*      Run the tests directly from CoffeeScript:
+
+               coffee parser_tests.coffee
+
+*      Test the compiled (javascript) parser in your favorite browser by opening
+       up ``parser_tests.html`` and looking at the console.
 
+*      Run tests via compiled code:
 
-Getting Started
----------------
+               nodejs parser_tests.js
 
-You'll need coffeescript, you can hopefully get that with a command such as
-this:
+*      Try using the parser in your own javascript node.js project:
 
-       apt-get install coffeescript
+               var html5 = require('./parser.js');
+               var dom = html5.parse("<p>hi</p>", {fragment: 'body'});
+               ...
 
-or
+*      Try using the parser in your own CoffeeScript node.js project:
 
-       npm install -g coffee-script
+               html5 = require './parser.js'
+               dom = html5.parse "<p>hi</p>", fragment: 'body'
+               ...
 
-Then run ``make``
+       Note: the CoffeeScript compile time is significant, so you'll want to use
+       the compiled javascript even though you could use the ``.coffee`` version.
 
-Then run the test suite by opening ``index.html`` in a modern browser.
+*      Hack editor.coffee more quickly, by testing in editor_tests.html which uses
+       the compiled version of the parser, thus speeding up load time
+       considerably.
 
 
 Feedback, Questions, Etc