Bug fix in the createDocs function

.gitignore

@@ -19,4 +19,5 @@ build/
 .yardoc
 _yardoc
 doc/
-.idea/
+.idea/
+node_modules

LICENSE

@@ -1,5 +1,3 @@
-Copyright 2008-2013 Concur Technologies, Inc.
-
 Licensed under the Apache License, Version 2.0 (the "License"); you may
 not use this file except in compliance with the License. You may obtain
 a copy of the License at
@@ -10,4 +8,4 @@ Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 License for the specific language governing permissions and limitations
-under the License.
+under the License.

README.md

@@ -1,21 +1,46 @@
 [Slate](https://github.com/tripit/slate) with node.js
 ========
-A port of the documentation generator Slate to node.js.  
-[See it](http://jmanek.github.io/slate_node/) in action!
 
-I was looking to create API docs and Slate's UI was exactly what I wanted.  I came upon this *glaring* issue though.  I had to use Ruby!  Not that there's anything wrong with that!  But I want to be able to host it on our site, and use the same framework throughout to build everything -- I can't justify setting up Ruby to create one page.  
+A port of the documentation generator Slate to node.js, that can optionally be built in the browser.
+[See it](http://jmanek.github.io/slate_node/) in action!
 
 The major difference is the use of [marked](https://github.com/chjj/marked) for parsing the .md, [highlight](https://highlightjs.org/) for syntax highlighting, and [Handlebars](http://handlebarsjs.com/) for templating.  
 
 
-### Running
-
-1. Clone the repo, install the npm modules.
-2. Run `node marked.js`
-3. This will build the page and save it to /source/index.html 
-4. You're done!  
-
-- Replace /source/index.md with your own markdown to use that instead
-
-### Todo/Bugs
-
+## Building 
+
+### Node.js
+This outputs to the `build` directory. Replace `source/slate.md` with your own markdown to use that instead
+```
+git clone https://github.com/jmanek/slate_node.git
+npm install 
+npm run build
+# Docs are now viewable at build/index.html
+```
+
+### Browser
+Alternatively, you can directly serve the `source` directory from a webhost and the documentation will be built at runtime.  
+```
+git clone https://github.com/jmanek/slate_node.git
+npm install serve # included in npm install
+./node_modules/.bin/serve source
+# Docs are now viewable at localhost:5000
+```
+Any changes to `source/slate.md` will be incorporated into `source/index.html` when it is reloaded. There is now no need to have node.js installed on the machine. This way you don't have to worry about incorpoting Slate into your current build process or creating an entirely new toolchain for it (`python3 -m http.server`). It is a "static" version of Slate.  This is inherently slower than the node.js pre-built version, but it is completely independent of operating system or platform. You will not be able to view the documentation until deploying it to a server.
+
+## Code Highlighting
+[Numerous themes](https://highlightjs.org/static/demo/) for highlight.js are available in `source/stylesheets/highlight`. You can switch between them by changing this line in `source/index.html`
+```html
+<link href="stylesheets/highlight/solarized-dark.css" rel="stylesheet" type="text/css" />
+```
+
+## Includes
+Includes are handled as described in the [Slate Wiki](https://github.com/lord/slate/wiki/Using-Includes). The filename must have an underscore prepended to it, which is not included in the markdown file description.
+
+## Todo/Bugs
+
+- Package it in a more modular way (Grunt?)
+- marked seems to be handling tables a bit differently, if there's too many em-dashes it's failing
+- highlight.js might have some differences in language detection than Rouge; at the very least 'shell' becomes 'bash'.  Ideally this repo should be compatible with any markdown made for Ruby Slate.
+- Cleanup how marked parses the top-level settings.  Right now they are manually being parsed.
+- Actually build the scss/js