# template-helper-apidocs

> Template helper for automatically generating API docs from code comments. This is based on helper-apidocs, but specifically for applications built-with the Template library.

Latest version **0.4.4** (published 2015-05-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install template-helper-apidocs
pnpm add template-helper-apidocs
yarn add template-helper-apidocs
bun add template-helper-apidocs
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.4.4 |
| Published | 2015-05-30 |
| First published | 2015-03-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 7 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 5 |
| Author | Jon Schlinkert |
| Maintainers | jonschlinkert |
| Keywords | api, api-docs, apidocs, code, comment, comments, docs, documentation, generate, helper, helpers |

## Links

- npm: https://www.npmjs.com/package/template-helper-apidocs
- Repository: https://github.com/helpers/template-helper-apidocs
- Issues: https://github.com/helpers/template-helper-apidocs/issues
- npm.io page: https://npm.io/package/template-helper-apidocs

## Dependencies (7)

- [globby](https://npm.io/package/globby.md) ^2.0.0
- [is-glob](https://npm.io/package/is-glob.md) ^1.1.3
- [relative](https://npm.io/package/relative.md) ^3.0.0
- [clone-deep](https://npm.io/package/clone-deep.md) ^0.1.1
- [mixin-deep](https://npm.io/package/mixin-deep.md) ^1.0.1
- [js-comments](https://npm.io/package/js-comments.md) ^0.5.2
- [template-bind-helpers](https://npm.io/package/template-bind-helpers.md) ^0.1.2

## Alternatives

- [flatbuffers](https://npm.io/package/flatbuffers.md) — 6.0M weekly downloads
- [jwt-simple](https://npm.io/package/jwt-simple.md) — 259.5K weekly downloads
- [@exodus/patch-broken-hermes-typed-arrays](https://npm.io/package/@exodus/patch-broken-hermes-typed-arrays.md) — 28.5K weekly downloads
- [@native-to-anchor/buffer-layout](https://npm.io/package/@native-to-anchor/buffer-layout.md) — 12.2K weekly downloads
- [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) — 5.3K weekly downloads

## Recent versions

- 0.4.4 (latest) — 2015-05-30
- 0.4.3 — 2015-05-28
- 0.4.2 — 2015-04-28
- 0.4.1 — 2015-04-26
- 0.3.5 — 2015-04-26
- 0.4.0 — 2015-04-26
- 0.3.3 — 2015-04-19
- 0.3.2 — 2015-04-19
- 0.3.1 — 2015-04-17
- 0.3.0 — 2015-04-11
- 0.2.1 — 2015-04-10
- 0.2.0 — 2015-03-19
- 0.1.1 — 2015-03-08
- 0.1.0 — 2015-03-08

## README

# template-helper-apidocs [![NPM version](https://badge.fury.io/js/template-helper-apidocs.svg)](http://badge.fury.io/js/template-helper-apidocs)  [![Build Status](https://travis-ci.org/helpers/template-helper-apidocs.svg)](https://travis-ci.org/helpers/template-helper-apidocs)

> Template helper for automatically generating API docs from code comments. This is based on helper-apidocs, but specifically for applications built-with the Template library.

Install with [npm](https://www.npmjs.com/)

```sh
$ npm i template-helper-apidocs --save
```

## Table of contents

<!-- toc -->

* [Docs](#docs)
  - [Registering the helper](#registering-the-helper)
    + [template](#template)
    + [assemble](#assemble)
    + [verb](#verb)
    + [handlebars](#handlebars)
    + [Lo-Dash and underscore](#lo-dash-and-underscore)
* [Example usage](#example-usage)
* [Other awesome libs](#other-awesome-libs)
* [Contributing](#contributing)
* [Running tests](#running-tests)
* [Author](#author)
* [License](#license)

_(Table of contents generated by [verb](https://github.com/assemble/verb))_

<!-- tocstop -->

## Docs

### [apidocs](index.js#L35)

Generate API docs from code comments for any JavaScript files that match the given `patterns`. Note that **only code comments with `@api public` will be rendered.**

**Params**

* `patterns` **{String}**: Glob patterns for files with code comments to render.
* `options` **{Object}**: Options to pass to [js-comments](https://github.com/jonschlinkert/js-comments).
* `returns` **{String}**: Markdown-formatted API documentation

**Example**

```js
apidocs("index.js");
```

_(this section was generated using this helper)_

### Registering the helper

> This helper should work with any template engine, here are a few examples

#### template

Register the helper with [Template](https://github.com/jonschlinkert/template), allowing it to be used with any template engine.

```js
template.helper('apidocs', require('template-helper-apidocs'));
```

#### assemble

Register the helper with [assemble](http://assemble.io)v0.6.x:

```js
var assemble = require('assemble');
assemble.helper('apidocs', require('template-helper-apidocs'));
```

#### verb

Register the helper with [verb](https://github.com/assemble/verb):

```js
var verb = require('verb');
verb.helper('apidocs', require('template-helper-apidocs'));
```

#### handlebars

Usage with [handlebars](http://www.handlebarsjs.com/)

```js
var handlebars = require('handlebars');
handlebars.registerHelper('apidocs', require('template-helper-apidocs'));
```

#### Lo-Dash and underscore

To use the helpers with [Lo-Dash](https://lodash.com/) or [underscore](http://underscorejs.org):

```js
// as a mixin
_.mixin({apidocs: apidocsHelper});
_.template('<%= _.apidocs("fixtures/*.js") %>', {});

// passed on the context
_.template('<%= apidocs("fixtures/*.js") %>', {apidocs: apidocsHelper});

// as an import
var settings = {imports: {apidocs: apidocsHelper}};
_.template('<%= apidocs("fixtures/*.js") %>', {}, settings);
```

***

## Example usage

With Lo-Dash or Underscore:

```js
<%= apidocs("index.js") %>
```

With Handlebars:

```handlebars
{{apidocs "index.js"}}
```

With Verb (lo-dash, with special delimiters to avoid delimiter collision in markdown docs):

```js
{%= apidocs("index.js") %}
```

***

## Other awesome libs

* [assemble](http://assemble.io): Static site generator for Grunt.js, Yeoman and Node.js. Used by Zurb Foundation, Zurb Ink, H5BP/Effeckt,… [more](http://assemble.io)
* [handlebars-helpers](https://github.com/assemble/handlebars-helpers): 120+ Handlebars helpers in ~20 categories, for Assemble, YUI, Ghost or any Handlebars project. Includes… [more](https://github.com/assemble/handlebars-helpers)
* [js-comments](https://github.com/jonschlinkert/js-comments): Parse JavaScript code comments and generate API documentation.
* [parse-comments](https://github.com/jonschlinkert/parse-comments): Parse code comments from JavaScript or any language that uses the same format.
* [template](https://github.com/jonschlinkert/template): Render templates using any engine. Supports, layouts, pages, partials and custom template types. Use template… [more](https://github.com/jonschlinkert/template)
* [template-helpers](https://github.com/jonschlinkert/template-helpers): Generic JavaScript helpers that can be used with any template engine. Handlebars, Lo-Dash, Underscore, or… [more](https://github.com/jonschlinkert/template-helpers)
* [verb](https://github.com/assemble/verb): Documentation generator for GitHub projects. Extremely powerful, easy to use, can generate anything from API… [more](https://github.com/assemble/verb)

## Contributing

Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/helpers/template-helper-apidocs/issues/new)

To request or contribute a helper to the [github.com/helpers](https://github.com/helpers) org, please read [this contributing guide](https://github.com/helpers/requests) to get started.

## Running tests

Install dev dependencies:

```sh
$ npm i -d && npm test
```

See [the tests](./test.js) for actual usage examples.

## Author

**Jon Schlinkert**

+ [github/jonschlinkert](https://github.com/jonschlinkert)
+ [twitter/jonschlinkert](http://twitter.com/jonschlinkert)

## License

Copyright © 2014-2015 Jon Schlinkert
Released under the MIT license.

***

_This file was generated by [verb-cli](https://github.com/assemble/verb-cli) on May 29, 2015._

---
_Source: https://npm.io/package/template-helper-apidocs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._