Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including grunt-zetzer with all npm packages installed. Try it out:

grunt-zetzer lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("grunt-zetzer/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

grunt-zetzer v2.0.0

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".

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free