Skip to content

kamalaknn/api

 
 

Repository files navigation

Versioned API Browser

This Ember Application allows you to browse API docs.

Setup

  1. Install Dependencies
npm install && bower install
  1. Install yuidocjs (if needed) on your machine (npm -g install yuidocjs) and run it in the root of your ember.js folder (yuidoc .)

  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=/Users/trek/Development/ember/ember.js \
  --default-index=Ember \
  --default-module=ember \
  --github-url=https://github.com/emberjs/ember.js \
  --rev=v1.6.0 \
  --environment=production \
  --project-name=ember.js \
  --execution-dir=/Users/trek/Development/ember/ember.js/docs 
  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

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 59.2%
  • JavaScript 24.8%
  • HTML 16.0%