mustache(1) - Mustache processor

1. mustache(1)
2. Mustache Manual
3. mustache(1)

## NAME

`mustache` - Mustache processor

## SYNOPSIS

    mustache <YAML> <FILE>
    mustache --compile <FILE>
    mustache --tokens <FILE>

## DESCRIPTION

Mustache is a logic-less templating system for HTML, config files, anything.

The `mustache` command processes a Mustache template preceded by YAML frontmatter from standard input and prints one or more documents to standard output.

YAML frontmatter begins with `---` on a single line, followed by YAML, ending with another `---` on a single line, e.g.

    ---
    names: [ {name: chris}, {name: mark}, {name: scott} ]
    ---

If you are unfamiliar with YAML, it is a superset of JSON. Valid JSON should work fine.

After the frontmatter should come any valid Mustache template. See mustache(5) for an overview of Mustache templates.

For example:

    {{#names}}
      Hi {{name}}!
    {{/names}}

Now let's combine them.

    $ cat data.yml
    ---
    names: [ {name: chris}, {name: mark}, {name: scott} ]
    ---

    $ cat template.mustache
    {{#names}}
      Hi {{name}}!
    {{/names}}

    $ cat data.yml template.mustache | mustache
    Hi chris!
    Hi mark!
    Hi scott!

If you provide multiple YAML documents (as delimited by `---`), your template will be rendered multiple times. Like a mail merge.

For example:

    $ cat data.yml
    ---
    name: chris
    ---
    name: mark
    ---
    name: scott
    ---

    $ cat template.mustache
    Hi {{name}}!

    $ cat data.yml template.mustache | mustache
    Hi chris!
    Hi mark!
    Hi scott!

## OPTIONS

By default `mustache` will try to render a Mustache template using the YAML frontmatter you provide. It can do a few other things, however.

`-c`, `--compile`

  Print the compiled Ruby version of a given template. This is the code that is actually used when rendering a template into a string. Useful for debugging but only if you are familiar with Mustache's internals.

`-t`, `--tokens`

  Print the tokenized form of a given Mustache template. This can be used to understand how Mustache parses a template. The tokens are handed to a generator which compiles them into a Ruby string. Syntax errors and confused tags, therefore, can probably be identified by examining the tokens produced.

## INSTALLATION

If you have RubyGems installed:

    gem install mustache

## EXAMPLES

    $ mustache data.yml template.mustache
    $ cat data.yml | mustache - template.mustache
    $ mustache -c template.mustache
    $ cat <<data | ruby mustache - template.mustache
    ---
    name: Bob
    age: 30
    ---
    data

## COPYRIGHT

Mustache is Copyright (C) 2009 Chris Wanstrath

Original CTemplate by Google

## SEE ALSO

mustache(5), gem(1), http://mustache.github.io/

1. DEFUNKT
2. October 2014
3. mustache(1)