Adds support for CoffeeMugg to HTML compilation to DocPad
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

CoffeeMugg Plugin for DocPad

Build Status NPM version Dependency Status Gittip donate button Analytics

Adds support for CoffeeMugg to HTML compilation to DocPad


Advantages over docpad-plugins-coffeekup:

  • can use nodejs libraries i.e. require
  • can create global custom tags via config or nodejs module
  • clean debug code


npm install --save docpad-plugin-coffeemugg

##Example usage

# templateData and docpad variables are accessed via @context

@div ->
	@p "I am a paragraph"
	@raw "<p> This is unescaped, raw HTML </p>"
	@text "<< This will be escaped ! >>"

Coffeemuggs methods are all in the @\this scope so to obtain the docpad object or templateData etc.. you can use


When using a plugin like docpad-plugin-partials and you want to pass the context you should only pass the template data

partial('my-partial', false, {@templateData} )



By default we compress the output for all environments except the development environment. Set the format option to either true or false to change this (true formats nicely, false compresses).

Available Options

			# The output HTML will be formatted all pretty. 
			# **Default: false**
			format:		false
			# The "text" values are automatically HTML escaped. 
			# **Default: true** (use '@raw' tag for unescaped text.)
			autoescape: true
			# Array of plugins
			# They are functions that take a context as argument 
			# or can be strings that will be passed to require()
			plugins:	[]	

Plugin Config Examples

Can be an array of functions or require() locations

	(context) ->
		context["showFruits"] = (fruits) ->
			@ul ->
				for fruit in fruits
					@li fruit

	"src/code/mytag" # would specify require("src/code/mytag")

Plugins in separate files and to be loaded via require should be exported in the usual nodejs fashion:

module.exports =
	(context) ->
		context["showFruits"] = (fruits) ->
			@ul ->
				for fruit in fruits
					@li fruit


You can discover the history inside the file


You can discover the contributing instructions inside the file


Licensed under the incredibly permissive MIT License
Copyright © 2013+ Stringz Solutions Ltd
Copyright © 2013+ Peter Flannery