angular-jsdoc icon indicating copy to clipboard operation
angular-jsdoc copied to clipboard

JSDoc files does not gets generated

Open hegdeashwin opened this issue 9 years ago • 3 comments

I am using Node.js v4.2.5 and npm v2.14.12, jsdoc v3.4.0 and angular-jsdoc v1.4.2

Below is my package.json file

{
  "name": "abc",
  "version": "0.0.1",
  "scripts": {
    "jsdoc": "./node_modules/.bin/jsdoc --configure ./node_modules/angular-jsdoc/common/conf.json --template ./node_modules/angular-jsdoc/angular-template --destination docs --recurse ./src"
  },
  "dependencies": {
    "angular": "~1.5.7"
  },
  "devDependencies": {
    "angular-jsdoc": "~1.4.2",
    "jsdoc": "~3.4.0"
  }
}

When I try to execute npm run jsdoc below things happen:

  1. Console returns no error or warning
  2. Default directories like css, js, source, templates, tutorials are created with empty.

I have specified jsdoc comments E.g.

/**
 * @summary List of stylesheets which need to be injected first
 */

but nothing happens

hegdeashwin avatar Jul 12 '16 07:07 hegdeashwin

+1 - This simply requires a documentation update:

Please clarify that the index.html file will NOT be generated in the destination folder if you include an empty README.

This was my situation and has been resolved for me. Please consider updating the docs.

randycasburn avatar Jul 15 '16 14:07 randycasburn

This really sounds like a bug -- we should tolerate an empty README.

schmod avatar Jul 15 '16 15:07 schmod

Agreed.

reloaded avatar Aug 31 '16 22:08 reloaded