Users commonly attempt to use docpad render for rendering files that require context (e.g. layouts or databases) - however, docpad render as is, is only aware of the file that is passed in and nothing else.
The suggestion is that we change the current docpad render to docpad compile, and create a new docpad render that parses the source files, but only renders the passed file.
Want to back this issue? Place a bounty on it! We accept bounties via Bountysource.
+1 I've been bitten by this misconception in the past a few times as well.
What will happen to events name like renderAfter, renderBefore etc...? Will they become compileAfter, compileBefore?
They will stay exactly the same. The only difference is that we will need to split generate into three sub actions: parse, render, write. So:
It's more or less straightforward to do, just need to find the time. For now, the highest priority is the DocPad website.
Will add this to the todo.
Not really any benefit of this.