Skip to content
 
 

Repository files navigation

Versioned API Browser

This Ember Application allows you to browse API docs.

Setup

  1. Install Dependencies
npm install && bower install
  1. Clone the main ember.js repo down to your machine, cd into it and run bower install to install all needed dependencies.

  2. Start the app with the following command args

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

  • execution-dir (path, default lib-dir) local path to the directory where yuidoc should execute: e.g. '/usr/yourname/code/ember.js/docs'

  • 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 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=../ember.js \
  --default-index=Ember \
  --default-module=ember \
  --github-url=https://github.com/emberjs/ember.js \
  --rev=master \
  --environment=production \
  --project-name=ember.js \
  --execution-dir=../ember.js
  1. View the app
open http://0.0.0.0:4200/<project-name>/<value for rev argument>/

About

An app for browsing versioned API docs in the Ember family of libraries

Resources

Code of conduct

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages