yuidoc-mdeditor-theme's Introduction

YUIDoc mdEditor Theme

An EmberJS based YUIDoc theme

$ npm install yuidoc-mdeditor-theme

Notes

This theme is to be used with ember-cli-yuidoc which uses git-repo-version to generate the project version.
This theme was originally forked from offirgolan/yuidoc-ember-theme

Extensions to the YUIDoc Features

Computed properties

Use @category computed and @required

/**
* A computed value
*
* @property something
* @type {Object}
* @category computed
* @required foo,bar
*/

Class names with slashes

Use -- to represent /:

/**
* @class md-indicator--related
* @extend md-indicator
*/

Configuration File

If your project uses a "yuidoc.json" file for configuration, add:

"themedir" : "node_modules/yuidoc-ember-theme",
"helpers" : ["node_modules/yuidoc-ember-theme/helpers/helpers.js"]

Example:

{
    "name": "Example",
    "url": "<GITHUB REPO URL>",
    "version": "0.1.0",
    "indexModule": "Welcome",
    "externalDocs": [{
        "name": "ember-validators",
        "path": "node_modules/ember-validators",
        "url": "https://github.com/offirgolan/ember-validators",
        "version": "master"
    }],
    "options": {
        "paths": "_location to parse_",
        "outdir": "build/docs",
        "exclude": "lib,docs,build",
        "themedir": "node_modules/yuidoc-ember-theme",
        "helpers": ["node_modules/yuidoc-ember-theme/helpers/helpers.js"]
    }
}

Index Module

If indexModule is speficied in your yuidoc.json, the page will be forwarded to that module when a user loads the index page.

{
    "indexModule": "Welcome"
}

External Docs

If you have external documentation taken from dependencies, you may list them under the externalDocs option in your yuidoc.json. Doing so will setup the correct file names and paths.

{
    "externalDocs": [{
        "name": "ember-validators",
        "path": "node_modules/ember-validators",
        "url": "https://github.com/offirgolan/ember-validators",
        "version": "master"
    }]
}

Recommend Projects