Sha256: da78144c9117fbcdfcad4dcdbf12e8817adef31211464a15eec1f0c4e5e1c011

Contents?: true

Size: 1.55 KB

Versions: 1

Compression:

Stored size: 1.55 KB

Contents

SproutCore Documentation Generator
==================================

A tool to generate documentation for the SproutCore framework and SproutCore projects, using the JSDoc format.

**Authors**: Majd Taby, Peter Wagenet

Usage
-----

    gem install sc-docs

*NOTE: If you are not using the latest version of SproutCore, the
built-in sc-docs command may conflict. This has been fixed in the newest
versions of SC.*

### Basic

    sc-docs preview --input_dir INPUT_DIRECTORY_PATH \
        --output_dir OUTPUT_DIRECTORY_PATH

This documents the specified directory and then runs a preview sc-server instance.

### Deploy

    sc-docs generate --input_dir INPUT_DIRECTORY_PATH \
        --output_dir = OUTPUT_DIRECTORY_PATH

The generate command runs sc-build and deploys to the specified directory.

### HTML Templates

    sc-docs generate --input_dir INPUT_DIRECTORY_PATH \
        --output_dir = OUTPUT_DIRECTORY_PATH \
        --template TEMPLATE_PATH


By default sc-docs assumes that you want to generate docs for the SproutCore based Doc Viewer. However, if you pass a template it will generate a standard HTML output.

Dependencies
------------

* **node.js**: We use a special (much faster) version of jsdoc-toolkit that requires node.js.

Templates
---------

### sc_fixture

Generates the docs in JSON format for use within an SC based viewer app.

### docs.sproutcore.com

The template used at docs.sproutcore.com. Designed by Matt Grantham and Ryan Mudryk with additional work by Avrohom Katz.

Credits
------

**jsdoc-toolkit**: Used for the heavy lifting of docs generation

Version data entries

1 entries across 1 versions & 1 rubygems

Version Path
sc-docs-0.0.2 README.md