##gulp tasks commands:
build
inject
- inject all packages into client/index.htmlserver
/webserver
/dev-server
- start gulp-server-livereloadngdoc
- generate docs and serve by connect.server
##Adding documentation
component
page contain all added to components.route.js
documentation.
Documentation page consist from two parts for now:
component@components
route contain template and controller for demonstrationdoc@components
route contain documentation in html (it is possible to add mardown in<marked>
tag for now) Wrapper use template:
<div marked file="documentationUrl"> </div>
so documentationUrl shoud provide path to markdown file
routeProvider wrapper storyBook.provider.js
added. Example of usage you can see in
./client/app/components/action-button/actionButton.doc.js. Here is some description:
angular.module('app.components')
.config(
/* @ngInject */
function(storyBookProvider){
storyBookProvider
.Story('chapter name')
.add({
name: 'story name'
templateUrl: 'path to template url'
controllerAs: 'optional, default is vm'
controller: 'controller name'
documentationUrl: 'path to md file with documentation of that story'
})
.publish(); //add paths to routeProvider
});
section add is too big with all paths, maybe need some functional to add story by passing path of element and name of story (or maybe some kind of story id pass additional to prevent ugly stories names)
.add({
name: 'story name',
id: 'story identifier',
path: 'path/to/component/directory'
controller: 'controller name in directory'
})
// it still pretty ugly :E
// 4 params to add one example ..