X-Git-Url: https://jasonwoof.com/gitweb/?p=peach-html5-editor.git;a=blobdiff_plain;f=README.md;h=26edc34655851187c4de7d691f3598032fd9f265;hp=02020d685f634231718583a4dfe4de306504cda8;hb=e3b396215f59cd45b7d7c510dcddea8354f756aa;hpb=071a77b51a7f9ba5da51b3fc43885e63771bc566 diff --git a/README.md b/README.md index 02020d6..26edc34 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,26 @@ -wheic -===== +Peach HTML5 Editor +================== -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 HTML5 parser can -also run under node.js. +This is a WYSIWYG HTML5 editor for the browser. Status ------ -HTML5 parser: all (1581) tests pass. Works in the browser and node.js +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. -WYSIWYG editor: planning stages Quick Start Guide @@ -28,7 +35,9 @@ Quick Start Guide 4. Try running the parser in the console, example: - window.wheic.parse_html("

foo

", {fragment: "body"}) + window.peach_parser.parse("

foo

", {fragment: "body"}) + +5. Open ``editor_tests_coffee.html`` in your browser For further reading, see "Running Under node.js" below. @@ -36,6 +45,9 @@ 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/ @@ -55,30 +67,34 @@ Now you can do any of these things in any order: * Run the tests directly from CoffeeScript: - coffee test.coffee + 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: - nodejs test.js + nodejs parser_tests.js * Try using the parser in your own javascript node.js project: - var wheic = require('./parse-html.js'); - var dom = wheic.parse_html("

hi

", {fragment: 'body'}); + var html5 = require('./parser.js'); + var dom = html5.parse("

hi

", {fragment: 'body'}); ... * Try using the parser in your own CoffeeScript node.js project: - wheic = require './parse-html.js' - dom = wheic.parse_html "

hi

", fragment: 'body' + html5 = require './parser.js' + dom = html5.parse "

hi

", fragment: 'body' ... Note: the CoffeeScript compile time is significant, so you'll want to use the compiled javascript even though you could use the ``.coffee`` version. +* 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 ------------------------