diff options
author | John MacFarlane <jgm@berkeley.edu> | 2015-01-15 23:12:01 -0800 |
---|---|---|
committer | John MacFarlane <jgm@berkeley.edu> | 2015-01-15 23:12:01 -0800 |
commit | 2107a56d58990788cfc40c1ba78e6247d1c4b088 (patch) | |
tree | ea24f3a38639222050e385ad027cea201e1b37b1 | |
parent | 9a1291b4d751d8533a56911d41b2596fa95eaf85 (diff) |
README.md: refer to js/README.md for details on JS implementation.
-rw-r--r-- | README.md | 32 | ||||
-rw-r--r-- | js/README.md | 16 |
2 files changed, 21 insertions, 27 deletions
@@ -18,15 +18,10 @@ very fast (see [benchmarks](benchmarks.md)). It is easy to use `libcmark` in python, lua, ruby, and other dynamic languages: see the `wrappers/` subdirectory for some simple examples. -The JavaScript implementation is a single JavaScript file, with -no dependencies, that can be linked into an HTML page. - -``` javascript -var reader = new commonmark.DocParser(); -var writer = new commonmark.HtmlRenderer(); -var parsed = reader.parse("Hello *world*"); -var result = writer.render(parsed); -``` +The JavaScript implementation provides both an NPM package and a +single JavaScript file, with no dependencies, that can be linked into +an HTML page. For further information, see the +[README in the js directory](js/README.md). **A note on security:** Neither implementation attempts to sanitize link attributes or @@ -118,23 +113,8 @@ If you want to use it in a client application, you can fetch a pre-built copy of `commonmark.js` from <http://spec.commonmark.org/js/commonmark.js>. -Or, to build it (this requires `browserify`): - - make js/commonmark.js - -To run tests for the JavaScript library: - - make testjs - -To run benchmarks against some other JavaScript converters: - - npm install showdown marked markdown-it - make benchjs - -To start an interactive dingus that you can use to try out -the library: - - make dingus +For further information, see the +[README in the js directory](js/README.md). The spec -------- diff --git a/js/README.md b/js/README.md index 6803754..0d5cf13 100644 --- a/js/README.md +++ b/js/README.md @@ -27,6 +27,20 @@ a standalone JavaScript file `js/commonmark.js`, suitable for linking into a web page, or just fetch <http://spec.commonmark.org/js/commonmark.js>. +To run tests for the JavaScript library: + + make testjs + +To run benchmarks against some other JavaScript converters: + + npm install showdown marked markdown-it + make benchjs + +To start an interactive dingus that you can use to try out +the library: + + make dingus + Usage ----- @@ -34,7 +48,7 @@ Instead of converting Markdown directly to HTML, as most converters do, `commonmark.js` parses Markdown to an AST (abstract syntax tree), and then renders this AST as HTML. This opens up the possibility of manipulating the AST between parsing and rendering. For example, one -could transform all emphasis into ALL CAPS. +could transform emphasis into ALL CAPS. Here's a basic usage example: |