brainshave/grunt-zetzer

Grunt plugin for Zetzer

grunt-zetzer

Grunt plugin for Zetzer. More documentation in the Zetzer repository.

After installing the module with npm, load the task with:

grunt.loadNpmTasks('grunt-zetzer');

Examples

In your project's Gruntfile, add a section named zetzer to the data object passed into grunt.initConfig().

grunt.initConfig({
  zetzer: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
})

All possible options are listed in the main Zetzer project.

Grunt's rules for defining target and destination files apply, but care needs to be taken to make sure each input page maps to a single output file.

Custom Options

In this example, doT's it object is used to specify the location of script files and the main title of all pages; and the location of partials and templates is given. All pages in pages/ will be compiled to .html files in tmp.

grunt.initConfig({
  zetzer: {
    main: {
      options: {
        env: {
          title: "Zetzer",
        },
        partials: "content",
        templates: "templates"
      },
      files: [
        {
          expand: true,
          cwd: "src/pages/",
          src: "**/*.html",
          dest: "tmp",
          ext: ".html",
          flatten: true
        }
      ]
    },
  }
})

Contributing

You can run the test suite with npm test.

Each new feature ough to have full test coverage. We usually start by writing a fixture which is a pair of two files: the one to process (the fixture) and it's expected output. Fixtures are html or md files in spec/fixtures. Any partials and templates required by this fixture should be stored in spec/partials and spec/templates, respectively. The expected output of a fixture should be put in spec/expected.

Actual features should be implemented in zetzer as this is just Grunt "front-end".

grunt-zetzer's Issues

UTF8 Encoding

Hi so, when I was using Stencil I had a major issue with it saving all files as not UTF-8.
It obviously cause major issues with spacing and characters.
Just wondering if you have solved this issue? If not, can you please?

Ta.

Warning: Unexpected token <

Hi. I was having this same problem when using grunt-stencil, but still having it with zetzer.

I'm running node 0.10.29, grunt 0.4.5, and zetzer 2.0.0-alpha2
I keep getting this error:

Running "zetzer:build" (zetzer) task
Verifying property zetzer.build exists in config...OK
Files: src/templates/templateBody/gpv-main-tmpl.dot.html -> build/temp/templates/gpv-main-tmpl.html
Options: partials="src/templates/partials", templates="src/templates/base", env={}, dot_template_settings={}, meta_data_separator={}
Reading ./src/templates/templateBody/gpv-main-tmpl.dot.html...OK
Warning: Unexpected token < Use --force to continue.

Aborted due to warnings.

Here is my grunt setup:

zetzer: {
            build: {
              options: {
                env: {},
                partials: 'src/templates/partials',
                templates: 'src/templates/base'
              },
              files: [
                {
                  expand: true,
                  cwd: 'src/templates/templateBody/',
                  src: '**/*.html',
                  dest: 'build/temp/templates',
                  ext: '.html',
                  flatten: true
                }
              ]
            }
        },

Any help would be appreciated. I'm at a loss as to what it could be.

Thanks for your time!

stencil is deprecated but there is no npm package for grunt zetzer?

pls release an npm package for grunt-zetzer so we can replace the deprecated stencil with it.

sorry found the alpha release on npm.