1.0.0 • Published 6 years ago

@runner/generator-pug v1.0.0

Weekly downloads
1
License
GPL-3.0
Repository
github
Last release
6 years ago

Tasks generator for Pug

build status npm version dependencies status devDependencies status Gitter RunKit

Installation

npm install @runner/generator-pug

Usage

Add to the scope:

var generator = require('@runner/generator-pug');

Generate tasks according to the given config:

var tasks = generator({
    source: 'src/pug/main.pug',
    target: 'build/develop/index.html',
    variables: {
        develop: true,
        package: require('../package')
    }
});

Add generated tasks to the runner instance:

var runner = require('@runner/core');

Object.assign(runner.tasks, tasks);

The following tasks will become available:

Task nameDescription
pug:configprints the current configuration used for generated tasks
pug:buildperforms pug compilation
pug:clearremoves compiled file

Generator accepts two arguments: base configuration and additional options.

Base configuration

It's an object with the following properties:

NameDescription
sourcemain entry point passed as path to pug.compileFile
targetgenerated HTML file name
optionspug compiler options
variablesvars available in pug templates

Additional options

It's an object with the following properties:

NameDescription
prefixan affix placed before a task name (default is pug:)
suffixa string added at the end of a task name (empty by default)

So it's possible to change generated tasks names:

Object.assign(runner.tasks,
    generator(config, {
        prefix: 'html:',
        suffix: ':develop'
    })
);

It will add the following tasks:

  • html:config:develop
  • html:build:develop
  • html:clear:develop

Contribution

If you have any problems or suggestions please open an issue according to the contribution rules.

License

@runner/generator-pug is released under the GPL-3.0 License.