gulp-export-comments

    1.0.1 • Public • Published

    gulp-export-comments

    Exports all jsdocs-style comments from either .js or .ts files.

    Build Status

    This is used as a workaround for when the TypeScript compiler strips jsdoc comments from its output. By extracting the comments first, you can run the output directly from .ts files into jsdocs.

    Install

    npm i gulp-export-comments --save-dev
    

    Usage

    The examples below illustrate usage in a gulp file. (Note that this plugin auto converts all file extentions to .js for the benefit of jsdocs.)

    Write the comments directly to files:

    var gulp = require('gulp');
    var comments = require('gulp-export-comments');
     
    gulp.task('comments', function() {
        return gulp.src('src/**/*.{ts,js}')
            .pipe(comments())
            .pipe(gulp.dest('lib/docs'));
    });
     

    Stream comments directly into gulp-jsdocs:

    var gulp = require('gulp');
    var comments = require('gulp-export-comments');
    var jsdoc = require('gulp-jsdoc');
     
    gulp.task('docs', function(done) {
        gulp.src('/src/**/*.{ts,js}')
            .pipe(comments())
            .pipe(jsdoc('docs.json', done));
    });

    Install

    npm i gulp-export-comments

    DownloadsWeekly Downloads

    0

    Version

    1.0.1

    License

    MIT

    Last publish

    Collaborators

    • bigtimebuddy