Skip to content

himedlooff/doxray-template

Repository files navigation

Doxray-template

A handlebars.js template for Doxray

Live demo: http://himedlooff.github.io/doxray-template/docs/

Screen cap demo:

Animated screen cap

Getting started

  • Set up a folder for the template files to live in. You can name it anything you want but as an example let's call it docs.
  • Download the template files from the template folder of this repository. I recommend using http://bower.io/ so you can easily update the template if you need to.
  • After downloading, move all of the files in the template folder into docs. I recommend using a task runner like http://gruntjs.com/ or http://gulpjs.com/ so you can easily move the template files after downloading them.
  • After moving the template files open up index.html and uncomment <!-- <link rel="stylesheet" href="your-stylesheet-here.css"> --> and replace your-stylesheet-here.css with your own stylesheet so your patterns will render as expected.
  • Set up Doxray to write a file named doxray-parsed-data.js into docs. You can do this from the command line or by setting up a Grunt or Gulp task.
  • That's it, open the index.html file in docs.

Questions? Having trouble? File an issue.

An example using Bower and Gulp

# Download the template files
$ bower install doxray-template
// Move the template files into `docs`.
// You only need to do this after installing or updating doxray-template.
gulp.task('move-doxray-template', function() {
    return gulp.src(['bower_components/doxray-template/template/*'])
    .pipe(gulp.dest('docs'));
});

// Parse the files you want to generate documentation from.
// Saved the parsed data as `doxray-parsed-data.js` into the same folder you
// placed the template files.
gulp.task('doxray', function() {
    doxray(['my-file.less'], { jsFile: 'docs/doxray-parsed-data.js' });
});

Getting involved

Feedback and contributions are welcome. Please read CONTRIBUTING.

To file a bug please us this handy template.

Credit

Eye icon created by Edward Boatman from the Noun Project: https://thenounproject.com/search/?q=eye&i=421

About

A handlebars.js template for Doxray

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published