# static-handlebars-brunch

> Compile Handlebar templates to HTML with brunch

Latest version **0.1.5** (published 2013-03-22) · 0 weekly downloads

## Install

```sh
npm install static-handlebars-brunch
pnpm add static-handlebars-brunch
yarn add static-handlebars-brunch
bun add static-handlebars-brunch
```

## Health

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

Positive: no vulnerabilities.

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

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.5 |
| Published | 2013-03-22 |
| First published | 2013-03-19 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | ~ 0.10.0 |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 7 |
| Author | Brendan Loudermilk |
| Maintainers | bloudermilk |

## Links

- npm: https://www.npmjs.com/package/static-handlebars-brunch
- Repository: git@github.com:bloudermilk/static-handlebars-brunch
- Homepage: https://github.com/bloudermilk/static-handlebars-brunch
- npm.io page: https://npm.io/package/static-handlebars-brunch

## Dependencies (3)

- [glob](https://npm.io/package/glob.md) ~ 3.1.21
- [mkdirp](https://npm.io/package/mkdirp.md) ~ 0.3.5
- [handlebars](https://npm.io/package/handlebars.md) ~ 1.0.10

## Recent versions

- 0.1.5 (latest) — 2013-03-22
- 0.1.4 — 2013-03-22
- 0.1.3 — 2013-03-19
- 0.1.2 — 2013-03-19
- 0.1.1 — 2013-03-19
- 0.1.0 — 2013-03-19

## README

# static-handlebars-brunch

static-handlebars-brunch is a Brunch plugin that facilitates the use of
Handlebars as a build-time templating engine. This is useful if you have many
"static" pages that need the ability to include partials or other dynamic
content at build time.

## Installation

Add `static-handlebars-brunch` to your `package.json` file:

```json
"dependencies": {
  "static-handlebars-brunch": "~ 0.1.0"
}
```

And install dependecies.

```bash
$ npm install
```

## How it works

Any `.hbs` file found in `app/templates` will be compiled to `.html` and copied
into `app/assets`. Brunch will then copy `app/assets` to `public`.

## Partials

A partial is any `.hbs` file in `app/templates` that begins with an underscore,
for example: `app/templates/_header.hbs`.

You can use the standard Handlebars partial helper to include partials in a
template:

```hbs
{{> header}}

<p>This is a page!</p>

{{> footer}}
```

A custom partial helper is available which allows you to pass variables to your
partials.

```hbs
{{partial "header" title="My great page"}}

<p>This is a page!</p>

{{> "footer"}}
```

## TODO

This library has a long way to go in terms of configurability and compatability
with other workflows. The following are known features which we would like to
support. Feel free to send a pull request if you end up implementing any.

* Support a custom source path (ie. `app/templates`).
* Support a custom compilation path (ie. `app/assets`).
* Play nicely with `handlebars-brunch` (ie. figure out how to support both
  plugins in one app).
* Support custom extensions (only `.hbs` is supported now).
* Cache partials (right now partials are recompiled up every time a file is
  changed).
* Write tests

## License

static-handlebars-brunch is an open source project released under the MIT
License. See `MIT-LICENSE` in the project root for more details.

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