DocPad: Query custom category objects (via parse event)

README.md

DocPad: Query custom category objects (via parse event)

See http://stackoverflow.com/a/14381327/130638 for explanation.

docpad.coffee

# Prepare
_ = require('underscore')
categories = {}

# Configure DocPad
docpadConfig =
	templateData: ->

		getDocumentsForCategory: (categoryId) ->
			return @getCollection('documents').findAll(categories: $has: categoryId)
	 
		getCategoriesForDocument: (document) ->
			document ?= @getDocument()
			categoryIds = document.get('categories')
			categories = @categories[categoryId]  for categoryId in categoryIds
			return categories

		getCategories: ->
			return categories

	events:
		parseAfter: ->
			@getCollection('documents').forEach (document) ->
				documentCategories = document.getMeta().get('categories')
				for documentCategory in documentCategories
					# Update the global categories listing with our document's categories
					categories[documentCategory.id] ?= {}
					_.extend(categories[documentCategory.id], documentCategory)

					# Update our document's categories with a simple id listing
					document.set(categories: _.pluck(documentCategories, 'id'))

# Export
module.exports = docpadConfig

post.html.md

title: 'Happy new year!'
layout: 'post'
categories: [
		id: 'a'
		description: 'a is the first letter of the alphabet'
	,
		id: 'b'
		description: 'b is the second letter of the alphabet'
]

Happy new year. Boom boom.