Code Monkey home page Code Monkey logo

gulp-typedoc's Introduction

Gulp-TypeDoc

Synopsis

Gulp plugin to execute the TypeDoc tool by Sebastian Lenz http://typedoc.org https://github.com/TypeStrong/typedoc

Installation

Install both gulp-typedoc and typedoc:

npm install --save-dev gulp-typedoc typedoc

The reason for installing typedoc separately is that it allows you to choose the version of typedoc, independent from the version of gulp-typedoc.

Usage

The plugin takes an object, of which all properties are passed transparently to typedoc. Pipe in TypeScript files. The documentation files are not piped out.

By default, the plugin will output log messages from TypeDoc. Specify logger: 'none' to suppress TypeDoc logging altogether.

Code Example

var typedoc = require("gulp-typedoc");

gulp.task("typedoc", function() {
	return gulp
		.src(["data/*.ts"])
		.pipe(typedoc({
			// Output options (see TypeDoc docs http://typedoc.org/api/interfaces/typedocoptionmap.html)
			// NOTE: the out option and the json option cannot share the same directory
			out: "./out/html/",
			json: "/out/file.json",

			// TypeDoc options (see TypeDoc docs http://typedoc.org/api/interfaces/typedocoptionmap.html)
			name: "my-project",
			theme: "/path/to/my/theme",
			plugin: ["my", "plugins"],
			version: true,
		}))
	;
});

Changelog

3.0.2

  • Fix #44 Work with clean copy of user options. Thanks @tristan00b!

3.0.1

  • Fix #40 entrypoints not specified to TypeDoc by @robinprashanth

3.0.0

  • BREAKING: Requires Typedoc version >=0.20.34 now (and supports it)
  • BREAKING: since the options follow the TypeDoc options, these are different now.
  • Upgrade dependencies to fix security vulnerabilities

2.2.9

  • Upgrade dependencies to fix security vulnerabilities

2.2.8

  • Upgrade dependencies to fix security vulnerabilities

2.2.7

  • Remove superfluous files from published package

2.2.6

  • Upgrade dependencies to fix security vulnerabilities

2.2.5

  • Upgrade dependencies to fix security vulnerabilities

2.2.4

  • Support typedoc 0.16.1+

2.2.3

  • Fix security vulnerabilities in dependencies

2.2.2

  • Fix security vulnerabilities in dependencies

2.2.1

  • Fix event-stream dependency to 3.3.4 because 3.3.5-3.3.6 have issues.

2.2.0

  • Fixed security issue in dependency
  • Add TypeScript type definitions

2.1.2

  • Removed deprecated gulp-util dependency

2.1.1

  • Don't depend on typedoc in package.json dependencies (bugfix by @MattiasBuelens)

2.1.0

  • Add support for logger option.

2.0.3

  • Don't error when there are no files

2.0.2

  • Catch any synchronous exceptions from typedoc

2.0.1

  • Update typedoc URL in README.md (thanks @pascalberger)

2.0.0

  • Have typedoc as peer dependency (thanks @mizunashi-mana)
  • Ensure it works with https://github.com/TypeStrong/typedoc
  • Upgrade all packages, replace "del" by "rimraf"
  • Fix bugs in README.md

1.2.0

  • Don't start a child process anymore.
  • FIX: having many .ts files no longer causes "command line too long" error.

1.1.0

  • Allow specifying boolean arguments for typedoc;
  • Replace module "gulp-clean" by "del"

1.0.6

  • Moved to typedoc version 0.2.x

1.0.5

  • Moved to typedoc version 0.1.x

1.0.3

  • Use require.resolve() to find typedoc more reliably

1.0.2

  • Allow any typedoc version 0.0.x

Contributors

  • Rogier Schouten
  • Daan Wissing
  • Mizunashi Mana
  • Pascal Berger
  • Pedro Batista
  • Matthias Beulens
  • Charles Samborski
  • Gerrit Birkeland
  • @robinprashanth

License

ISC

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.