stache-cli

CLI for STACHE - Blackbaud's Documentation Builder.

stache-cli's People

Contributors

Watchers

stache-cli's Issues

Creation of new stache site fails unable to find local grunt

When attempting to create a new stache site you receive Fatal error: unable to find local grunt. I have tested this on Windows, Ubuntu and OS X with the latest version of the blackbaud-stache-cli package. Using git bisect the last good version is 0.2.59. Below is the output:

$ npm ls blackbaud-stache-cli -g
C:\Users\Blackbaud-AaronDershem\AppData\Roaming\npm
└── [email protected]


Blackbaud-AaronDershem@mymachine MINGW64 /c/github/blackbaud/test
$ stache new test.0.2.59
Running "new:test.0.2.59" (new) task

Running "copy:boilerplate" (copy) task
Created 22 directories, copied 40 files

Running "fixIgnore" task

Done, without errors.

$ npm install blackbaud-stache-cli -g
npm WARN deprecated [email protected]: Grunt needs your help! See https://github.com/gruntjs/grunt/issues/1403.
npm WARN deprecated [email protected]: graceful-fs version 3 and before will fail on newer node releases. Please                                                 update to graceful-fs@^4.0.0 as soon as possible.
C:\Users\Blackbaud-AaronDershem\AppData\Roaming\npm\stache -> C:\Users\Blackbaud-AaronDershem\AppData\Roaming\npm\node_modules\blackbaud-stache                                                -cli\bin\stache
[email protected] C:\Users\Blackbaud-AaronDershem\AppData\Roaming\npm\node_modules\blackbaud-stache-cli
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected])
└── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], colors                                                @0.6.2, [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], coffee-script                                                @1.3.3, [email protected], [email protected], [email protected], [email protected], [email protected], findup                                                [email protected], [email protected])

Blackbaud-AaronDershem@mymachine MINGW64 /c/github/blackbaud/test
$ npm ls blackbaud-stache-cli -g
C:\Users\Blackbaud-AaronDershem\AppData\Roaming\npm
└── [email protected]


Blackbaud-AaronDershem@mymachine MINGW64 /c/github/blackbaud/test
$ stache new test.0.3.9
grunt-cli: The grunt command line interface (v1.1.0)

Fatal error: Unable to find local grunt.

If you're seeing this message, grunt hasn't been installed locally to
your project. For more information about installing and configuring grunt,
please see the Getting Started guide:

http://gruntjs.com/getting-started

Travis-CI, allow for generic build

Currently, if .travis.yml present, Azure/Kudu skips the build. Let's only skip the build if it's a default setup.

Boilerplate templates

We want to revamp the stache-cli and the boilerplate to make it more flexible.

Need to create a new repository for stache boilerplate templates (stache-boilerplates).
- Default template
- API template
CLI stache new command would pull boilerplates from the repo and delete the ones that don't match the name. If no match is found, default template is used.
Need to create a detailed readme in the stache-boilerplates repo that describes how to create a new template.
Existing Stache boilerplate needs to be cleaned up and simplified.
Existing API template needs to contain same project structure, but remove content. Should point to live API demo site for examples.

Upgrade/Migrate Tool

Create a script that can be activated with stache fix, (or something similar) that will allow users to migrate deprecated YAML variables and Handlebars Helpers.