Skip to content

Latest commit

 

History

History
47 lines (31 loc) · 1.53 KB

README.md

File metadata and controls

47 lines (31 loc) · 1.53 KB
Raw

Versioned API Browser

This Ember Application allows you to browse API docs.

Setup

  1. Install Dependencies
npm install && bower install
  1. Start the app with with the following command args

  • lib-dir (path) local path to the library documented with YUIDoc e.g. /usr/yourname/code/ember.js

  • project-name (string, default '') the name of the project you're documenting. this becomes the project's slug for urls: e.g. ember.js becomes /ember.js/v1.9.0

  • default-index (string) name of the class you'd like to redirect to when someone visits the root (/) of the documentation. e.g. Ember

  • default-module (string) name of the module where to look for module related data. YUIDoc stuffs all modules (even if you only have one) into modules: e.g. ember

  • rev (string, optional, defaults to 'master') name of the revision you are generating: e.g. v1.1.0

  • sha (String, optional, defaults to 'master') name of the SHA or tag. This is different than rev to allow you to publish new versions of a rev's docs that have been updated in future commits. So, if a spelling fixes occur in commits > v1.1.0 and < v1.1.1 you can publish the SHA to update: e.g. decafbebad01 or v1.0.0

  • `github-url (url) github url of the project, no trailing slash: e.g. 'https://github.com/emberjs/ember.js'

ember server --lib-dir=/path/to/ember.js --default-index=Ember --default-module=ember --rev=v1.0.0
  1. View the app
open http://0.0.0.0:4200